qqmusic-api-python 0.1.0__tar.gz

qqmusic_api_python-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Luren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

qqmusic_api_python-0.1.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.1
+Name: qqmusic-api-python
+Version: 0.1.0
+Summary: QQ音乐API封装库
+Home-page: https://github.com/luren-dc/QQMusicApi
+License: MIT
+Keywords: music,api,qqmusic,tencentmusic
+Author: Luren
+Author-email: dluren.c@gmail.com
+Maintainer: Luren
+Maintainer-email: dluren.c@gmail.com
+Requires-Python: >=3.9,<4.0
+Classifier: Development Status :: 4 - Beta
+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
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: aiohttp (==3.9.5)
+Requires-Dist: cryptography (==41.0.2)
+Requires-Dist: requests (==2.31.0)
+Project-URL: Documentation, https://github.com/luren-dc/QQMusicApi
+Project-URL: Repository, https://github.com/luren-dc/QQMusicApi
+Description-Content-Type: text/markdown
+
+<div align="center">
+    <h1> QQMusicApi </h1>
+    <p> Python QQ音乐 API 封装库 </p>
+
+![Python Version 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+![GitHub license](https://img.shields.io/github/license/luren-dc/PyQQMusicApi)
+
+</div>
+
+---
+
+> [!WARNING]
+> 本仓库的所有内容仅供学习和参考之用，禁止用于商业用途。
+
+## 介绍
+
+使用 Python 编写的用于调用 [QQ音乐](https://y.qq.com/) 各种 API 的库.
+
+## 依赖
+
+本项目基于：
+
+- [AIOHTTP](https://docs.aiohttp.org/)
+- [Requests](https://requests.readthedocs.io/)
+- [Cryptography](https://cryptography.io/)
+
+## 快速上手
+
+### 安装
+
+```
+$ pip3 install qqmusic-api-python
+```
+
+### 使用
+
+```
+import asyncio
+
+from qqmusic_api import search
+
+async def main():
+    # 搜索歌曲
+    result = await search.search_by_type(keyword="周杰伦", num=20)
+    # 打印结果
+    print(result)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## TODO
+
+- [ ] 歌手 API
+
+## 参考项目
+
+- [Rain120/qq-muisc-api](https://github.com/Rain120/qq-muisc-api)
+- [jsososo/QQMusicApi](https://github.com/jsososo/QQMusicApi)
+- [Nemo2011/bilibili-api](https://github.com/Nemo2011/bilibili-api/)
+
+## Licence
+
+**[MIT License](https://github.com/luren-dc/QQMusicApi/blob/master/LICENSE)**
+

qqmusic_api_python-0.1.0/README.md

@@ -0,0 +1,65 @@
+<div align="center">
+    <h1> QQMusicApi </h1>
+    <p> Python QQ音乐 API 封装库 </p>
+
+![Python Version 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+![GitHub license](https://img.shields.io/github/license/luren-dc/PyQQMusicApi)
+
+</div>
+
+---
+
+> [!WARNING]
+> 本仓库的所有内容仅供学习和参考之用，禁止用于商业用途。
+
+## 介绍
+
+使用 Python 编写的用于调用 [QQ音乐](https://y.qq.com/) 各种 API 的库.
+
+## 依赖
+
+本项目基于：
+
+- [AIOHTTP](https://docs.aiohttp.org/)
+- [Requests](https://requests.readthedocs.io/)
+- [Cryptography](https://cryptography.io/)
+
+## 快速上手
+
+### 安装
+
+```
+$ pip3 install qqmusic-api-python
+```
+
+### 使用
+
+```
+import asyncio
+
+from qqmusic_api import search
+
+async def main():
+    # 搜索歌曲
+    result = await search.search_by_type(keyword="周杰伦", num=20)
+    # 打印结果
+    print(result)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## TODO
+
+- [ ] 歌手 API
+
+## 参考项目
+
+- [Rain120/qq-muisc-api](https://github.com/Rain120/qq-muisc-api)
+- [jsososo/QQMusicApi](https://github.com/jsososo/QQMusicApi)
+- [Nemo2011/bilibili-api](https://github.com/Nemo2011/bilibili-api/)
+
+## Licence
+
+**[MIT License](https://github.com/luren-dc/QQMusicApi/blob/master/LICENSE)**

qqmusic_api_python-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[tool.poetry]
+name = "qqmusic-api-python"
+version = "0.1.0"
+description = "QQ音乐API封装库"
+authors = ["Luren <dluren.c@gmail.com>"]
+packages = [{ include = "qqmusic_api" }]
+license = "MIT"
+readme = "README.md"
+maintainers = ["Luren <dluren.c@gmail.com>"]
+homepage = "https://github.com/luren-dc/QQMusicApi"
+repository = "https://github.com/luren-dc/QQMusicApi"
+documentation = "https://github.com/luren-dc/QQMusicApi"
+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",
+]
+
+[tool.poetry.dependencies]
+python = "^3.9"
+cryptography = "41.0.2"
+requests = "2.31.0"
+aiohttp = "3.9.5"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "8.2.0"
+pytest-asyncio = "0.23.6"
+qrcode = { extras = ["pil"], version = "7.4.2" }
+pyzbar = "0.1.9"
+pytest-timeout = "2.3.1"
+pytest-sugar = "1.0.0"
+pre-commit = "3.7.0"
+
+[tool.mypy]
+disable_error_code = ["index", "arg-type", "union-attr", "return-value"]
+pretty = true
+show_column_numbers = true
+
+[tool.pytest.ini_options]
+pythonpath = "./"
+timeout = 30
+testpaths = ["tests"]
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

qqmusic_api_python-0.1.0/qqmusic_api/__init__.py

@@ -0,0 +1,4 @@
+from .api import album, mv, login, search, song, songlist, top
+from .utils.credential import Credential
+
+__all__ = ["album", "Credential", "login", "mv", "search", "song", "songlist", "top"]

qqmusic_api_python-0.1.0/qqmusic_api/api/album.py

@@ -0,0 +1,40 @@
+from qqmusic_api.api.song import Song
+
+from ..utils.common import get_api
+from ..utils.network import Api
+
+API = get_api("album")
+
+
+class Album:
+    """
+    专辑类
+    """
+
+    def __init__(self, mid: str):
+        """
+        Args:
+            mid: 专辑 mid
+        """
+        self.mid = mid
+
+    async def get_detail(self) -> dict:
+        """
+        Returns:
+            dict: 专辑详细信息
+        """
+        return await Api(**API["detail"]).update_params(albumMid=self.mid).result
+
+    async def get_song(self) -> list[Song]:
+        """
+        获取专辑歌曲
+
+        Returns:
+            list: 歌曲列表
+        """
+        result = (
+            await Api(**API["song"])
+            .update_params(albumMid=self.mid, begin=0, num=0)
+            .result
+        )
+        return [Song.from_dict(song["songInfo"]) for song in result["songList"]]