qqmusic-api-python 0.1.10__tar.gz → 0.2.0__tar.gz

qqmusic_api_python-0.2.0/.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.10 → qqmusic_api_python-0.2.0}/PKG-INFO

@@ -1,59 +1,55 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: qqmusic-api-python
-Version: 0.1.10
+Version: 0.2.0
 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.9
+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">
-    <h1> QQMusicApi </h1>
-    <p> Python QQ音乐 API 封装库 </p>
-    <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">
-    </a>
-    <a href="https://github.com/astral-sh/ruff">
-        <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
+    <a>
+        <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://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 href="https://www.python.org">
+        <img src="https://img.shields.io/badge/Python-3.9|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/PyQQMusicApi" alt="GitHub license">
+        <img src="https://img.shields.io/github/license/luren-dc/QQMusicApi" alt="GitHub license">
     </a>
     <a href="https://github.com/luren-dc/QQMusicApi/stargazers">
         <img src="https://img.shields.io/github/stars/luren-dc/QQMusicApi?color=yellow&label=Github%20Stars" alt="STARS">
     </a>
     <a href="https://github.com/luren-dc/QQMusicApi/actions/workflows/testing.yml">
-        <img src="https://github.com/luren-dc/QQMusicApi/actions/workflows/testing.yml/badge.svg?branch=dev" alt="Testing">
+        <img src="https://github.com/luren-dc/QQMusicApi/actions/workflows/testing.yml/badge.svg?branch=main" alt="Testing">
     </a>
 </div>
 
 ---
 
-> [!WARNING]
+> [!IMPORTANT]
 > 本仓库的所有内容仅供学习和参考之用，禁止用于商业用途
 >
-> All contents in this repo are for learning and reference only and are not allowed to be used for commercial purposes.
+> **音乐平台不易，请尊重版权，支持正版。**
 
 **文档**: <a href="https://luren-dc.github.io/QQMusicApi" target="_blank">https://luren-dc.github.io/QQMusicApi</a>
 
@@ -67,12 +63,10 @@ Description-Content-Type: text/markdown
 
 - 涵盖常见 API
 - 调用简便，函数命名易懂，代码注释详细
-- 异步操作
+- 完全异步操作
 
 ## 依赖
 
-- ~~[AIOHTTP](https://docs.aiohttp.org/)~~
-- ~~[Requests](https://requests.readthedocs.io/)~~
 - [Cryptography](https://cryptography.io/)
 - [HTTPX](https://github.com/encode/httpx/)
 
@@ -100,18 +94,14 @@ async def main():
 asyncio.run(main())
 ```
 
-## 参考项目
+## Licence
 
-### API
-[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Rain120&repo=qq-music-api)](https://github.com/Rain120/qq-music-api)
-[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=jsososo&repo=QQMusicApi)](https://github.com/jsososo/QQMusicApi)
+本项目基于 **[MIT License](https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file)** 许可证发行。
 
-### QRC 解密
-[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=chenmozhijin&repo=LDDC)](https://github.com/chenmozhijin/LDDC)
+## 免责声明
 
-### 项目架构
-[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Nemo2011&repo=bilibili-api)](https://github.com/Nemo2011/bilibili-api)
+由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害（包括但不限于因商誉损失、停工、计算机故障或故障引起的损害赔偿，或任何及所有其他商业损害或损失）由使用者负责
 
-## Licence
+## 贡献者
 
-**[MIT License](https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file)**
+[![Contributor](https://contrib.rocks/image?repo=luren-dc/QQMusicApi)](https://github.com/luren-dc/QQMusicApi/graphs/contributors)

{qqmusic_api_python-0.1.10 → qqmusic_api_python-0.2.0}/README.md

@@ -1,32 +1,27 @@
 <div align="center">
-    <h1> QQMusicApi </h1>
-    <p> Python QQ音乐 API 封装库 </p>
-    <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">
-    </a>
-    <a href="https://github.com/astral-sh/ruff">
-        <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
+    <a>
+        <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://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 href="https://www.python.org">
+        <img src="https://img.shields.io/badge/Python-3.9|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/PyQQMusicApi" alt="GitHub license">
+        <img src="https://img.shields.io/github/license/luren-dc/QQMusicApi" alt="GitHub license">
     </a>
     <a href="https://github.com/luren-dc/QQMusicApi/stargazers">
         <img src="https://img.shields.io/github/stars/luren-dc/QQMusicApi?color=yellow&label=Github%20Stars" alt="STARS">
     </a>
     <a href="https://github.com/luren-dc/QQMusicApi/actions/workflows/testing.yml">
-        <img src="https://github.com/luren-dc/QQMusicApi/actions/workflows/testing.yml/badge.svg?branch=dev" alt="Testing">
+        <img src="https://github.com/luren-dc/QQMusicApi/actions/workflows/testing.yml/badge.svg?branch=main" alt="Testing">
     </a>
 </div>
 
 ---
 
-> [!WARNING]
+> [!IMPORTANT]
 > 本仓库的所有内容仅供学习和参考之用，禁止用于商业用途
 >
-> All contents in this repo are for learning and reference only and are not allowed to be used for commercial purposes.
+> **音乐平台不易，请尊重版权，支持正版。**
 
 **文档**: <a href="https://luren-dc.github.io/QQMusicApi" target="_blank">https://luren-dc.github.io/QQMusicApi</a>
 
@@ -40,12 +35,10 @@
 
 - 涵盖常见 API
 - 调用简便，函数命名易懂，代码注释详细
-- 异步操作
+- 完全异步操作
 
 ## 依赖
 
-- ~~[AIOHTTP](https://docs.aiohttp.org/)~~
-- ~~[Requests](https://requests.readthedocs.io/)~~
 - [Cryptography](https://cryptography.io/)
 - [HTTPX](https://github.com/encode/httpx/)
 
@@ -73,18 +66,14 @@ async def main():
 asyncio.run(main())
 ```
 
-## 参考项目
+## Licence
 
-### API
-[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Rain120&repo=qq-music-api)](https://github.com/Rain120/qq-music-api)
-[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=jsososo&repo=QQMusicApi)](https://github.com/jsososo/QQMusicApi)
+本项目基于 **[MIT License](https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file)** 许可证发行。
 
-### QRC 解密
-[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=chenmozhijin&repo=LDDC)](https://github.com/chenmozhijin/LDDC)
+## 免责声明
 
-### 项目架构
-[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Nemo2011&repo=bilibili-api)](https://github.com/Nemo2011/bilibili-api)
+由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害（包括但不限于因商誉损失、停工、计算机故障或故障引起的损害赔偿，或任何及所有其他商业损害或损失）由使用者负责
 
-## Licence
+## 贡献者
 
-**[MIT License](https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file)**
+[![Contributor](https://contrib.rocks/image?repo=luren-dc/QQMusicApi)](https://github.com/luren-dc/QQMusicApi/graphs/contributors)

qqmusic_api_python-0.2.0/pyproject.toml

@@ -0,0 +1,100 @@
+[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.9"
+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.9"
+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.10 → qqmusic_api_python-0.2.0}/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.10"
+__version__ = "0.2.0"
 
 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.10 → qqmusic_api_python-0.2.0}/qqmusic_api/album.py

@@ -2,8 +2,8 @@
 
 from typing import Literal, Optional
 
+from .utils.common import get_api
 from .utils.network import Api
-from .utils.utils import get_api
 
 API = get_api("album")
 
@@ -40,7 +40,7 @@ class Album:
         """初始化专辑类
 
         Note:
-            歌曲 mid 和 id，两者至少提供一个
+            歌曲 mid 和 id,两者至少提供一个
 
         Args:
             mid: 专辑 mid

qqmusic_api_python-0.2.0/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": "获取专辑歌曲"
+  }
+}