跳转至

User类

User类

User

用户信息接口客户端 用于获取用户空间与 VIP 信息

Source code in src/cpan115/User.py 
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
class User:
    """
    用户信息接口客户端
    用于获取用户空间与 VIP 信息
    """

    def __init__(self, auth: Auth):
        """初始化

        Args:
            auth: 已授权的 Auth 实例
        """
        self.auth = auth
        self._user_resp_cache = None
        self.userinfo: UserInfoModel = self._fetch_user_info()

    def get_user_info(self) -> dict:
        """获取用户信息, 通过调用 GET /open/user/info 接口

        Returns:
            包含用户信息
        """
        if self._user_resp_cache is not None:
            return self._user_resp_cache

        resp = self.auth.request_json("GET", API.UserPath.USER_INFO)

        self._user_resp_cache = resp
        return resp

    def _fetch_user_info(self) -> UserInfoModel:
        """获取并缓存用户信息

        Returns:
            UserInfoModel: 用户信息模型

        Example Response:
             {'state': True, 'message': '', 'code': 0, 'data': {'user_id': 11111, 'user_name': '66m', .... 'vip_info': {'expire': 253402271999, 'level_name': '特级VIP', 'tp_rights': {'is_tp_rights': 0, 'tp_rights_time': 0}}}}
        """
        try:
            resp = self.get_user_info()
        except Exception as e:
            raise ValueError("无法获取用户信息") from e

        try:
            data = resp.get("data", {})
            if not data:
                raise ValueError("响应数据为空")

            user_id = data.get("user_id") or data.get("userid")
            user_name = data.get("user_name") or data.get("username")
            if not user_id or not user_name:
                raise ValueError("缺少必要的用户信息字段")
            vip_info = data.get("vip_info", {})
            level_name = vip_info.get("level_name", "原石用户")
            viptype = NAME2MARK.get(level_name, 1)  # 不是原石用户即视为VIP

            user_info = UserInfoModel(
                username=user_name,
                userid=str(user_id),
                isvip=viptype != 0,
                viptype=viptype,
            )
            return user_info

        except KeyError as e:
            raise ValueError(f"响应数据格式错误，缺少字段: {e}") from e
        except Exception as e:
            print(f"获取用户信息失败: {e}")
            print(f"原始响应: {resp}")
            raise ValueError(f"解析用户信息失败: {e}") from e

__init__ 

__init__(auth: Auth)

初始化

Parameters:

Name Type Description Default
auth Auth

已授权的 Auth 实例

 required
Source code in src/cpan115/User.py 
24
25
26
27
28
29
30
31
32
def __init__(self, auth: Auth):
    """初始化

    Args:
        auth: 已授权的 Auth 实例
    """
    self.auth = auth
    self._user_resp_cache = None
    self.userinfo: UserInfoModel = self._fetch_user_info()

get_user_info 

get_user_info() -> dict

获取用户信息, 通过调用 GET /open/user/info 接口

Returns:

Type Description
dict

包含用户信息
Source code in src/cpan115/User.py 
34
35
36
37
38
39
40
41
42
43
44
45
46
def get_user_info(self) -> dict:
    """获取用户信息, 通过调用 GET /open/user/info 接口

    Returns:
        包含用户信息
    """
    if self._user_resp_cache is not None:
        return self._user_resp_cache

    resp = self.auth.request_json("GET", API.UserPath.USER_INFO)

    self._user_resp_cache = resp
    return resp