qqmusic-api-python 0.1.11__tar.gz → 0.2.1__tar.gz

qqmusic_api_python-0.2.1/.gitignore

@@ -0,0 +1,178 @@
+# Created by https://www.toptal.com/developers/gitignore/api/python
+# Edit at https://www.toptal.com/developers/gitignore?templates=python
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+device.json
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+.pdm-python
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  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/
+
+### Python Patch ###
+# Poetry local configuration file - https://python-poetry.org/docs/configuration/#local-configuration
+poetry.toml
+
+# ruff
+.ruff_cache/
+
+# LSP config files
+pyrightconfig.json
+
+# End of https://www.toptal.com/developers/gitignore/api/python

{qqmusic_api_python-0.1.11 → qqmusic_api_python-0.2.1}/PKG-INFO

@@ -1,28 +1,29 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: qqmusic-api-python
-Version: 0.1.11
+Version: 0.2.1
 Summary: QQ音乐API封装库
-Keywords: music,api,qqmusic,tencentmusic
-Author-Email: Luren <68656403+luren-dc@users.noreply.github.com>
-Maintainer-Email: Luren <68656403+luren-dc@users.noreply.github.com>
+Project-URL: homepage, https://luren-dc.github.io/QQMusicApi/
+Project-URL: repository, https://github.com/luren-dc/QQMusicApi
+Project-URL: documentation, https://luren-dc.github.io/QQMusicApi/
+Author-email: Luren <68656403+luren-dc@users.noreply.github.com>
+Maintainer-email: Luren <68656403+luren-dc@users.noreply.github.com>
 License: MIT
+License-File: LICENSE
+Keywords: api,music,qqmusic,tencentmusic
 Classifier: Development Status :: 4 - Beta
-Classifier: Natural Language :: Chinese (Simplified)
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Framework :: Pytest
 Classifier: Framework :: aiohttp
+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 :: Implementation :: CPython
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Project-URL: homepage, https://github.com/luren-dc/QQMusicApi
-Project-URL: repository, https://github.com/luren-dc/QQMusicApi
-Project-URL: documentation, https://github.com/luren-dc/QQMusicApi
-Requires-Python: <3.13,>=3.9
-Requires-Dist: cryptography<42.0.0,>=41.0.2
-Requires-Dist: typing-extensions>=4.12.2
+Requires-Python: >=3.10
+Requires-Dist: cryptography<44.0.1,>=44.0.0
 Requires-Dist: httpx>=0.27.0
+Requires-Dist: typing-extensions>=4.12.2
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -30,7 +31,7 @@ Description-Content-Type: text/markdown
         <img src="https://socialify.git.ci/luren-dc/QQMusicApi/image?description=1&font=Source%20Code%20Pro&language=1&logo=https%3A%2F%2Fy.qq.com%2Fmediastyle%2Fmod%2Fmobile%2Fimg%2Flogo.svg&name=1&pattern=Overlapping%20Hexagons&theme=Auto">
     </a>
     <a href="https://www.python.org">
-        <img src="https://img.shields.io/badge/Python-3.9|3.10|3.11|3.12-blue" alt="Python">
+        <img src="https://img.shields.io/badge/Python-3.10|3.11|3.12-blue" alt="Python">
     </a>
     <a href="https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file">
         <img src="https://img.shields.io/github/license/luren-dc/QQMusicApi" alt="GitHub license">
@@ -62,7 +63,7 @@ Description-Content-Type: text/markdown
 
 - 涵盖常见 API
 - 调用简便，函数命名易懂，代码注释详细
-- 异步操作
+- 完全异步操作
 
 ## 依赖
 

{qqmusic_api_python-0.1.11 → qqmusic_api_python-0.2.1}/README.md

@@ -3,7 +3,7 @@
         <img src="https://socialify.git.ci/luren-dc/QQMusicApi/image?description=1&font=Source%20Code%20Pro&language=1&logo=https%3A%2F%2Fy.qq.com%2Fmediastyle%2Fmod%2Fmobile%2Fimg%2Flogo.svg&name=1&pattern=Overlapping%20Hexagons&theme=Auto">
     </a>
     <a href="https://www.python.org">
-        <img src="https://img.shields.io/badge/Python-3.9|3.10|3.11|3.12-blue" alt="Python">
+        <img src="https://img.shields.io/badge/Python-3.10|3.11|3.12-blue" alt="Python">
     </a>
     <a href="https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file">
         <img src="https://img.shields.io/github/license/luren-dc/QQMusicApi" alt="GitHub license">
@@ -35,7 +35,7 @@
 
 - 涵盖常见 API
 - 调用简便，函数命名易懂，代码注释详细
-- 异步操作
+- 完全异步操作
 
 ## 依赖
 

qqmusic_api_python-0.2.1/pyproject.toml

@@ -0,0 +1,112 @@
+[project]
+name = "qqmusic-api-python"
+description = "QQ音乐API封装库"
+authors = [
+  { name = "Luren", email = "68656403+luren-dc@users.noreply.github.com" },
+]
+dependencies = [
+  "cryptography>=44.0.0,<44.0.1",
+  "typing-extensions>=4.12.2",
+  "httpx>=0.27.0",
+]
+requires-python = ">=3.10"
+readme = "README.md"
+license = { text = "MIT" }
+maintainers = [
+  { name = "Luren", email = "68656403+luren-dc@users.noreply.github.com" },
+]
+keywords = ["music", "api", "qqmusic", "tencentmusic"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Natural Language :: Chinese (Simplified)",
+  "License :: OSI Approved :: MIT License",
+  "Framework :: Pytest",
+  "Framework :: aiohttp",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dynamic = ["version"]
+
+[project.urls]
+homepage = "https://luren-dc.github.io/QQMusicApi/"
+repository = "https://github.com/luren-dc/QQMusicApi"
+documentation = "https://luren-dc.github.io/QQMusicApi/"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.uv]
+package = true
+
+[tool.hatch.version]
+path = "qqmusic_api/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["qqmusic_api"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/qqmusic_api", "/tests", "LISENCE", "README.md"]
+
+[dependency-groups]
+testing = [
+  "pytest<9.0.0,>=8.2.0",
+  "pytest-asyncio<1.0.0,>=0.23.6",
+  "pytest-sugar<2.0.0,>=1.0.0",
+]
+docs = [
+  "mkdocs-material>=9.5.29",
+  "mkdocstrings-python>=1.10.5",
+  "mkdocstrings>=0.25.1",
+  "mkdocs>=1.6.0",
+  "markdown-callouts>=0.4.0",
+  "griffe-inherited-docstrings>=1.0.0",
+  "docstring-inheritance>=2.2.1",
+  "griffe-modernized-annotations>=1.0.8",
+]
+
+[tool.commitizen]
+name = "cz_gitmoji"
+
+[tool.basedpyright]
+venvPath = "."
+venv = ".venv"
+include = ["qqmusic_api"]
+exclude = ["tests", "examples"]
+pythonVersion = "3.10"
+typeCheckingMode = "standard"
+
+[tool.ruff]
+line-length = 120
+extend-exclude = ["docs"]
+
+[tool.ruff.lint]
+extend-select = [
+  "Q",
+  "RUF",
+  "C90",
+  "UP",
+  "I",
+  "D",
+  "ASYNC",
+  "C4",
+  "FURB",
+  "R",
+  "PERF",
+]
+ignore = ["D105", "D107", "D205", "D415"]
+pydocstyle = { convention = "google" }
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["D"]
+"examples/*" = ["D", "T"]
+"qqmusic_api/__init__.py" = ["F405", "D"]
+"qqmusic_api/**/__init__.py" = ["F405", "D"]
+
+[tool.pytest.ini_options]
+addopts = "-rxXs"
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"

{qqmusic_api_python-0.1.11 → qqmusic_api_python-0.2.1}/qqmusic_api/__init__.py

@@ -2,17 +2,18 @@ import logging
 
 from . import album, login, login_utils, lyric, mv, search, singer, song, songlist, top, user
 from .utils.credential import Credential
-from .utils.network import get_session, set_session
+from .utils.session import create_session, get_session, set_session, set_session_credential
 from .utils.sync import sync
 
-__version__ = "0.1.11"
+__version__ = "0.2.1"
 
 logger = logging.getLogger("qqmusicapi")
 
 
 __all__ = [
-    "album",
     "Credential",
+    "album",
+    "create_session",
     "get_session",
     "login",
     "login_utils",
@@ -20,6 +21,7 @@ __all__ = [
     "mv",
     "search",
     "set_session",
+    "set_session_credential",
     "singer",
     "song",
     "songlist",

{qqmusic_api_python-0.1.11 → qqmusic_api_python-0.2.1}/qqmusic_api/album.py

@@ -1,9 +1,9 @@
 """专辑相关 API"""
 
-from typing import Literal, Optional
+from typing import Literal
 
+from .utils.common import get_api
 from .utils.network import Api
-from .utils.utils import get_api
 
 API = get_api("album")
 
@@ -34,13 +34,13 @@ class Album:
     def __init__(
         self,
         *,
-        mid: Optional[str] = None,
-        id: Optional[int] = None,
+        mid: str | None = None,
+        id: int | None = None,
     ):
         """初始化专辑类
 
         Note:
-            歌曲 mid 和 id，两者至少提供一个
+            歌曲 mid 和 id,两者至少提供一个
 
         Args:
             mid: 专辑 mid
@@ -50,7 +50,7 @@ class Album:
             raise ValueError("mid or id must be provided")
         self.mid = mid or ""
         self.id = id or 0
-        self._info: Optional[dict] = None
+        self._info: dict | None = None
 
     async def get_mid(self) -> str:
         """获取专辑 mid

qqmusic_api_python-0.2.1/qqmusic_api/data/api/album.json

@@ -0,0 +1,22 @@
+{
+  "detail": {
+    "module": "music.musichallAlbum.AlbumInfoServer",
+    "method": "GetAlbumDetail",
+    "params": {
+      "albumMid": "str 专辑 mid",
+      "albumId": "str 专辑 id"
+    },
+    "comment": "获取专辑信息"
+  },
+  "song": {
+    "module": "music.musichallAlbum.AlbumSongList",
+    "method": "GetAlbumSongList",
+    "params": {
+      "albumMid": "str 专辑 mid",
+      "albumId": "str 专辑 id",
+      "begin": "int 开启位置",
+      "num": "int 返回数量"
+    },
+    "comment": "获取专辑歌曲"
+  }
+}

qqmusic_api_python-0.2.1/qqmusic_api/data/api/login.json

@@ -0,0 +1,196 @@
+{
+  "qq": {
+    "get_qrcode": {
+      "url": "https://ssl.ptlogin2.qq.com/ptqrshow",
+      "params": {
+        "appid": "716027609",
+        "e": "2",
+        "l": "M",
+        "s": "3",
+        "d": "72",
+        "v": "4",
+        "t": "str(random.random())",
+        "daid": "383",
+        "pt_3rd_aid": "100497308"
+      },
+      "headers": {
+        "Referer": "https://xui.ptlogin2.qq.com/"
+      },
+      "comment": "获取二维码二进制数据和 qrsig"
+    },
+    "check_qrcode_state": {
+      "url": "https://ssl.ptlogin2.qq.com/ptqrlogin",
+      "params": {
+        "u1": "https://graph.qq.com/oauth2.0/login_jump",
+        "ptqrtoken": "hash33(qrsig)",
+        "ptredirect": "0",
+        "h": "1",
+        "t": "1",
+        "g": "1",
+        "from_ui": "1",
+        "ptlang": "2052",
+        "action": "0-0-{time.time() * 1000}",
+        "js_ver": "20102616",
+        "js_type": "1",
+        "pt_uistyle": "40",
+        "aid": "716027609",
+        "daid": "383",
+        "pt_3rd_aid": "100497308",
+        "has_onekey": "1"
+      },
+      "headers": {
+        "Referer": "https://xui.ptlogin2.qq.com/"
+      },
+      "comment": "获取二维码状态"
+    },
+    "check_sig": {
+      "url": "https://ssl.ptlogin2.graph.qq.com/check_sig",
+      "ignore_code": true,
+      "params": {
+        "uin": "uin",
+        "pttype": "1",
+        "service": "ptqrlogin",
+        "nodirect": "0",
+        "ptsigx": "sigx",
+        "s_url": "https://graph.qq.com/oauth2.0/login_jump",
+        "ptlang": "2052",
+        "ptredirect": "100",
+        "aid": "716027609",
+        "daid": "383",
+        "j_later": "0",
+        "low_login_hour": "0",
+        "regmaster": "0",
+        "pt_login_type": "3",
+        "pt_aid": "0",
+        "pt_aaid": "16",
+        "pt_light": "0",
+        "pt_3rd_aid": "100497308"
+      },
+      "headers": {
+        "Referer": "https://xui.ptlogin2.qq.com/"
+      },
+      "comment": "获取 p_skey"
+    },
+    "authorize": {
+      "url": "https://graph.qq.com/oauth2.0/authorize",
+      "method": "POST",
+      "ignore_code": true,
+      "data": {
+        "response_type": "code",
+        "client_id": "100497308",
+        "redirect_uri": "https://y.qq.com/portal/wx_redirect.html?login_type=1&surl=https%3A%252F%252Fy.qq.com%252F",
+        "scope": "get_user_info,get_app_friends",
+        "state": "state",
+        "switch": "",
+        "from_ptlogin": "1",
+        "src": "1",
+        "update_auth": "1",
+        "openapi": "1010_1030",
+        "g_tk": "hash33(p_skey, 5381)",
+        "auth_time": "str(int(time.time()) * 1000)",
+        "ui": "str(uuid.uuid4())"
+      },
+      "comment": "QQ 鉴权"
+    },
+    "login": {
+      "module": "QQConnectLogin.LoginServer",
+      "method": "QQLogin",
+      "ignore_code": true,
+      "params": {
+        "code": "str 鉴权码",
+        "musicid": "int",
+        "musickey": "str",
+        "refresh_key": "str",
+        "refresh_token": "str"
+      },
+      "extra_common": {
+        "tmeLoginType": "str 2"
+      },
+      "comment": "QQ 登录"
+    }
+  },
+  "wx": {
+    "get_qrcode": {
+      "url": "https://open.weixin.qq.com/connect/qrconnect",
+      "params": {
+        "appid": "wx48db31d50e334801",
+        "redirect_uri": "https://y.qq.com/portal/wx_redirect.html?login_type=2&surl=https://y.qq.com/",
+        "response_type": "code",
+        "scope": "snsapi_login",
+        "state": "STATE",
+        "href": "https://y.qq.com/mediastyle/music_v17/src/css/popup_wechat.css#wechat_redirect"
+      },
+      "comment": "获取二维码二进制数据和 uuid"
+    },
+    "check_qrcode_state": {
+      "url": "https://lp.open.weixin.qq.com/connect/l/qrconnect",
+      "params": {
+        "uuid": "str uuid",
+        "_": "str 毫秒级时间戳"
+      },
+      "headers": {
+        "Referer": "https://open.weixin.qq.com/"
+      },
+      "comment": "获取二维码状态"
+    },
+    "login": {
+      "module": "music.login.LoginServer",
+      "method": "Login",
+      "ignore_code": true,
+      "params": {
+        "strAppid": "wx48db31d50e334801",
+        "code": "str 鉴权码",
+        "musicid": "int",
+        "musickey": "str",
+        "refresh_key": "str",
+        "refresh_token": "str",
+        "loginMode": "int 2"
+      },
+      "extra_common": {
+        "tmeLoginType": "str 1"
+      },
+      "comment": "微信登录"
+    }
+  },
+  "phone": {
+    "send_authcode": {
+      "module": "music.login.LoginServer",
+      "method": "SendPhoneAuthCode",
+      "ignore_code": true,
+      "params": {
+        "tmeAppid": "qqmusic",
+        "phoneNo": "str 手机号",
+        "encryptedPhoneNo ": "str 加密手机号",
+        "areaCode": "str 国家码(86)"
+      },
+      "extra_common": {
+        "tmeLoginMethod": "str 3"
+      },
+      "comment": "发送验证码"
+    },
+    "login": {
+      "module": "music.login.LoginServer",
+      "method": "Login",
+      "ignore_code": true,
+      "params": {
+        "code": "str 验证码",
+        "phoneNo": "str 手机号",
+        "encryptedPhoneNo ": "str 加密手机号",
+        "areaCode": "str 国家码(86)",
+        "loginMode": "int 1"
+      },
+      "extra_common": {
+        "tmeLoginMethod": "str 3",
+        "tmeLoginType": "str 0"
+      },
+      "comment": "手机验证码鉴权"
+    }
+  },
+  "check_expired": {
+    "module": "music.UserInfo.userInfoServer",
+    "method": "GetLoginUserInfo",
+    "verify": true,
+    "params": {},
+    "comment": "获取登录用户的信息，用于检测凭证是否失效"
+  }
+}

qqmusic_api_python-0.2.1/qqmusic_api/data/api/lyric.json

@@ -0,0 +1,25 @@
+{
+  "info": {
+    "module": "music.musichallSong.PlayLyricInfo",
+    "method": "GetPlayLyricInfo",
+    "params": {
+      "ct": "int 11",
+      "cv": "int 13020508",
+      "lrc_t": "int 0",
+      "roma": "int 是否返回罗马歌词",
+      "roma_t": "int 0",
+      "trans": "int 是否返回翻译歌词",
+      "trans_t": "int 0",
+      "type": "int 1",
+      "albumName": "str 专辑名字",
+      "crypt": "int 是否加密歌词",
+      "qrc": "int 是否返回 qrc",
+      "qrc_t": "int 0",
+      "singerName": "str 歌手名字(取第一个)",
+      "songId": "int 歌曲 id",
+      "songMid": "str 歌曲 mid",
+      "songName": "str 歌曲名字"
+    },
+    "comment": "获取歌曲歌词信息"
+  }
+}