qqmusic-api-python 0.1.4__tar.gz → 0.1.6__tar.gz

{qqmusic_api_python-0.1.4 → qqmusic_api_python-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: qqmusic-api-python
-Version: 0.1.4
+Version: 0.1.6
 Summary: QQ音乐API封装库
 Keywords: music,api,qqmusic,tencentmusic
 Home-page: https://github.com/luren-dc/QQMusicApi
@@ -22,9 +22,8 @@ Project-URL: Repository, https://github.com/luren-dc/QQMusicApi
 Project-URL: Documentation, https://github.com/luren-dc/QQMusicApi
 Requires-Python: <4.0,>=3.9
 Requires-Dist: cryptography<42.0.0,>=41.0.2
-Requires-Dist: requests<3.0.0,>=2.31.0
-Requires-Dist: aiohttp<4.0.0,>=3.9.5
 Requires-Dist: typing-extensions>=4.12.2
+Requires-Dist: httpx>=0.27.0
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -39,7 +38,7 @@ Description-Content-Type: text/markdown
     <a href="https://pdm-project.org">
         <img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fcdn.jsdelivr.net%2Fgh%2Fpdm-project%2F.github%2Fbadge.json" alt="pdm-managed">
     </a>
-    <a href="https://github.com/luren-dc/QQMusicApi/tree/build?tab=License-1-ov-file">
+    <a href="https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file">
         <img src="https://img.shields.io/github/license/luren-dc/PyQQMusicApi" alt="GitHub license">
     </a>
     <a href="https://github.com/luren-dc/QQMusicApi/stargazers">
@@ -71,9 +70,10 @@ Description-Content-Type: text/markdown
 
 ## 依赖
 
-- [AIOHTTP](https://docs.aiohttp.org/)
-- [Requests](https://requests.readthedocs.io/)
+- ~~[AIOHTTP](https://docs.aiohttp.org/)~~
+- ~~[Requests](https://requests.readthedocs.io/)~~
 - [Cryptography](https://cryptography.io/)
+- [HTTPX](https://github.com/encode/httpx/)
 
 ## 快速上手
 

{qqmusic_api_python-0.1.4 → qqmusic_api_python-0.1.6}/README.md

@@ -10,7 +10,7 @@
     <a href="https://pdm-project.org">
         <img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fcdn.jsdelivr.net%2Fgh%2Fpdm-project%2F.github%2Fbadge.json" alt="pdm-managed">
     </a>
-    <a href="https://github.com/luren-dc/QQMusicApi/tree/build?tab=License-1-ov-file">
+    <a href="https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file">
         <img src="https://img.shields.io/github/license/luren-dc/PyQQMusicApi" alt="GitHub license">
     </a>
     <a href="https://github.com/luren-dc/QQMusicApi/stargazers">
@@ -42,9 +42,10 @@
 
 ## 依赖
 
-- [AIOHTTP](https://docs.aiohttp.org/)
-- [Requests](https://requests.readthedocs.io/)
+- ~~[AIOHTTP](https://docs.aiohttp.org/)~~
+- ~~[Requests](https://requests.readthedocs.io/)~~
 - [Cryptography](https://cryptography.io/)
+- [HTTPX](https://github.com/encode/httpx/)
 
 ## 快速上手
 

{qqmusic_api_python-0.1.4 → qqmusic_api_python-0.1.6}/pyproject.toml

@@ -12,9 +12,8 @@ authors = [
 ]
 dependencies = [
     "cryptography<42.0.0,>=41.0.2",
-    "requests<3.0.0,>=2.31.0",
-    "aiohttp<4.0.0,>=3.9.5",
     "typing-extensions>=4.12.2",
+    "httpx>=0.27.0",
 ]
 requires-python = "<4.0,>=3.9"
 readme = "README.md"
@@ -40,7 +39,7 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dynamic = []
-version = "0.1.4"
+version = "0.1.6"
 
 [project.license]
 text = "MIT"
@@ -73,20 +72,11 @@ docs = [
 ]
 mypy = [
     "mypy>=1.11.0",
-    "types-requests>=2.32.0.20240712",
 ]
 linting = [
     "ruff>=0.5.4",
 ]
 
-[tool.pdm.build]
-source-includes = [
-    "qqmusic_api",
-    "README.md",
-    "LICENSE",
-    "tests",
-]
-
 [tool.pdm.scripts]
 docs = "mkdocs serve"
 
@@ -129,6 +119,13 @@ convention = "google"
 "tests/*" = [
     "D",
 ]
+"examples/*" = [
+    "D",
+    "T",
+]
+"qqmusic_api/login.py" = [
+    "D102",
+]
 "qqmusic_api/__init__.py" = [
     "F405",
     "F403",

{qqmusic_api_python-0.1.4 → qqmusic_api_python-0.1.6}/qqmusic_api/__init__.py

@@ -1,19 +1,21 @@
 from . import album, login, mv, search, singer, song, songlist, top
 from .utils.credential import Credential
-from .utils.network import get_aiohttp_session, set_aiohttp_session
+from .utils.network import get_session, set_session
+from .utils.sync import sync
 
-__version__ = "0.1.4"
+__version__ = "0.1.6"
 
 __all__ = [
     "album",
     "Credential",
-    "get_aiohttp_session",
+    "get_session",
     "login",
     "mv",
     "search",
-    "set_aiohttp_session",
+    "set_session",
     "singer",
     "song",
     "songlist",
+    "sync",
     "top",
 ]

qqmusic_api_python-0.1.6/qqmusic_api/album.py

@@ -0,0 +1,72 @@
+"""专辑相关 API"""
+
+from typing import Optional
+
+from .utils.network import Api
+from .utils.utils import get_api
+
+API = get_api("album")
+
+
+class Album:
+    """专辑类
+
+    Attributes:
+        mid: 专辑 mid
+        id:  专辑 id
+    """
+
+    def __init__(
+        self,
+        *,
+        mid: Optional[str] = None,
+        id: Optional[int] = None,
+    ):
+        """/// admonition | 注意
+        歌曲 mid 和 id，两者至少提供一个
+        ///
+
+        Args:
+            mid: 专辑 mid
+            id:  专辑 id
+        """
+        if mid is None and id is None:
+            raise ValueError("mid or id must be provided")
+        self.mid = mid
+        self.id = id
+        self._info: Optional[dict] = None
+
+    async def get_mid(self) -> str:
+        """获取专辑 mid
+
+        Returns:
+            专辑 mid
+        """
+        return (await self.get_detail())["basicInfo"]["albumMid"]
+
+    async def get_id(self) -> int:
+        """获取专辑 id
+
+        Returns:
+            专辑 id
+        """
+        return (await self.get_detail())["basicInfo"]["albumID"]
+
+    async def get_detail(self) -> dict:
+        """获取专辑详细信息
+
+        Returns:
+            专辑详细信息
+        """
+        if not self._info:
+            self._info = await Api(**API["detail"]).update_params(albumMid=self.mid, albumId=self.id).result
+        return self._info
+
+    async def get_song(self) -> list[dict]:
+        """获取专辑歌曲
+
+        Returns:
+            歌曲列表
+        """
+        result = await Api(**API["song"]).update_params(albumMid=self.mid, albumId=self.id, begin=0, num=0).result
+        return [song["songInfo"] for song in result["songList"]]

{qqmusic_api_python-0.1.4 → qqmusic_api_python-0.1.6}/qqmusic_api/data/api/album.json

@@ -3,7 +3,8 @@
         "module": "music.musichallAlbum.AlbumInfoServer",
         "method": "GetAlbumDetail",
         "params": {
-            "albumMid": "str 专辑 mid"
+            "albumMid": "str 专辑 mid",
+            "albumId": "str 专辑 id"
         },
         "comment": "获取专辑信息"
     },
@@ -12,6 +13,7 @@
         "method": "GetAlbumSongList",
         "params": {
             "albumMid": "str 专辑 mid",
+            "albumId": "str 专辑 id",
             "begin": "int 开启位置",
             "num": "int 返回数量"
         },

{qqmusic_api_python-0.1.4 → qqmusic_api_python-0.1.6}/qqmusic_api/data/api/login.json

@@ -3,7 +3,10 @@
         "module": "QQConnectLogin.LoginServer",
         "method": "QQLogin",
         "params": {
-            "code": "str 鉴权码"
+            "code": "str 鉴权码",
+            "musicid": "int",
+            "musickey": "str",
+            "refresh_key": "str"
         },
         "extra_common": {
             "tmeLoginType": "str 2"
@@ -15,7 +18,11 @@
         "method": "Login",
         "params": {
             "strAppid": "wx48db31d50e334801",
-            "code": "str 鉴权码"
+            "code": "str 鉴权码",
+            "str_musicid": "str",
+            "musickey": "str",
+            "refresh_key": "str",
+            "loginMode": "int 2"
         },
         "extra_common": {
             "tmeLoginType": "str 1"
@@ -47,23 +54,5 @@
             "tmeLoginMethod": "str 3"
         },
         "comment": "发送验证码"
-    },
-    "refresh": {
-        "module": "music.login.LoginServer",
-        "method": "Login",
-        "params": {
-            "openid": "str",
-            "access_token": "str",
-            "refresh_token": "str",
-            "expired_in": "int",
-            "musicid": "str 必须",
-            "musickey": "str",
-            "refresh_key": "str 必须",
-            "loginMode": "int 2"
-        },
-        "extra_common": {
-            "tmeLoginMethod": "str 可填2"
-        },
-        "comment": "刷新cookies"
     }
 }

{qqmusic_api_python-0.1.4 → qqmusic_api_python-0.1.6}/qqmusic_api/data/api/search.json

@@ -11,10 +11,10 @@
         "module": "tencent_music_soso_smartbox_cgi.SmartBoxCgi",
         "method": "GetSmartBoxResult",
         "params": {
+            "search_id": "int 随机生成",
             "query": "str 搜索词",
             "num_per_page": "int 每页返回数量",
-            "highlight": "int 是否高亮搜索词",
-            "page_idx": "int 页数"
+            "page_idx": "int 1"
         },
         "comment": "获取搜索词补全"
     },
@@ -30,12 +30,13 @@
         "module": "music.adaptor.SearchAdaptor",
         "method": "do_search_v2",
         "params": {
-            "search_id": "int 随机生成",
+            "searchid": "int 随机生成",
             "search_type": "int 100",
             "query": "str 搜索词",
-            "highlight": "int 是否高亮搜索词",
             "grp": "int 是否返回歌曲其他版本",
-            "page_id": "int 页数"
+            "highlight": "int 是否高亮搜索词",
+            "page_id": "int 页数",
+            "page_num": "int 15"
         },
         "comment": "综合搜索"
     },
@@ -46,10 +47,9 @@
             "search_id": "int 随机生成",
             "search_type": "int 搜索类型",
             "query": "str 搜索词",
-            "highlight": "int 是否高亮搜索词",
-            "page_id": "int 页数",
             "page_num": "int 页数",
             "num_per_page": "int 每页返回数量",
+            "highlight": "int 是否高亮搜索词",
             "selectors": "dict 选择器"
         },
         "comment": "桌面端搜索"
@@ -58,13 +58,12 @@
         "module": "music.search.SearchCgiService",
         "method": "DoSearchForQQMusicMobile",
         "params": {
-            "search_id": "int 随机生成",
+            "searchid": "int 随机生成",
             "search_type": "int 搜索类型",
             "query": "str 搜索词",
-            "highlight": "int 是否高亮搜索词",
-            "page_id": "int 页数",
             "page_num": "int 页数",
             "grp": "int 是否返回歌曲其他版本",
+            "highlight": "int 是否高亮搜索词",
             "num_per_page": "int 每页返回数量",
             "selectors": "dict 选择器"
         },

{qqmusic_api_python-0.1.4 → qqmusic_api_python-0.1.6}/qqmusic_api/data/api/song.json

@@ -50,7 +50,8 @@
         "method": "GetSongRelatedMv",
         "params": {
             "songid": "int 歌曲 ID",
-            "songmid": "str 歌曲 mid"
+            "songtype": "int 1",
+            "lastmvid": "用于刷新列表"
         },
         "comment": "获取相关MV"
     },