qqmusic-api-python 0.5.2__tar.gz → 0.5.3__tar.gz

{qqmusic_api_python-0.5.2 → qqmusic_api_python-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qqmusic-api-python
-Version: 0.5.2
+Version: 0.5.3
 Summary: QQ音乐API封装库
 Project-URL: documentation, https://l-1124.github.io/QQMusicApi/
 Project-URL: homepage, https://l-1124.github.io/QQMusicApi/

{qqmusic_api_python-0.5.2 → qqmusic_api_python-0.5.3}/docs/release-notes.md

@@ -1,5 +1,14 @@
 
-## What's Changed
+## [[0.5.2](https://github.com/L-1124/QQMusicApi/compare/v0.5.1..v0.5.2)] - 2026-04-18
+
+### Bug 修复
+
+* `UserFavSonglistResponse`jsonpath错误 ([2c54ebb](https://github.com/L-1124/QQMusicApi/commit/2c54ebb8d21a8ba02bb5b865a7ff0aa9aadcbc0d)) by [@L-1124](https://github.com/L-1124)
+* `GetAlbumSongResponse`上游返回单个歌曲信息报错 ([adbdc40](https://github.com/L-1124/QQMusicApi/commit/adbdc4069f964125ca2228d36014f64893f3e69a)) by [@L-1124](https://github.com/L-1124)
+
+### 功能更新
+
+* **(core)** 为 ResponsePager 添加 next 与 has_more ([0a63a26](https://github.com/L-1124/QQMusicApi/commit/0a63a264433bf37b5854064aa8ef95edba97adab)) by [@L-1124](https://github.com/L-1124)
 
 ### 文档更新
 
@@ -8,6 +17,7 @@
 ### 贡献者
 
 * @L-1124
+* @renovate[bot] [#240](https://github.com/L-1124/QQMusicApi/pull/240)
 * @github-actions[bot]
 
 ## [[0.5.1](https://github.com/L-1124/QQMusicApi/compare/v0.5.0..v0.5.1)] - 2026-04-13

qqmusic_api_python-0.5.3/qqmusic_api/__init__.py

@@ -0,0 +1,52 @@
+"""QQMusic API 公开入口."""
+
+from .core.client import Client
+from .core.exceptions import (
+    ApiError,
+    HTTPError,
+    LoginAccountBannedError,
+    LoginAccountRestrictedError,
+    LoginApiError,
+    LoginAuthCodeError,
+    LoginAuthFailedError,
+    LoginBindRequiredError,
+    LoginCredentialExpiredError,
+    LoginDeviceLimitError,
+    LoginError,
+    LoginExpiredError,
+    LoginRateLimitedError,
+    LoginSecurityRequiredError,
+    NetworkError,
+    NotLoginError,
+    RatelimitedError,
+    SignInvalidError,
+)
+from .core.versioning import Platform
+from .models.request import Credential
+
+__version__ = "0.5.3"
+
+__all__ = [
+    "ApiError",
+    "Client",
+    "Credential",
+    "HTTPError",
+    "LoginAccountBannedError",
+    "LoginAccountRestrictedError",
+    "LoginApiError",
+    "LoginAuthCodeError",
+    "LoginAuthFailedError",
+    "LoginBindRequiredError",
+    "LoginCredentialExpiredError",
+    "LoginDeviceLimitError",
+    "LoginError",
+    "LoginExpiredError",
+    "LoginRateLimitedError",
+    "LoginSecurityRequiredError",
+    "NetworkError",
+    "NotLoginError",
+    "Platform",
+    "RatelimitedError",
+    "SignInvalidError",
+    "__version__",
+]

{qqmusic_api_python-0.5.2 → qqmusic_api_python-0.5.3}/qqmusic_api/core/__init__.py

@@ -7,8 +7,18 @@ from .exceptions import (
     BaseError,
     CredentialError,
     HTTPError,
+    LoginAccountBannedError,
+    LoginAccountRestrictedError,
+    LoginApiError,
+    LoginAuthCodeError,
+    LoginAuthFailedError,
+    LoginBindRequiredError,
+    LoginCredentialExpiredError,
+    LoginDeviceLimitError,
     LoginError,
     LoginExpiredError,
+    LoginRateLimitedError,
+    LoginSecurityRequiredError,
     NetworkError,
     NotLoginError,
     RatelimitedError,
@@ -29,8 +39,18 @@ __all__ = [
     "ClientConfig",
     "CredentialError",
     "HTTPError",
+    "LoginAccountBannedError",
+    "LoginAccountRestrictedError",
+    "LoginApiError",
+    "LoginAuthCodeError",
+    "LoginAuthFailedError",
+    "LoginBindRequiredError",
+    "LoginCredentialExpiredError",
+    "LoginDeviceLimitError",
     "LoginError",
     "LoginExpiredError",
+    "LoginRateLimitedError",
+    "LoginSecurityRequiredError",
     "NetworkError",
     "NotLoginError",
     "Platform",

{qqmusic_api_python-0.5.2 → qqmusic_api_python-0.5.3}/qqmusic_api/core/exceptions.py

@@ -8,8 +8,18 @@ __all__ = [
     "BaseError",
     "CredentialError",
     "HTTPError",
+    "LoginAccountBannedError",
+    "LoginAccountRestrictedError",
+    "LoginApiError",
+    "LoginAuthCodeError",
+    "LoginAuthFailedError",
+    "LoginBindRequiredError",
+    "LoginCredentialExpiredError",
+    "LoginDeviceLimitError",
     "LoginError",
     "LoginExpiredError",
+    "LoginRateLimitedError",
+    "LoginSecurityRequiredError",
     "NetworkError",
     "NotLoginError",
     "RatelimitedError",
@@ -166,8 +176,74 @@ class LoginError(BaseError):
     通常在扫码登录流程中断、超时或网络失败时抛出。
     """
 
-    def __init__(self, message: str = "登录失败", cause: BaseException | None = None):
-        super().__init__(message, cause=cause)
+    def __init__(
+        self,
+        message: str = "登录失败",
+        cause: BaseException | None = None,
+        context: dict[str, Any] | None = None,
+    ):
+        super().__init__(message, context=context, cause=cause)
+
+
+class LoginApiError(LoginError):
+    """登录接口返回的业务错误基类."""
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        code: int,
+        data: dict[str, Any] | None = None,
+        action_url: str = "",
+        cause: BaseException | None = None,
+        context: dict[str, Any] | None = None,
+    ):
+        merged_context = dict(context or {})
+        merged_context["code"] = code
+        if data:
+            merged_context["data"] = data
+        if action_url:
+            merged_context["url"] = action_url
+        super().__init__(message, context=merged_context, cause=cause)
+        self.code = code
+        self.data = data or {}
+        self.action_url = action_url
+
+
+class LoginCredentialExpiredError(LoginApiError):
+    """登录刷新凭证不可用或登录态过期."""
+
+
+class LoginAuthFailedError(LoginApiError):
+    """登录认证失败或上游票据不可用."""
+
+
+class LoginSecurityRequiredError(LoginApiError):
+    """登录需要安全验证或人工交互."""
+
+
+class LoginAccountRestrictedError(LoginApiError):
+    """账号登录受限."""
+
+
+class LoginAccountBannedError(LoginApiError):
+    """账号被封禁导致无法登录."""
+
+
+class LoginBindRequiredError(LoginApiError):
+    """登录需要完成账号绑定或设备确认."""
+
+
+class LoginDeviceLimitError(LoginApiError):
+    """登录设备数量超限."""
+
+
+class LoginAuthCodeError(LoginApiError):
+    """手机验证码错误或已失效."""
+
+
+class LoginRateLimitedError(LoginApiError):
+    """登录操作触发频率限制."""
 
 
 class RequestGroupResultMissingError(ApiError):

{qqmusic_api_python-0.5.2 → qqmusic_api_python-0.5.3}/qqmusic_api/core/versioning.py

@@ -30,7 +30,7 @@ class VersionProfile:
     qimei_sdk_version: str | None = None
 
 
-@dataclass(frozen=True, slots=True)
+@dataclass(slots=True)
 class VersionPolicy:
     """请求版本策略."""
 

{qqmusic_api_python-0.5.2 → qqmusic_api_python-0.5.3}/qqmusic_api/models/base.py

@@ -19,7 +19,7 @@ _PHOTO_NEW_SIZE_SEGMENTS: Final[dict[int, str]] = {
 
 
 def _normalize_cover_size(size: CoverSize) -> str:
-    """返回 APK `photo_new` 模板使用的尺寸片段."""
+    """返回 `photo_new` 模板使用的尺寸片段."""
     try:
         return _PHOTO_NEW_SIZE_SEGMENTS[size]
     except KeyError as exc:
@@ -27,7 +27,7 @@ def _normalize_cover_size(size: CoverSize) -> str:
 
 
 def _build_photo_new_cover_url(kind: str, mid: str, size: CoverSize) -> str:
-    """按 APK `photo_new` 规则拼接封面链接."""
+    """按 `photo_new` 规则拼接封面链接."""
     normalized_mid = mid.strip()
     if not normalized_mid:
         return ""
@@ -200,7 +200,7 @@ class SongList(Response):
     picurl: str = Field(default="", validation_alias=AliasChoices("picurl", "cover", "logo", "picUrl"))
     desc: str = Field(default="", validation_alias=AliasChoices("desc", "description"))
     songnum: int = Field(default=0, validation_alias=AliasChoices("songnum", "songNum", "song_cnt"))
-    listennum: int | str = Field(default=0, validation_alias=AliasChoices("listennum", "playCnt", "play_cnt"))
+    listennum: int = Field(default=0, validation_alias=AliasChoices("listennum", "playCnt", "play_cnt"))
 
 
 class Song(Response):

{qqmusic_api_python-0.5.2 → qqmusic_api_python-0.5.3}/qqmusic_api/models/request.py

@@ -53,6 +53,10 @@ class CommonParams(BaseModel):
     format: str | None = Field(default=None)
     in_charset: str | None = Field(default=None, alias="inCharset")
     out_charset: str | None = Field(default=None, alias="outCharset")
+    # [Web] 通知开关
+    notice: int | None = Field(default=None)
+    # [Web] 新设备码开关
+    need_new_code: int | None = Field(default=None)
 
 
 class Credential(BaseModel):
@@ -95,7 +99,7 @@ class Credential(BaseModel):
         if not isinstance(data, dict):
             return data
 
-        if data.get("loginType") or data.get("login_type"):
+        if "loginType" in data or "login_type" in data:
             return data
 
         musickey = data.get("musickey", "")