qqmusic-api-python 0.3.5__tar.gz → 0.3.6__tar.gz

{qqmusic_api_python-0.3.5 → qqmusic_api_python-0.3.6}/.gitignore

@@ -30,6 +30,7 @@ share/python-wheels/
 .installed.cfg
 *.egg
 MANIFEST
+tools
 
 # PyInstaller
 #  Usually these files are written by a python script from a template
@@ -164,7 +165,7 @@ cython_debug/
 #  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
+.idea/
 
 ### Python Patch ###
 # Poetry local configuration file - https://python-poetry.org/docs/configuration/#local-configuration

{qqmusic_api_python-0.3.5 → qqmusic_api_python-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qqmusic-api-python
-Version: 0.3.5
+Version: 0.3.6
 Summary: QQ音乐API封装库
 Project-URL: homepage, https://luren-dc.github.io/QQMusicApi/
 Project-URL: repository, https://github.com/luren-dc/QQMusicApi
@@ -17,12 +17,12 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: Chinese (Simplified)
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Requires-Dist: aiocache>=0.12.3
-Requires-Dist: cryptography<44.0.2,>=44.0.1
+Requires-Dist: cryptography<45.0.6,>=45.0.5
 Requires-Dist: httpx[http2]>=0.27.0
 Requires-Dist: orjson>=3.10.15
 Requires-Dist: typing-extensions>=4.12.2
@@ -100,7 +100,7 @@ asyncio.run(main())
 
 ## [Web API](./web/README.md)
 
-## Licence
+## License
 
 本项目基于 **[MIT License](https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file)** 许可证发行。
 

{qqmusic_api_python-0.3.5 → qqmusic_api_python-0.3.6}/README.md

@@ -70,7 +70,7 @@ asyncio.run(main())
 
 ## [Web API](./web/README.md)
 
-## Licence
+## License
 
 本项目基于 **[MIT License](https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file)** 许可证发行。
 

{qqmusic_api_python-0.3.5 → qqmusic_api_python-0.3.6}/pyproject.toml

@@ -5,7 +5,7 @@ authors = [
   { name = "Luren", email = "68656403+luren-dc@users.noreply.github.com" },
 ]
 dependencies = [
-  "cryptography>=44.0.1,<44.0.2",
+  "cryptography>=45.0.5,<45.0.6",
   "typing-extensions>=4.12.2",
   "httpx[http2]>=0.27.0",
   "aiocache>=0.12.3",
@@ -26,7 +26,7 @@ classifiers = [
   "Framework :: aiohttp",
   "Programming Language :: Python",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: Implementation :: CPython",
   "Topic :: Software Development :: Libraries :: Python Modules",
 ]
@@ -55,7 +55,7 @@ path = "qqmusic_api/__init__.py"
 packages = ["qqmusic_api"]
 
 [tool.hatch.build.targets.sdist]
-include = ["/qqmusic_api", "/tests", "LISENCE", "README.md"]
+include = ["/qqmusic_api", "/tests", "LICENSE", "README.md"]
 
 [dependency-groups]
 testing = [
@@ -81,7 +81,7 @@ web = [
 [tool.commitizen]
 name = "cz_gitmoji"
 
-[tool.basedpyright]
+[tool.pyright]
 venvPath = "."
 venv = ".venv"
 include = ["qqmusic_api"]
@@ -104,10 +104,9 @@ extend-select = [
   "ASYNC",
   "C4",
   "FURB",
-  "R",
   "PERF",
 ]
-ignore = ["D105", "D107", "D205", "D415"]
+ignore = ["D105", "D107", "D205", "D415", "RUF029"]
 pydocstyle = { convention = "google" }
 
 [tool.ruff.lint.per-file-ignores]

{qqmusic_api_python-0.3.5 → qqmusic_api_python-0.3.6}/qqmusic_api/__init__.py

@@ -4,7 +4,7 @@ from . import album, comment, login, lyric, mv, search, singer, song, songlist,
 from .utils.credential import Credential
 from .utils.session import Session, get_session, set_session
 
-__version__ = "0.3.5"
+__version__ = "0.3.6"
 
 logger = logging.getLogger("qqmusicapi")
 

qqmusic_api_python-0.3.6/qqmusic_api/comment.py

@@ -0,0 +1,183 @@
+"""评论 API"""
+
+from typing import Any, cast
+
+from .utils.network import api_request
+
+
+@api_request("music.globalComment.CommentCountSrv", "GetCmCount")
+async def get_comment_count(biz_id: str):
+    """获取歌曲评论数量
+
+    Args:
+        biz_id: 歌曲 ID
+    """
+    return {
+        "request": {
+            "biz_id": biz_id,
+            "biz_type": 1,
+            "biz_sub_type": 2,
+        },
+    }, lambda data: cast(dict[str, Any], data.get("response", {}))
+
+
+def _processor(data: dict[str, Any]):
+    """处理并返回结构化评论数据:
+
+    返回结构:
+    [
+        {
+            "Avatar": str,          # 用户头像 URL
+            "CmId": str,            # 评论 ID (后续需要获取全部子评论时需用到)
+            "PraiseNum": int,       # 点赞数
+            "Nick": str,            # 昵称
+            "Pic": str,             # 评论配图 (可能为空)
+            "Content": str,         # 评论内容
+            "SeqNo": str,           # 评论序号 ID 可以用于传递给 参数: last_comment_seq_no
+            "SubComments": [        # 子评论列表
+                {
+                    "Avatar": str,
+                    "Nick": str,
+                    "Content": str,
+                    "Pic": str,
+                    "PraiseNum": int,
+                    "SeqNo": str
+                }
+            ]
+        },
+        ...
+    ]
+    """
+    comments = data.get("CommentList", {}).get("Comments", [])
+    result = []
+
+    for comment in comments:
+        item = {
+            "Avatar": comment.get("Avatar"),
+            "CmId": comment.get("CmId"),
+            "PraiseNum": comment.get("PraiseNum"),
+            "Nick": comment.get("Nick"),
+            "Pic": comment.get("Pic"),
+            "Content": comment.get("Content"),
+            "SeqNo": comment.get("SeqNo"),
+            "SubComments": [],
+        }
+
+        for sub in comment.get("SubComments", []):
+            sub_item = {
+                "Avatar": sub.get("Avatar"),
+                "Nick": sub.get("Nick"),
+                "Content": sub.get("Content"),
+                "Pic": sub.get("Pic"),
+                "PraiseNum": sub.get("PraiseNum"),
+                "SeqNo": sub.get("SeqNo"),
+            }
+            item["SubComments"].append(sub_item)
+
+        result.append(item)
+
+    return result
+
+
+@api_request("music.globalComment.CommentRead", "GetHotCommentList")
+async def get_hot_comments(
+    biz_id: str,
+    page_num: int = 1,
+    page_size: int = 15,
+    last_comment_seq_no: str = "",
+):
+    """获取歌曲热评
+
+    Args:
+        biz_id: 歌曲 ID
+        page_num: 页码
+        page_size: 每页数量
+        last_comment_seq_no: 上一页最后一条评论 ID(可选)
+    """
+    params = {
+        "BizType": 1,
+        "BizId": biz_id,
+        "LastCommentSeqNo": last_comment_seq_no,
+        "PageSize": page_size,
+        "PageNum": page_num - 1,
+        "HotType": 1,
+        "WithAirborne": 0,
+        "PicEnable": 1,
+    }
+
+    return params, _processor
+
+
+@api_request("music.globalComment.CommentRead", "GetNewCommentList")
+async def get_new_comments(
+    biz_id: str,
+    page_num: int = 1,
+    page_size: int = 15,
+    last_comment_seq_no: str = "",
+):
+    """获取歌曲最新评论
+
+    Args:
+        biz_id: 歌曲 ID
+        page_num: 页码
+        page_size: 每页数量
+        last_comment_seq_no: 上一页最后一条评论 ID(可选)
+    """
+    params = {
+        # "LastRspVer": "",
+        # "LastTotalVer": "1755832873618224522",
+        "PageSize": page_size,
+        "PageNum": page_num - 1,
+        "HashTagID": "",
+        "BizType": 1,
+        # "LastCommentId": "",
+        "PicEnable": 1,
+        "LastCommentSeqNo": last_comment_seq_no,
+        "SelfSeeEnable": 1,
+        # "LastTotal": 325,
+        # "CmListUIVer": 1,
+        "BizId": biz_id,
+        "AudioEnable": 1,
+    }
+
+    return params, _processor
+
+
+@api_request("music.globalComment.CommentRead", "GetRecCommentList")
+async def get_recommend_comments(
+    biz_id: str,
+    page_num: int = 1,
+    page_size: int = 15,
+    last_comment_seq_no: str = "",
+):
+    """获取歌曲推荐评论
+
+    Args:
+        biz_id: 歌曲 ID
+        page_num: 页码
+        page_size: 每页数量
+        last_comment_seq_no: 上一页最后一条评论 ID(可选)
+    """
+    params = {
+        # "FromParentCmId": "",
+        # "LastRspVer": "1755834843787200911",
+        # "LastTotalVer": "1755834843679664122",
+        # "RecOffset": 0,
+        # "LastHotScore": "",
+        # "FromCommentId": "",
+        # "HashTagID": "",
+        # "CommentIds": [],
+        # "LastRecScore": "",
+        # "LastTotal": 325,
+        "PageSize": page_size,
+        "PageNum": page_num - 1,
+        "BizType": 1,
+        "PicEnable": 1,
+        "Flag": 1,
+        "LastCommentSeqNo": last_comment_seq_no,
+        "CmListUIVer": 1,
+        "BizId": biz_id,
+        "AudioEnable": 1,
+    }
+
+    return params, _processor

qqmusic_api_python-0.3.6/qqmusic_api/recommend.py

@@ -0,0 +1,52 @@
+"""推荐相关 API"""
+
+from .utils.network import NO_PROCESSOR, api_request
+
+
+@api_request("music.recommend.RecommendFeed", "get_recommend_feed")
+async def get_home_feed():
+    """获取主页推荐"""
+    return {
+        "direction": 0,
+        "page": 1,
+        "s_num": 0,
+    }, NO_PROCESSOR
+
+
+@api_request("music.radioProxy.MbTrackRadioSvr", "get_radio_track")
+async def get_guess_recommend():
+    """获取猜你喜欢"""
+    return {
+        "id": 99,
+        "num": 5,
+        "from": 0,
+        "scene": 0,
+        "song_ids": [],
+        "ext": {"bluetooth": ""},
+        "should_count_down": 1,
+    }, NO_PROCESSOR
+
+
+@api_request("music.recommend.TrackRelationServer", "GetRadarSong")
+async def get_radar_recommend():
+    """获取雷达推荐"""
+    return {
+        "Page": 1,
+        # "LastToastTime": 1755782480,
+        "ReqType": 0,
+        "FavSongs": [],
+        "EntranceSongs": [],
+        # "ext": {"bluetooth": ""},
+    }, NO_PROCESSOR
+
+
+@api_request("music.playlist.PlaylistSquare", "GetRecommendFeed")
+async def get_recommend_songlist():
+    """获取推荐歌单"""
+    return {"From": 0, "Size": 25}, NO_PROCESSOR
+
+
+@api_request("newsong.NewSongServer", "get_new_song_info")
+async def get_recommend_newsong():
+    """获取推荐新歌"""
+    return {"type": 5}, NO_PROCESSOR

{qqmusic_api_python-0.3.5 → qqmusic_api_python-0.3.6}/qqmusic_api/song.py

@@ -182,6 +182,7 @@ async def get_song_urls(
             params=params,
             credential=credential,
             exclude_params=["guid"],
+            cacheable=False,
         )
         req.processor = _processor
         rg.add_request(req)

qqmusic_api_python-0.3.6/qqmusic_api/utils/sign.py

@@ -0,0 +1,36 @@
+"""QQ音乐 sign"""
+
+import re
+from base64 import b64encode
+from hashlib import sha1
+
+import orjson as json
+
+PART_1_INDEXES = [23, 14, 6, 36, 16, 40, 7, 19]
+PART_2_INDEXES = [16, 1, 32, 12, 19, 27, 8, 5]
+SCRAMBLE_VALUES = [89, 39, 179, 150, 218, 82, 58, 252, 177, 52, 186, 123, 120, 64, 242, 133, 143, 161, 121, 179]
+
+# JavaScript quirks emulation
+PART_1_INDEXES = filter(lambda x: x < 40, PART_1_INDEXES)
+
+
+def sign(request: dict) -> str:
+    """QQ音乐 请求签名
+
+    Args:
+        request: 请求数据
+
+    Returns:
+        签名结果
+    """
+    hash = sha1(json.dumps(request)).hexdigest().upper()
+
+    part1 = "".join(hash[i] for i in PART_1_INDEXES)
+    part2 = "".join(hash[i] for i in PART_2_INDEXES)
+
+    part3 = bytearray(20)
+    for i, v in enumerate(SCRAMBLE_VALUES):
+        value = v ^ int(hash[i * 2 : i * 2 + 2], 16)
+        part3[i] = value
+    b64_part = re.sub(rb"[\\/+=]", b"", b64encode(part3)).decode("utf-8")
+    return f"zzc{part1}{b64_part}{part2}".lower()

qqmusic_api_python-0.3.5/tests/test_comments.py → qqmusic_api_python-0.3.6/tests/test_comment.py

@@ -1,6 +1,6 @@
 import pytest
 
-from qqmusic_api.comment import get_hot_comments
+from qqmusic_api.comment import get_comment_count, get_hot_comments
 
 pytestmark = pytest.mark.asyncio(loop_scope="session")
 
@@ -13,3 +13,7 @@ async def test_get_comment():
     )
 
     assert comment[0]["Content"]
+
+
+async def test_get_comment_count():
+    assert await get_comment_count("103540151")

qqmusic_api_python-0.3.6/tests/test_recommend.py

@@ -0,0 +1,25 @@
+import pytest
+
+from qqmusic_api import recommend
+
+pytestmark = pytest.mark.asyncio(loop_scope="session")
+
+
+async def test_get_home_feed():
+    assert await recommend.get_home_feed()
+
+
+async def test_get_guess_recommend():
+    assert await recommend.get_guess_recommend()
+
+
+async def test_get_radar_recommend():
+    assert await recommend.get_radar_recommend()
+
+
+async def test_get_recommend_songlist():
+    assert await recommend.get_recommend_songlist()
+
+
+async def test_get_recommend_newsong():
+    assert await recommend.get_recommend_newsong()

qqmusic_api_python-0.3.5/qqmusic_api/comment.py

@@ -1,91 +0,0 @@
-"""评论 API"""
-
-from typing import Any
-
-from qqmusic_api.utils.network import api_request
-
-
-@api_request("music.globalComment.CommentRead", "GetHotCommentList")
-async def get_hot_comments(
-    biz_id: str,
-    page_num: int = 1,
-    page_size: int = 15,
-    last_comment_seq_no: str = "",
-):
-    """获取歌曲热评
-
-    Args:
-        biz_id: 歌曲 ID
-        page_num: 页码
-        page_size: 每页数量
-        last_comment_seq_no: 上一页最后一条评论 ID(可选)
-    """
-    params = {
-        "BizType": 1,
-        "BizId": biz_id,
-        "LastCommentSeqNo": last_comment_seq_no,
-        "PageSize": page_size,
-        "PageNum": page_num,
-        "HotType": 1,
-        "WithAirborne": 0,
-        "PicEnable": 1,
-    }
-
-    def _processor(data: dict[str, Any]):
-        """处理并返回结构化评论数据:
-
-        返回结构:
-        [
-            {
-                "Avatar": str,          # 用户头像 URL
-                "CmId": str,            # 评论 ID (后续需要获取全部子评论时需用到)
-                "PraiseNum": int,       # 点赞数
-                "Nick": str,            # 昵称
-                "Pic": str,             # 评论配图 (可能为空)
-                "Content": str,         # 评论内容
-                "SeqNo": str,           # 评论序号 ID 可以用于传递给 参数: last_comment_seq_no
-                "SubComments": [        # 子评论列表
-                    {
-                        "Avatar": str,
-                        "Nick": str,
-                        "Content": str,
-                        "Pic": str,
-                        "PraiseNum": int,
-                        "SeqNo": str
-                    }
-                ]
-            },
-            ...
-        ]
-        """
-        comments = data.get("CommentList", {}).get("Comments", [])
-        result = []
-
-        for comment in comments:
-            item = {
-                "Avatar": comment.get("Avatar"),
-                "CmId": comment.get("CmId"),
-                "PraiseNum": comment.get("PraiseNum"),
-                "Nick": comment.get("Nick"),
-                "Pic": comment.get("Pic"),
-                "Content": comment.get("Content"),
-                "SeqNo": comment.get("SeqNo"),
-                "SubComments": [],
-            }
-
-            for sub in comment.get("SubComments", []):
-                sub_item = {
-                    "Avatar": sub.get("Avatar"),
-                    "Nick": sub.get("Nick"),
-                    "Content": sub.get("Content"),
-                    "Pic": sub.get("Pic"),
-                    "PraiseNum": sub.get("PraiseNum"),
-                    "SeqNo": sub.get("SeqNo"),
-                }
-                item["SubComments"].append(sub_item)
-
-            result.append(item)
-
-        return result
-
-    return params, _processor

qqmusic_api_python-0.3.5/qqmusic_api/utils/sign.py

@@ -1,68 +0,0 @@
-"""QQ音乐 sign"""
-
-import base64
-
-import orjson as json
-
-from .common import calc_md5
-
-
-def _head(b: bytes) -> list:
-    p = [21, 4, 9, 26, 16, 20, 27, 30]
-    return [b[x] for x in p]
-
-
-def _tail(b: bytes) -> list:
-    p = [18, 11, 3, 2, 1, 7, 6, 25]
-    return [b[x] for x in p]
-
-
-def _middle(b: bytes) -> list:
-    zd = {
-        "0": 0,
-        "1": 1,
-        "2": 2,
-        "3": 3,
-        "4": 4,
-        "5": 5,
-        "6": 6,
-        "7": 7,
-        "8": 8,
-        "9": 9,
-        "A": 10,
-        "B": 11,
-        "C": 12,
-        "D": 13,
-        "E": 14,
-        "F": 15,
-    }
-    ol = [212, 45, 80, 68, 195, 163, 163, 203, 157, 220, 254, 91, 204, 79, 104, 6]
-    res = []
-    j = 0
-    for i in range(0, len(b), 2):
-        one = zd[chr(b[i])]
-        two = zd[chr(b[i + 1])]
-        r = one * 16 ^ two
-        res.append(r ^ ol[j])
-        j += 1
-    return res
-
-
-def sign(request: dict) -> str:
-    """QQ音乐 请求签名
-
-    Args:
-        request: 请求数据
-
-    Returns:
-        签名结果
-    """
-    md5_str = calc_md5(json.dumps(request)).upper().encode("utf-8")
-
-    h = _head(md5_str)
-    e = _tail(md5_str)
-    ls = _middle(md5_str)
-    m = base64.b64encode(bytes(ls)).decode("utf-8")
-
-    res = "zzb" + "".join(map(chr, h)) + m + "".join(map(chr, e))
-    return res.lower().replace("/", "").replace("+", "").replace("=", "")