一个功能强大的python库，使用最简单易用的方法获取一切你想要的信息。
-支持python3以上版本
pip install cloudmusic
-music = cloudmusic.getMusic(1347630432) - -print("歌名：{}".format(music.name)) -print("歌手：{}".format(music.artist)) -print("音频文件url：{}".format(music.url)) - -# >>> -# 歌名：白日 日剧《冤罪律师》主题曲 -# 歌手：['King Gnu'] -# 音频文件url：http://m10.music.126.net/.../.mp3 - -
playlist = cloudmusic.getPlaylist(310729011) - -for music in playlist: - music.download(level = "lossless") - -
music = cloudmusic.getMusic(1347630432) - -coms = music.getHotComments() - -for com in coms: - print("发布者：{}".format(com['nickName'])) - print("内容：{}".format(com['content'])) - print("获赞数：{}".format(com['likeCount'])) - print("------------") - -# >>> -# 发布者：Akikonknk -# 内容：特别喜欢日剧的一个原因 大概就是它帮你认清生活的真相之后 依然教会你如何热爱生活 -# 获赞数：19451 -# ------------ -# 发布者：我藏起来啦嘻嘻 -# 内容：最后一集的犯人真的是应证了那一句话“雪崩的时候没有一片雪花是无辜的” -# 获赞数：6690 -# ------------ -# 发布者：Usio叔叔 -# ... - -
results = cloudmusic.search("白日", 100) - -for music in results: - print(music.getCommentsCount()) - -# 5745 -# 77 -# 181 -# 560 -# 368 -# ... - -
download(dirs, level)--dirs：可选。下载保存路径。默认为当前文件夹内创建的新的cloudmusic文件夹。
-
-level：可选，字符型。默认higher。下载品质，有且只有四种选择：standard，higher，exhigh，lossless。
下载歌曲，返回值为下载绝对路径
-getHotComments(number)--number：可选，整型，默认为15。希望获取的评论个数。上限为15个。
-
获取热评。返回值为列表，列表元素为字典，字典内容：
-"likeCount"：获赞数
-"content"：评论内容
-"time"：评论时间
-"userId"：用户id
-"nickNamd"：用户昵称
-"avatarUrl"：用户头像url
-"vipType"：0表示未开通vip，10表示开通音乐包，11表示开通黑胶
-"userType"：0表示普通用户，非0表示特殊用户（明星，丁磊，网红，小秘书等）
getComments(number)--number：整型，评论个数。数量无限制。
-
获取最新的评论。返回值与getHotReview相同。
-getLyrics()获取歌词。返回值为列表。元素1为原始歌词，元素2为翻译歌词。
-getCommentsCount()返回值为整型，本首歌的评论数量。
-getMusic(id/id_list)--id/id_list: 必须，整型、字符型或列表。歌曲id或由歌曲id组成的列表。
-
通过歌曲id或一个由id组成的列表生成music对象。当参数为单个id时返回值为单个music对象，当参数为id列表时返回值为music对象组成的列表。
-getPlaylist(id)--id：必须，整型或字符型。歌单id。
-
通过歌单id生成music对象，参数为歌单id，返回值为歌单内所有歌曲对应music对象组成的列表。
-search(content, number)--content：必须，字符型。搜索关键字。
-
-number：可选，整形，搜索结果个数，默认为5。
通过关键词搜索获取music对象。返回值为music对象组成的列表。
-getAlbum(id)--id: 必须，整型或字符型。专辑id。
-
和getPlaylist一样。
-getPlaylist()获取用户创建和收藏的全部歌单，返回值为一个列表，每个元素是一个歌单信息组成的字典。字典内容：
-id：歌单id；
-name：歌单名称；
-creatorId：创建者id；
-createTime：创建时间；
-coverImgUrl：歌单封面图片url；
-updateTime：歌单最后一次更新时间；
-tags：歌单所属音乐风格，列表形式
getRecord(recordType)--recordType: 可选。默认为0。为0返回所有时间排行，非0返回最近一周排行。
-
获取用户听歌排行，返回一个列表，元素为字典。字典内容：
-score：分值。100表示听歌次数最多，越小越少；
-music：Music对象
getUser(id)--id：必须，用户id。
-
通过用户id获取User对象，返回值为User对象。
-@p697
- -项目已恢复维护。原静态 HTML/PDF 文档对应 0.1.1，当前接口、安装方法和迁移说明请查看仓库文档。
+ + + diff --git a/README.md b/README.md index 152ea56..479a714 100644 --- a/README.md +++ b/README.md @@ -1,224 +1,188 @@ -cloudmusic: 网易云爬虫解决方案 -======================= +# cloudmusic -一个功能强大的python库，使用最简单易用的方法获取一切你想要的信息。 -支持python3以上版本 +一个轻量的网易云音乐 Python 客户端：查询歌曲、专辑、歌单、歌词、评论和用户公开资料，并下载当前账号有权访问的完整音频。 -安装 ------ -```bash -pip install cloudmusic -``` - -简单示例 ------ -- 通过歌曲id获取Music对象，并展示部分属性 -```python -music = cloudmusic.getMusic(1347630432) +支持 Python 3.10–3.14。保留 `getMusic()`、`getPlaylist()`、`search()` 等原有调用方式。 -print("歌名：{}".format(music.name)) -print("歌手：{}".format(music.artist)) -print("音频文件url：{}".format(music.url)) +> 仓库维护版本为 **0.2.0**。在发布到 PyPI 之前，`pip install cloudmusic` 仍可能安装旧的 0.1.1。请按下面的源码安装方式使用当前版本。历史 HTML/PDF 文档对应 0.1.1，当前接口以本 README 为准。 -# >>> -# 歌名：白日 日剧《冤罪律师》主题曲 -# 歌手：['King Gnu'] -# 音频文件url：http://m10.music.126.net/.../.mp3 +## 安装 +```bash +git clone https://github.com/p697/cloudmusic.git +cd cloudmusic +python -m pip install . ``` -- 通过歌单id获取Music对象列表，并下载整个歌单的无损品质音频 -```python -playlist = cloudmusic.getPlaylist(310729011) +运行时仅依赖 `requests` 和 `pycryptodomex`，不再要求 `lxml` 或 `threadpool`。 -for music in playlist: - music.download(level = "lossless") +## 快速开始 -``` - -- 获取一首歌的热评并展示部分信息 ```python +import cloudmusic + music = cloudmusic.getMusic(1347630432) +print(music.name, music.artist, music.album) +print(music.getLyrics()) # [原文歌词, 翻译歌词]；缺失项为空字符串 -coms = music.getHotComments() - -for com in coms: - print("发布者：{}".format(com['nickName'])) - print("内容：{}".format(com['content'])) - print("获赞数：{}".format(com['likeCount'])) - print("------------") - -# >>> -# 发布者：Akikonknk -# 内容：特别喜欢日剧的一个原因 大概就是它帮你认清生活的真相之后 依然教会你如何热爱生活 -# 获赞数：19451 -# ------------ -# 发布者：我藏起来啦嘻嘻 -# 内容：最后一集的犯人真的是应证了那一句话“雪崩的时候没有一片雪花是无辜的” -# 获赞数：6690 -# ------------ -# 发布者：Usio叔叔 -# ... +results = cloudmusic.search("白日", number=5) +for song in results: + print(song.id, song.name) +playlist = cloudmusic.getPlaylist(310729011) +print(len(playlist)) ``` -- 通过关键字搜索获取前100首歌曲的Music对象，并输出每首歌的评论数量 -```python -results = cloudmusic.search("白日", 100) - -for music in results: - print(music.getCommentsCount()) - -# 5745 -# 77 -# 181 -# 560 -# 368 -# ... +歌曲信息与音频权限相互独立。获取歌曲名称、专辑、歌词或评论不需要先获取播放地址。访问 `music.url`、`size`、`type`、`level` 或 `freeTrialInfo` 时，才获取音频信息；同一批歌曲共享批量请求。音频信息缓存 60 秒，以减少重复请求和过期链接。 +```python +try: + print(music.url) # 没有播放权限时可能为 None；接口风控会抛出 APIError + print(music.level) # 服务实际返回的品质，可能低于请求品质 + path = music.download(dirs="./downloads") + print(path) # 已保存文件的绝对路径 +except cloudmusic.CloudMusicError as error: + print(error) ``` ----- - -参考文档 ------ -### Music对象 -#### 1.Music对象属性 -- **url**：歌曲音频文件链接 -- **id**：歌曲id -- **name**：歌曲名称 -- **artist**：歌手名称 -- **artistId**: 歌手id -- **album**：专辑名称 -- **albumId**: 专辑id -- **size**：音频文件大小 -- **type**：音频文件类型（mp3或m4a） -- **level**：歌曲品质。默认higher -- **picUrl**: 专辑图url - -#### 2.Music对象方法 -- #### `download(dirs, level)` - >***dirs***：可选。下载保存路径。默认为当前文件夹内创建的新的cloudmusic文件夹。 - ***level***：可选，字符型。默认higher。下载品质，有且只有四种选择：standard，higher，exhigh，lossless。 - - 下载歌曲，返回值为下载绝对路径 - - -- #### `getHotComments(number)` - >***number***：可选，整型，默认为15。希望获取的评论个数。上限为15个。 - 获取热评。返回值为列表，列表元素为字典，字典内容： - *"likeCount"：获赞数* - *"content"：评论内容* - *"time"：评论时间* - *"userId"：用户id* - *"nickNamd"：用户昵称* - *"avatarUrl"：用户头像url* - *"vipType"：0表示未开通vip，10表示开通音乐包，11表示开通黑胶* - *"userType"：0表示普通用户，非0表示特殊用户（明星，丁磊，网红，小秘书等）* +下载采用流式写入和临时文件替换。只有成功完成下载才覆盖同名目标文件；失败会保留已有文件并清理临时文件。仅有试听音频时抛出 `UnavailableError`，不会把试听片段当成完整歌曲保存。 +## 配置会话 -- #### `getComments(number)` - >***number***：整型，评论个数。数量无限制。 +默认匿名访问。需要账号权限时，可以显式传入自己的 cookie；库不包含任何内置登录凭据，不自动读取浏览器或环境中的凭据。 - 获取最新的评论。返回值与getHotReview相同。 - - -- #### `getLyrics()` - 获取歌词。返回值为列表。元素1为原始歌词，元素2为翻译歌词。 - - -- #### `getCommentsCount()` - 返回值为整型，本首歌的评论数量。 - -#### 3.获取Music对象函数 - -- #### `getMusic(id/id_list)` - >***id/id_list***: 必须，整型、字符型或列表。歌曲id或由歌曲id组成的列表。 - - 通过歌曲id或一个由id组成的列表生成music对象。当参数为单个id时返回值为单个music对象，当参数为id列表时返回值为music对象组成的列表。 - -- #### `getPlaylist(id)` - >***id***：必须，整型或字符型。歌单id。 - - 通过歌单id生成music对象，参数为歌单id，返回值为歌单内所有歌曲对应music对象组成的列表。 - -- #### `search(content, number)` - >***content***：必须，字符型。搜索关键字。 - ***number***：可选，整形，搜索结果个数，默认为5。 +```python +import os +import cloudmusic + +with cloudmusic.Client( + cookie=os.environ.get("NETEASE_COOKIE"), + timeout=(5, 20), # 连接超时、单次读取超时，单位秒 + level="higher", + # proxies={"https": "http://127.0.0.1:7890"}, +) as client: + music = client.getMusic(1347630432) + songs = client.search("白日", 5) + +# 返回的 Music/User 对象保留配置；关闭 Client 后仍可按需调用。 +print(music.getLyrics()) +``` - 通过关键词搜索获取music对象。返回值为music对象组成的列表。 +`cookie` 支持 cookie 字符串或字典。`Client` 复用查询连接并保留服务端更新的会话 cookie，使用完毕后应调用 `close()` 或用 `with` 管理。网络错误和风控错误不会自动反复重试；同批音频遇到验证/登录限制后，在 60 秒内复用该错误，避免批量任务重复触发限制。音频 CDN 请求不携带网易云登录 cookie。 -- #### `getAlbum(id)` - >***id***: 必须，整型或字符型。专辑id。 +该项目依赖网易云的非官方接口。接口返回内容受登录状态、隐私设置、地区和音频权限限制；升级客户端不能保证获取所有歌曲、无限评论或指定音质。不要将 cookie 提交到 Git 或输出到公开日志。 - 和getPlaylist一样。 +## API ---- +以下函数也可以通过 `Client` 调用： -### User对象 -#### 1.User对象属性 -- **id**：用户id -- **level**：用户等级 -- **listenSongs**：累计听歌数量 -- **createTime**：账号创建时间 -- **nickName**：用户昵称 -- **avatarUrl**：头像url -- **city**：所在城市的行政区划代码 -- **province**：所在省份的行政区划代码 -- **vipType**：vip类型。0表示未开通vip，10表示开通音乐包，11表示开通黑胶 -- **birthday**：生日时间戳 -- **signature**：个性签名 -- **fans**：粉丝数量 -- **follows**：关注的用户数量 -- **eventCount**：动态数量 -- **playlistCount**：创建的歌单数量 +| 函数 | 返回值 | +| --- | --- | +| `getMusic(id)` | 一个 `Music` 对象 | +| `getMusic([id, ...])` | `Music` 列表，保留输入顺序和重复 ID；单元素列表仍返回列表；空列表返回 `[]` | +| `getPlaylist(id)` | 按歌单顺序排列的 `Music` 列表 | +| `getAlbum(id)` | 按专辑顺序排列的 `Music` 列表 | +| `search(content, number=5)` | 最多 `number` 个不重复的搜索结果；支持分页；无结果返回 `[]` | +| `getUser(id)` | `User` 对象 | -#### 2.User对象方法 +ID 支持正整数或整数字符串。无效参数抛出 `ValueError`；歌曲 ID 不存在时抛出 `NotFoundError`，其 `ids` 字段包含缺失 ID。歌单返回数量与服务报告的总数不一致时抛出 `IncompleteResultError`，不会静默当作完整歌单。 -- #### `getPlaylist()` - 获取用户创建和收藏的全部歌单，返回值为一个列表，每个元素是一个歌单信息组成的字典。字典内容： - *id：歌单id；* - *name：歌单名称；* - *creatorId：创建者id；* - *createTime：创建时间；* - *coverImgUrl：歌单封面图片url；* - *updateTime：歌单最后一次更新时间；* - *tags：歌单所属音乐风格，列表形式* +```python +try: + songs = cloudmusic.getPlaylist(310729011) +except cloudmusic.IncompleteResultError as error: + print(error.actual_count, error.expected_count) + songs = error.partial_result # 调用方明确选择是否使用已获取部分 +``` -- #### `getRecord(recordType)` - >***recordType***: 可选。默认为0。为0返回所有时间排行，非0返回最近一周排行。 +### Music - 获取用户听歌排行，返回一个列表，元素为字典。字典内容： - *score：分值。100表示听歌次数最多，越小越少；* - *music：Music对象* +元数据属性：`id`（字符串）、`name`、`artist`、`artistId`、`album`、`albumId`、`picUrl`。 -#### 3.获取User对象函数 +按需获取的音频属性：`url`、`size`、`type`、`level`、`freeTrialInfo`。 -- #### `getUser(id)` - >***id***：必须，用户id。 +| 方法 | 行为 | +| --- | --- | +| `download(dirs="", level=None)` | 默认保存到当前目录的 `cloudmusic` 文件夹；`level=None` 沿用创建对象时的请求品质（默认 `higher`） | +| `getLyrics()` | 返回 `[原文, 翻译]`，缺失项为空字符串 | +| `getHotComments(number=15)` | 最多 15 条热评 | +| `getComments(number)` | 按时间从新到旧，使用游标分页；不足时返回可获取的数量 | +| `getCommentsCount()` | 服务报告的评论总数 | - 通过用户id获取User对象，返回值为User对象。 +品质参数保留 `standard`、`higher`、`exhigh`、`lossless`。实际品质由接口和账号权限决定。指定音质不会丢失下载目录，文件扩展名取服务实际返回值。 ---- -@p697 +评论字段：`commentId`、`likeCount`、`content`、`time`、`userId`、`nickName`、`avatarUrl`、`vipType`、`userType`。用户已注销或字段缺失时，昵称和头像可以为空。若服务表示还有数据但分页无法继续，抛出带 `partial_result` 的 `IncompleteResultError`，避免无限循环或重复结果。 +### User +属性：`id`、`level`、`listenSongs`、`createTime`、`nickname`（也支持 `nickName`）、`avatarUrl`、`city`、`province`、`vipType`、`birthday`、`signature`、`fans`、`follows`、`eventCount`、`playlistCount`、`sex`。部分资料可能因隐私设置缺失。 +- `getPlaylist()`：分页获取可访问的用户歌单，返回信息字典列表。字段包括 `id`、`name`、`creatorId`、`playCount`、`createTime`、`coverImgUrl`、`updateTime`、`tags`。 +- `getRecord(recordType=0)`：0 为所有时间，正整数为最近一周；返回 `{"score": ..., "music": Music}` 列表，只请求所需周期。 +### 批量下载 +```python +loader = cloudmusic.createLoader(procs=2, dirs="./downloads") +loader.data = cloudmusic.getPlaylist(310729011) +try: + loader.start() +except cloudmusic.DownloadError: + print(loader.errors) # 失败项：以 data 中的索引为键 +print(loader.results) # 成功保存的绝对路径，按输入顺序排列 +``` +最多同时使用 32 个工作线程。文件名会处理跨平台非法字符和过长名称；同名歌曲仍会覆盖同一目标文件，请选择适当的目录管理下载结果。 +### 错误类型 +均继承 `CloudMusicError`，无效调用参数使用标准 `ValueError`。 +| 类型 | 含义 | +| --- | --- | +| `RequestError` | 网络/超时/非 200 HTTP 响应；`status_code` 在 HTTP 失败时可用 | +| `APIError` | 网易云业务错误；保留 `code` 和 `message`，包括风控、验证或登录要求 | +| `ResponseError` | JSON 或响应结构异常 | +| `NotFoundError` | 指定歌曲不存在，保留 `ids` | +| `UnavailableError` | 没有完整音频可供下载 | +| `IncompleteResultError` | 歌单不完整或分页停止前进；保留 `partial_result` | +| `DownloadError` | 文件下载未完整完成或批量下载部分失败 | +## 测试与开发 +```bash +python -m pip install -e '.[test]' +python -m pytest --cov=cloudmusic --cov-branch --cov-report=term-missing +python -m ruff check cloudmusic tests +python -m build +``` +默认测试禁止外部联网，并通过本地 HTTP 服务验证流式下载、错误响应、中断、临时文件清理和已有文件保护。CI 在 Linux、macOS、Windows 上运行 Python 3.10、3.12、3.14 的测试，以及独立 wheel 安装检查。 +真实接口测试显式启用，依赖当前网络环境和服务状态，不参与必过 CI： +```bash +python -m pytest --live -m live -v +``` +真实测试默认匿名，不修改账号内容，也不批量下载音频。远端拒绝会表现为测试失败，不会被记为成功。若已在本机配置测试账号的 `NETEASE_COOKIE` 环境变量，可以明确启用登录态测试： +```bash +python -m pytest --live --cookie-env NETEASE_COOKIE -m live -v --tb=short +``` +未传 `--cookie-env` 时测试不会读取任何登录 cookie。具体实测范围和限制见 [验收记录](docs/verification.md)。 +## 从 0.1.1 迁移 +- Python 最低版本更新为 3.10。 +- 原有高层函数和对象属性保留，修正了单元素列表返回类型。 +- 音频属性按需读取；网络/权限错误可能在访问这些属性时出现。 +- 下载默认沿用对象品质；明确传入 `level="standard"` 时会请求该品质。 +- 错误不再以字符串、打印信息、`None` 或意外 `KeyError` 混合返回；请处理相应异常。 +- `query.py` 内部旧 HTML 抓取函数已移除。内部模块不是稳定 API。 +- 尚未自动发布到 PyPI。 +历史贡献参考：[PR #14](https://github.com/p697/cloudmusic/pull/14)、[PR #17](https://github.com/p697/cloudmusic/pull/17)、[PR #21](https://github.com/p697/cloudmusic/pull/21)。本轮吸收了跨平台路径和音质目录传递的修复方向；封面/标签写入功能暂未纳入。 +MIT License · @p697 diff --git a/cloudmusic/__init__.py b/cloudmusic/__init__.py index 47f2899..628d735 100644 --- a/cloudmusic/__init__.py +++ b/cloudmusic/__init__.py @@ -1 +1,36 @@ -from .cloudmusic import * \ No newline at end of file +from .__version__ import __version__ +from .cloudmusic import Client, createLoader, getAlbum, getMusic, getPlaylist, getUser, help, search +from .exceptions import ( + APIError, + CloudMusicError, + DownloadError, + IncompleteResultError, + NotFoundError, + RequestError, + ResponseError, + UnavailableError, +) +from .musicObj import Music +from .userObj import User + +__all__ = [ + "Client", + "Music", + "User", + "getMusic", + "getPlaylist", + "getAlbum", + "getUser", + "search", + "createLoader", + "help", + "__version__", + "CloudMusicError", + "APIError", + "RequestError", + "ResponseError", + "NotFoundError", + "UnavailableError", + "IncompleteResultError", + "DownloadError", +] diff --git a/cloudmusic/__version__.py b/cloudmusic/__version__.py index c5f1956..d3ec452 100644 --- a/cloudmusic/__version__.py +++ b/cloudmusic/__version__.py @@ -1,8 +1 @@ -# 8b d8 Yb dP 88""Yb db dP""b8 88 dP db dP""b8 888888 -# 88b d88 YbdP 88__dP dPYb dP `" 88odP dPYb dP `" 88__ -# 88YbdP88 8P 88""" dP__Yb Yb 88"Yb dP__Yb Yb "88 88"" -# 88 YY 88 dP 88 dP""""Yb YboodP 88 Yb dP""""Yb YboodP 888888 - -VERSION = (0, 1, 0) - -__version__ = '.'.join(map(str, VERSION)) +__version__ = "0.2.0" diff --git a/cloudmusic/api.py b/cloudmusic/api.py index 290f1be..9b2c53b 100644 --- a/cloudmusic/api.py +++ b/cloudmusic/api.py @@ -1,105 +1,159 @@ -from . import query -from . import encrypt +"""NetEase read-only endpoints and a reusable, caller-configured connection.""" import json -import random +import math +from collections.abc import Mapping +from http.cookies import SimpleCookie +import requests + +from . import encrypt, query -class Api: - def __init__(self): - self.userAgent = [ - "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36", - "Mozilla/5.0 (iPhone; CPU iPhone OS 9_1 like Mac OS X) AppleWebKit/601.1.46 (KHTML, like Gecko) Version/9.0 Mobile/13B143 Safari/601.1", - "Mozilla/5.0 (iPhone; CPU iPhone OS 9_1 like Mac OS X) AppleWebKit/601.1.46 (KHTML, like Gecko) Version/9.0 Mobile/13B143 Safari/601.1", - "Mozilla/5.0 (Linux; Android 5.0; SM-G900P Build/LRX21T) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Mobile Safari/537.36", - "Mozilla/5.0 (Linux; Android 6.0; Nexus 5 Build/MRA58N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Mobile Safari/537.36", - "Mozilla/5.0 (Linux; Android 5.1.1; Nexus 6 Build/LYZ28E) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Mobile Safari/537.36", - "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_2 like Mac OS X) AppleWebKit/603.2.4 (KHTML, like Gecko) Mobile/14F89;GameHelper", - "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4", - "Mozilla/5.0 (iPhone; CPU iPhone OS 10_0 like Mac OS X) AppleWebKit/602.1.38 (KHTML, like Gecko) Version/10.0 Mobile/14A300 Safari/602.1", - "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36", - "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.12; rv:46.0) Gecko/20100101 Firefox/46.0", - "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:46.0) Gecko/20100101 Firefox/46.0", - "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 6.0)", - "Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.0; Trident/4.0)", - "Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0)", - "Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.2; Win64; x64; Trident/6.0)", - "Mozilla/5.0 (Windows NT 6.3; Win64, x64; Trident/7.0; rv:11.0) like Gecko", - "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/13.10586", - "Mozilla/5.0 (iPad; CPU OS 10_0 like Mac OS X) AppleWebKit/602.1.38 (KHTML, like Gecko) Version/10.0 Mobile/14A300 Safari/602.1" - ] - musicU = 'e4ace7b13afdd88161175bda1c091445ad6bc398f36fb0f0315f1fa0787d4fbce7c70899629a7e58dcb329764b52b00341049cea1c6bb9b6' - self.CookiesList = [ - 'os=pc; osver=Microsoft-Windows-10-Professional-build-10586-64bit; appver=2.0.3.131777; channel=netease; __remember_me=true', - 'MUSIC_U=' + musicU + '; buildver=1506310743; resolution=1920x1080; mobilename=MI5; osver=7.0.1; channel=coolapk; os=android; appver=4.2.0', - 'osver=%E7%89%88%E6%9C%AC%2010.13.3%EF%BC%88%E7%89%88%E5%8F%B7%2017D47%EF%BC%89; os=osx; appver=1.5.9; MUSIC_U=' + - musicU + '; channel=netease;' - ] - self.headers = { - 'User-Agent': random.choice(self.userAgent), - 'cookie': random.choice(self.CookiesList), - 'referer': 'https://music.163.com' +class Api: + def __init__(self, *, cookie=None, timeout=(5, 20), proxies=None): + values = timeout if isinstance(timeout, (list, tuple)) else (timeout,) + if len(values) not in (1, 2) or any( + isinstance(v, bool) or not isinstance(v, (int, float)) or not math.isfinite(v) or v <= 0 + for v in values + ): + raise ValueError("timeout 必须是正数或 (连接超时, 读取超时)") + self.timeout = tuple(values) if len(values) == 2 else values[0] + self.proxies = dict(proxies or {}) + cookies = {"os": "pc"} + if isinstance(cookie, str): + parsed = SimpleCookie() + parsed.load(cookie) + if cookie.strip() and not parsed: + raise ValueError("cookie 格式无效") + cookies.update({key: value.value for key, value in parsed.items()}) + elif cookie is not None: + if not isinstance(cookie, Mapping): + raise ValueError("cookie 必须是字符串或字典") + cookies.update(cookie) + self.options = { + "cookie": dict(cookies), + "timeout": self.timeout, + "proxies": dict(self.proxies), } + self.session = requests.Session() + self.session.proxies.update(self.proxies) + for name, value in cookies.items(): + self.session.cookies.set(name, str(value), domain="music.163.com", path="/") + self.headers = {"User-Agent": "Mozilla/5.0", "Referer": "https://music.163.com/"} + self._closed = False + + def __enter__(self): + return self - def send(self, url, param={}, method=''): - return query.post(url, - self.headers, - encrypt.encrypted_request(param, method)) + def __exit__(self, *args): + self.close() + + def close(self): + self.session.close() + self._closed = True + + def send(self, url, param=None, method=""): + if self._closed: + raise RuntimeError("Client 已关闭") + if url.startswith("/"): + url = "https://music.163.com" + url + params = dict(param or {}) + params.setdefault("csrf_token", self.options["cookie"].get("__csrf", "")) + try: + return query.post( + url, + self.headers, + encrypt.encrypted_request(params, method), + session=self.session, + timeout=self.timeout, + ) + finally: + # Preserve server-issued session cookies for lazy requests on returned objects. + self.options["cookie"].update( + { + cookie.name: cookie.value + for cookie in self.session.cookies + if cookie.domain.lstrip(".") == "music.163.com" + } + ) def get_song_url(self, para): - url = "https://music.163.com/weapi/song/enhance/player/url/v1" - param = dict(ids=para["ID"], level=para["level"], encodeType="aac") - return self.send(url, param) + return self.send( + "/weapi/song/enhance/player/url/v1", + { + "ids": para["ID"], + "level": para["level"], + "encodeType": "aac", + }, + ) def search(self, para): - url = "https://music.163.com/weapi/cloudsearch/get/web" - param = '{"hlpretag":"","hlposttag":"","s":"' + \ - para["string"] + '","type":"1","offset":"0","total":"true","limit":"' + \ - para["number"] + '","csrf_token":""}' - return self.send(url, param) + return self.send( + "/weapi/search/get", + { + "s": para["string"], + "type": 1, + "offset": para.get("offset", 0), + "limit": para["number"], + }, + ) def get_commets(self, para): - url = "https://music.163.com/weapi/v1/resource/comments/R_SO_4_{}".format( - para["ID"]) - param = '{"rid":"R_SO_4_' + para["ID"] + '","offset":"' + para["offset"] + \ - '","total":"' + para["total"] + '","limit":"' + \ - para["limit"] + '","csrf_token":""}' - return self.send(url, param) + # Retain the historical internal spelling for integrations using Api. + return self.send( + "/weapi/v1/resource/comments/R_SO_4_{}".format(para["ID"]), + { + "rid": str(para["ID"]), + "offset": para.get("offset", 0), + "beforeTime": 0, + "limit": para.get("limit", 20), + }, + ) + + def get_comment_page(self, para): + return self.send( + "/weapi/v2/resource/comments", + { + "threadId": "R_SO_4_{}".format(para["ID"]), + "pageNo": para["page"], + "pageSize": para["limit"], + "sortType": 3, + "cursor": para["cursor"], + "showInner": True, + }, + ) def get_lyrics(self, para): - url = "https://music.163.com/weapi/song/lyric" - param = '{"id":"' + para["ID"] + '","lv":-1,"tv":-1,"csrf_token":""}' - return self.send(url, param) + return self.send("/weapi/song/lyric", {"id": para["ID"], "lv": -1, "tv": -1}) def get_song_detail(self, para): - url = "https://music.163.com/weapi/v3/song/detail" - param = dict(c=json.dumps( - [{"id": _id} for _id in para["ID"]]), ids=json.dumps(para["ID"])) - return self.send(url, param) + return self.send( + "/weapi/v3/song/detail", + { + "c": json.dumps([{"id": value} for value in para["ID"]]), + "ids": json.dumps(para["ID"]), + }, + ) - # 是个让人脑阔疼的api def get_playlist(self, para, method=""): - url = "http://music.163.com/api/v3/playlist/detail" - param = dict(id=para["ID"], total="true", limit=1000, n=1000, offest=0) - return self.send(url, param, method=para["method"]) + return self.send("/weapi/v6/playlist/detail", {"id": para["ID"], "n": 100000, "s": 8}) def get_album(self, para): - url = "https://music.163.com/weapi/v1/album/{}".format(para["ID"]) - return self.send(url) + return self.send("/weapi/v1/album/{}".format(para["ID"])) def get_userInfo(self, para): - url = "https://music.163.com/api/v1/user/detail/{}".format(para["ID"]) - return self.send(url) + return self.send("/weapi/v1/user/detail/{}".format(para["ID"])) def get_userPlayerlist(self, para): - url = "https://music.163.com/weapi/user/playlist" - params = dict(uid=para["ID"], wordwrap=7, - offset=0, total="true", limit=1000) - return self.send(url, params) + return self.send( + "/weapi/user/playlist", + { + "uid": para["ID"], + "offset": para.get("offset", 0), + "limit": para.get("limit", 100), + }, + ) def get_userRecord(self, para): - url = "https://music.163.com/weapi/v1/play/record" - params = dict(uid=para["ID"], type=-1, - limit=1000, offset=0, total="true") - return self.send(url, params) + return self.send("/weapi/v1/play/record", {"uid": para["ID"], "type": para.get("type", 0)}) diff --git a/cloudmusic/cloudmusic.py b/cloudmusic/cloudmusic.py index 93934b7..35c32d9 100644 --- a/cloudmusic/cloudmusic.py +++ b/cloudmusic/cloudmusic.py @@ -1,36 +1,43 @@ -from . import sessions +"""Convenience functions; use Client for explicit configuration and connection reuse.""" + +from .sessions import Session as Client def getMusic(para): - with sessions.Session() as session: - return session.request("song", para) + with Client() as client: + return client.getMusic(para) def getPlaylist(para): - with sessions.Session() as session: - return session.request("playlist", para) + with Client() as client: + return client.getPlaylist(para) def getAlbum(para): - with sessions.Session() as session: - return session.request("album", para) + with Client() as client: + return client.getAlbum(para) def search(para, number=5): - with sessions.Session() as session: - return session.search(para, number) + with Client() as client: + return client.search(para, number) def createLoader(procs=2, dirs=""): - with sessions.Session() as session: - return session.downloader(procs, dirs) + from .download import Downloader + + return Downloader(procs, dirs) def getUser(para): - with sessions.Session() as session: - return session.request("user", para) + with Client() as client: + return client.getUser(para) def help(): - print("这是帮助") - + print( + "cloudmusic: getMusic(id 或 id 列表), getPlaylist(id), getAlbum(id), " + "search(关键词, number=5), getUser(id), createLoader(procs=2, dirs='')。\n" + "使用 Client(cookie=..., timeout=(5, 20), proxies=...) 配置会话。\n" + "文档：https://github.com/p697/cloudmusic#readme" + ) diff --git a/cloudmusic/download.py b/cloudmusic/download.py index 3f6893b..f0c36e6 100644 --- a/cloudmusic/download.py +++ b/cloudmusic/download.py @@ -1,94 +1,116 @@ -from . import musicObj +"""Cross-platform, streamed and atomic downloads.""" -import urllib import os -import threadpool -import time - - - -def download(dirs, music): - if len(music.artist) == 1: - artist = music.artist[0] - else: - artist = "" - for ar in music.artist: - artist += ar + " " - name = music.name + " - " + artist + "." + music.type - - if not dirs: - dirs = "cloudmusic\\" + name - defalut_dirs = str(os.getcwd()) + '\\cloudmusic' - isExist = os.path.exists(defalut_dirs) - if not isExist: - os.makedirs(defalut_dirs) - else : - dirs += "\\" + name - - # 超时重连 - for t in range(5): - try: - resp = urllib.request.urlopen(music.url, timeout=5) - respHtml = resp.read() - break - except Exception as e: - if t == 4: - print("download failed - " + music.id) - return None - print("Error: " + str(e) + " - " + "reconnect time: " + str(t)) - time.sleep(1) - - - binfile = open(dirs, "wb") - binfile.write(respHtml) - binfile.close() - - print("dowload finish - " + music.id) - - return str(os.getcwd()) + dirs - - -class Downloader(): - def __init__(self, procs, dirs): - self.data = [] - self.dirs = dirs - self.procs = procs - - def start(self): - if not self.data: - print("data 为空") - return None - print("processing...") - - func_var = [] - for music in self.data: - if not isinstance(music, musicObj.Music): - print(str(music) + "is not Music object") - return None - var = [self.dirs, music] - func_var.append((var, None)) - - pool = threadpool.ThreadPool(self.procs) - requests = threadpool.makeRequests(download, func_var) - [pool.putRequest(req) for req in requests] - pool.wait() - - return self.dirs - - - - - # pool = multiprocessing.Pool(self.procs) - # for music in self.data: - # if not isinstance(music, musicObj.Music): - # print(str(music) + "is not Music object") - # continue - # pool.apply_async(download, (self.dirs, music)) - # pool.close() - # pool.join() - # print("finish!") - - - - - +import re +import tempfile +from concurrent.futures import ThreadPoolExecutor, as_completed +from pathlib import Path + +import requests + +from .exceptions import DownloadError, UnavailableError +from .validation import integer + + +def _filename(music, audio_type): + extension = str(audio_type or "").lower() + if not re.fullmatch(r"[a-z0-9]{1,8}", extension): + raise DownloadError("音频文件类型无效") + name = "{} - {}".format(music.name, " ".join(music.artist)) + name = re.sub(r'[<>:"/\\|?*\x00-\x1f]', "_", name).strip(" .") or music.id + reserved = {"CON", "PRN", "AUX", "NUL"} | { + prefix + str(i) for prefix in ("COM", "LPT") for i in range(1, 10) + } + if name.split(".")[0].upper() in reserved: + name = "_" + name + # Bound UTF-8 bytes as well as character length for macOS/Linux filenames. + name = name.encode("utf-8")[:180].decode("utf-8", errors="ignore").rstrip(" .") + return "{}.{}".format(name, extension) + + +def download(dirs, music, *, audio=None): + audio = audio if audio is not None else music._playback.get(music.id) + url = audio.get("url") + if not url: + raise UnavailableError("当前账号或地区无法获取音频：{}".format(music.id)) + if not isinstance(url, str) or not url.startswith(("https://", "http://")): + raise DownloadError("音频地址必须是 HTTP 或 HTTPS") + temporary = None + options = music._options + try: + target_dir = Path(dirs or "cloudmusic").expanduser().resolve() + target = target_dir / _filename(music, audio.get("type")) + target_dir.mkdir(parents=True, exist_ok=True) + # Never forward account cookies to a CDN or to a redirect destination. + with requests.Session() as session: + session.proxies.update(options.get("proxies") or {}) + session.headers["User-Agent"] = "Mozilla/5.0" + with session.get(url, stream=True, timeout=options.get("timeout", (5, 20))) as response: + response.raise_for_status() + content_type = response.headers.get("Content-Type", "").lower() + if "text/" in content_type or "json" in content_type: + raise DownloadError("下载地址返回了错误页面，未覆盖目标文件") + received = 0 + with tempfile.NamedTemporaryFile( + dir=target_dir, prefix=".cloudmusic-", suffix=".part", delete=False + ) as handle: + temporary = Path(handle.name) + for chunk in response.iter_content(chunk_size=64 * 1024): + if chunk: + handle.write(chunk) + received += len(chunk) + length = response.headers.get("Content-Length") + try: + expected = int(length) if length is not None else None + except ValueError: + raise DownloadError("音频响应的 Content-Length 无效") from None + if not received or ( + length and not response.headers.get("Content-Encoding") and received != expected + ): + raise DownloadError("音频下载不完整，未覆盖目标文件") + os.replace(temporary, target) + temporary = None + return str(target) + except requests.RequestException as exc: + raise DownloadError("音频下载失败或超时，未覆盖目标文件") from exc + except OSError as exc: + raise DownloadError("音频文件写入失败，请检查目录权限和剩余空间") from exc + finally: + if temporary is not None: + temporary.unlink(missing_ok=True) + + +class Downloader: + def __init__(self, procs=2, dirs=""): + self.data = [] + self.dirs = dirs + self.procs = integer(procs, "procs", 1) + self.results = [] + self.errors = {} + + def start(self): + from .musicObj import Music + + if any(not isinstance(music, Music) for music in self.data): + raise ValueError("data 中的每一项必须是 Music 对象") + self.results, self.errors = [], {} + with ThreadPoolExecutor(max_workers=min(self.procs, 32)) as pool: + futures = { + pool.submit(music.download, self.dirs): index + for index, music in enumerate(self.data) + } + completed = {} + for future in as_completed(futures): + index = futures[future] + try: + completed[index] = future.result() + except Exception as exc: + self.errors[index] = exc + self.results = [completed[index] for index in sorted(completed)] + if self.errors: + raise DownloadError( + "{} 首歌曲下载失败；详见 loader.errors，成功文件见 loader.results".format( + len(self.errors) + ) + ) + return str(Path(self.dirs or "cloudmusic").expanduser().resolve()) diff --git a/cloudmusic/encrypt.py b/cloudmusic/encrypt.py index 8f014fb..2c3c354 100644 --- a/cloudmusic/encrypt.py +++ b/cloudmusic/encrypt.py @@ -14,11 +14,13 @@ PUBKEY = "010001" NONCE = b"0CoJUm6Qyw8W8jud" -def encrypted_request(text={}, method=''): - # type: (str) -> dict - if method == 'linux': + +def encrypted_request(text=None, method=""): + text = {} if text is None else text + if method == "linux": return linuxEncrypt(text) - text = str(text) + if not isinstance(text, str): + text = json.dumps(text, ensure_ascii=False, separators=(",", ":")) data = text.encode("utf-8") secret = create_key(16) params = aes(aes(data, NONCE), secret) @@ -44,8 +46,5 @@ def create_key(size): return binascii.hexlify(os.urandom(size))[:16] -def linuxEncrypt(text={}): - # print(text) - return text - - +def linuxEncrypt(text=None): + return {} if text is None else text diff --git a/cloudmusic/exceptions.py b/cloudmusic/exceptions.py new file mode 100644 index 0000000..0050362 --- /dev/null +++ b/cloudmusic/exceptions.py @@ -0,0 +1,44 @@ +"""Errors callers can handle without depending on an upstream response shape.""" + + +class CloudMusicError(Exception): + """Base class for service and download errors.""" + + +class RequestError(CloudMusicError): + def __init__(self, message, status_code=None): + self.status_code = status_code + super().__init__(message) + + +class APIError(CloudMusicError): + def __init__(self, code, message=""): + self.code = code + self.message = message or "网易云接口拒绝了请求" + super().__init__("{} (code={})".format(self.message, code)) + + +class ResponseError(CloudMusicError): + """The service returned an unexpected or malformed response.""" + + +class NotFoundError(CloudMusicError): + def __init__(self, ids): + self.ids = list(ids) + super().__init__("未找到歌曲或用户：{}".format(", ".join(map(str, self.ids)))) + + +class UnavailableError(CloudMusicError): + """An audio file is unavailable for the current account or region.""" + + +class IncompleteResultError(CloudMusicError): + def __init__(self, message, partial_result, expected_count=None): + self.partial_result = partial_result + self.expected_count = expected_count + self.actual_count = len(partial_result) + super().__init__(message) + + +class DownloadError(CloudMusicError): + pass diff --git a/cloudmusic/musicObj.py b/cloudmusic/musicObj.py index 65d0c10..066fc69 100644 --- a/cloudmusic/musicObj.py +++ b/cloudmusic/musicObj.py @@ -1,118 +1,197 @@ -from . import download -from . import sessions -from . import api - -import re - - - -def createObj(ids, level): - api = sessions.api.Api() - musicUrl = api.get_song_url(dict(ID = ids, level = level))['data'] - musicInfo = api.get_song_detail(dict(ID = ids))['songs'] - musicOtp = [] - for i in range(len(ids)): - mu = musicUrl[i] - for mi in musicInfo: - if mi['id'] == mu['id']: - name = mi['name'] + " " + mi['alia'][0] if mi['alia'] else mi['name'] - artist = [ar['name'] for ar in mi['ar']] - artistId = [ar['id'] for ar in mi['ar']] - album = mi['al']['name'] - albumId = mi['al']['id'] - picUrl = mi['al']['picUrl'] - info = dict(name = name, artist = artist, album = album, picUrl = picUrl, artistId = artistId, albumId = albumId) - musicInfo.remove(mi) - break - musicOtp.append(Music(mu["id"], mu["url"], mu["level"], mu["size"], mu["type"], info)) - if len(musicUrl) == 1: - return musicOtp[0] - return musicOtp - - # musicOtp = [] - # info = {"name": "","artist": "","album": ""} - # musicOtp = [] - # for d in data: - # # if detail: - # # info = query.getSongInfo(d["id"]) - # # if not info: - # # print("歌曲不存在 id=" + str(d["id"])) - # # continue - # musicOtp.append(Music(d["id"], d["url"], d["level"], d["size"], d["type"], info)) - # if len(data) == 1: - # return musicOtp[0] - +"""Song metadata with lazy, batched audio lookup.""" +import threading +import time +from .api import Api +from .exceptions import APIError, NotFoundError, UnavailableError +from .validation import field -class Music: - def __init__(self, id_, url, level, size, type_, info): - self.url = url - self.id = str(id_) +LEVELS = ("standard", "higher", "exhigh", "lossless") +BATCH_SIZE = 200 + + +def validate_level(level): + if level not in LEVELS: + raise ValueError("level 必须是 {}".format(", ".join(LEVELS))) + return level + + +class _PlaybackBatch: + def __init__(self, ids, level, options, data=None): + self.ids = ids self.level = level - self.size = int(size) - self.type = type_ - self.name = info['name'] - self.artist = info['artist'] - self.album = info['album'] - self.artistId = info['artistId'] - self.albumId = info['albumId'] - self.picUrl = info['picUrl'] - self.para = { - "clas" : "", - "ID" : self.id, - "number" : 15, - "offset" : 0, - } - self.levels = ["standard", "higher", "exhigh", "lossless"] + self.options = options + self._data = data + self._loaded_at = time.monotonic() if data is not None else 0 + self._blocked = None + self._blocked_at = 0 + self._lock = threading.Lock() + + def get(self, song_id): + with self._lock: + if self._blocked and time.monotonic() - self._blocked_at < 60: + raise APIError(*self._blocked) + # Avoid retaining expired CDN URLs in long-running scripts. + if self._data is None or time.monotonic() - self._loaded_at >= 60: + try: + with Api(**self.options) as api: + rows = field( + api.get_song_url({"ID": self.ids, "level": self.level}), "data", list + ) + except APIError as exc: + if exc.code in (-460, -462, 301, 401, 403, 429): + self._blocked = (exc.code, exc.message) + self._blocked_at = time.monotonic() + raise + self._data = {str(field(row, "id", int)): row for row in rows} + self._loaded_at = time.monotonic() + self._blocked = None + return self._data.get(str(song_id), {}) + + +def createObj(ids, level="higher", *, api=None, options=None, details=None): + """Always return a list, in input order, including repeated IDs.""" + validate_level(level) + if not ids: + return [] + if api is None: + with Api(**(options or {})) as owned: + return createObj(ids, level, api=owned, options=owned.options, details=details) + options = options or api.options + known = {field(song, "id", int): song for song in (details or [])} + unique = list(dict.fromkeys(ids)) + missing = [song_id for song_id in unique if song_id not in known] + for offset in range(0, len(missing), BATCH_SIZE): + rows = field( + api.get_song_detail({"ID": missing[offset : offset + BATCH_SIZE]}), "songs", list + ) + known.update({field(song, "id", int): song for song in rows}) + absent = [song_id for song_id in unique if song_id not in known] + if absent: + raise NotFoundError(absent) + songs = {} + for offset in range(0, len(unique), BATCH_SIZE): + batch = unique[offset : offset + BATCH_SIZE] + playback = _PlaybackBatch(batch, level, options) + for song_id in batch: + detail = known[song_id] + album = field(detail, "al", dict) + artists = field(detail, "ar", list) + name = field(detail, "name", str) + aliases = detail.get("alia") or [] + info = { + "name": name + (" " + str(aliases[0]) if aliases else ""), + "artist": [ar.get("name") or "" for ar in artists], + "artistId": [ar.get("id") for ar in artists], + "album": album.get("name") or "", + "albumId": album.get("id"), + "picUrl": album.get("picUrl") or "", + } + songs[song_id] = Music( + song_id, level=level, info=info, options=options, playback=playback + ) + return [songs[song_id] for song_id in ids] + +class Music: + def __init__( + self, + id_, + url=None, + level="higher", + size=0, + type_=None, + info=None, + *, + options=None, + playback=None, + ): + self.id = str(id_) + self._options = options or {} + self._requested_level = level + self._playback = playback or _PlaybackBatch( + [int(id_)], + level, + self._options, + {self.id: {"url": url, "level": level, "size": size, "type": type_}}, + ) + info = info or {} + for key, default in ( + ("name", ""), + ("artist", []), + ("artistId", []), + ("album", ""), + ("albumId", None), + ("picUrl", ""), + ): + setattr(self, key, info.get(key, default)) def __repr__(self): - return "一个功能强大的python库，使用最简单易用的方法获取一切你想要的信息。
-支持python3以上版本
pip install cloudmusic
-music = cloudmusic.getMusic(1347630432) - -print("歌名：{}".format(music.name)) -print("歌手：{}".format(music.artist)) -print("音频文件url：{}".format(music.url)) - -# >>> -# 歌名：白日 日剧《冤罪律师》主题曲 -# 歌手：['King Gnu'] -# 音频文件url：http://m10.music.126.net/.../.mp3 - -
playlist = cloudmusic.getPlaylist(310729011) - -for music in playlist: - music.download(level = "lossless") - -
music = cloudmusic.getMusic(1347630432) - -coms = music.getHotComments() - -for com in coms: - print("发布者：{}".format(com['nickName'])) - print("内容：{}".format(com['content'])) - print("获赞数：{}".format(com['likeCount'])) - print("------------") - -# >>> -# 发布者：Akikonknk -# 内容：特别喜欢日剧的一个原因 大概就是它帮你认清生活的真相之后 依然教会你如何热爱生活 -# 获赞数：19451 -# ------------ -# 发布者：我藏起来啦嘻嘻 -# 内容：最后一集的犯人真的是应证了那一句话“雪崩的时候没有一片雪花是无辜的” -# 获赞数：6690 -# ------------ -# 发布者：Usio叔叔 -# ... - -
results = cloudmusic.search("白日", 100) - -for music in results: - print(music.getCommentsCount()) - -# 5745 -# 77 -# 181 -# 560 -# 368 -# ... - -
download(dirs, level)--dirs：可选。下载保持路径。默认为当前文件夹内创建的新的cloudmusic文件夹。
-
-level：可选，字符型。默认higher。下载品质，有且只有四种选择：standard，higher，exhigh，lossless。
下载歌曲，返回值为下载绝对路径
-getHotComments(number)--number：可选，整型，默认为15。希望获取的评论个数。上限为15个。
-
获取热评。返回值为列表，列表元素为字典，字典内容：
-"likeCount"：获赞数
-"content"：评论内容
-"time"：评论时间
-"userId"：用户id
-"nickNamd"：用户昵称
-"avatarUrl"：用户头像url
-"vipType"：0表示未开通vip，10表示开通音乐包，11表示开通黑胶
-"userType"：0表示普通用户，非0表示特殊用户（明星，丁磊，网红，小秘书等）
getComments(number)--number：整型，评论个数。数量无限制。
-
获取最新的评论。返回值与getHotReview相同。
-getLyrics()获取歌词。返回值为列表。元素1为原始歌词，元素2为翻译歌词。
-getCommentsCount()返回值为整型，本首歌的评论数量。
-getMusic(id/id_list)--id/id_list: 必须，整型、字符型或列表。歌曲id或由歌曲id组成的列表。
-
通过歌曲id或一个由id组成的列表生成music对象。当参数为单个id时返回值为单个music对象，当参数为id列表时返回值为music对象组成的列表。
-getPlaylist(id)--id：必须，整型或字符型。歌单id。
-
通过歌单id生成music对象，参数为歌单id，返回值为歌单内所有歌曲对应music对象组成的列表。
-search(content, number)--content：必须，字符型。搜索关键字。
-
-number：可选，整形，搜索结果个数，默认为5。
通过关键词搜索获取music对象。返回值为music对象组成的列表。
-getAlbum(id)--id: 必须，整型或字符型。专辑id。
-
和getPlaylist一样。
-getPlaylist()获取用户创建和收藏的全部歌单，返回值为一个列表，每个元素是一个歌单信息组成的字典。字典内容：
-id：歌单id；
-name：歌单名称；
-creatorId：创建者id；
-createTime：创建时间；
-coverImgUrl：歌单封面图片url；
-updateTime：歌单最后一次更新时间；
-tags：歌单所属音乐风格，列表形式
getRecord(recordType)--recordType: 可选。默认为0。为0返回所有时间排行，非0返回最近一周排行。
-
获取用户听歌排行，返回一个列表，元素为字典。字典内容：
-score：分值。100表示听歌次数最多，越小越少；
-music：Music对象
getUser(id)--id：必须，用户id。
-
通过用户id获取User对象，返回值为User对象。
-@p697
- -项目已恢复维护。原静态 HTML/PDF 文档对应 0.1.1，当前接口、安装方法和迁移说明请查看仓库文档。
+ + + diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..06b275b --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,46 @@ +[build-system] +requires = ["setuptools>=77"] +build-backend = "setuptools.build_meta" + +[project] +name = "cloudmusic" +dynamic = ["version"] +description = "A small Python client for NetEase Cloud Music" +readme = "README.md" +requires-python = ">=3.10" +license = "MIT" +authors = [{name = "p697"}] +dependencies = ["requests>=2.32.4,<3", "pycryptodomex>=3.23,<4"] +classifiers = [ + "Programming Language :: Python :: 3", + "Programming Language :: Python :: 3.10", + "Programming Language :: Python :: 3.11", + "Programming Language :: Python :: 3.12", + "Programming Language :: Python :: 3.13", + "Programming Language :: Python :: 3.14", +] + +[project.urls] +Homepage = "https://github.com/p697/cloudmusic" +Issues = "https://github.com/p697/cloudmusic/issues" + +[project.optional-dependencies] +test = ["pytest>=8,<10", "pytest-cov>=5,<8", "build>=1.2,<2", "ruff>=0.11,<1"] + +[tool.setuptools.dynamic] +version = {attr = "cloudmusic.__version__.__version__"} + +[tool.setuptools.packages.find] +include = ["cloudmusic*"] + +[tool.pytest.ini_options] +testpaths = ["tests"] +addopts = "-ra" +markers = ["live: opt-in read-only checks against NetEase (requires --live)"] + +[tool.ruff] +target-version = "py310" +line-length = 100 + +[tool.ruff.lint] +select = ["E4", "E7", "E9", "F"] diff --git a/setup.py b/setup.py index d492635..18b7209 100644 --- a/setup.py +++ b/setup.py @@ -1,131 +1,4 @@ -#!/usr/bin/env python -# -*- coding: utf-8 -*- +"""Compatibility entry point; package metadata lives in pyproject.toml.""" +from setuptools import setup -# Note: To use the 'upload' functionality of this file, you must: -# $ pipenv install twine --dev - -import io -import os -import sys -from shutil import rmtree - -from setuptools import find_packages, setup, Command - -# Package meta-data. -NAME = 'cloudmusic' -DESCRIPTION = '网易云爬虫解决方案' -URL = 'https://github.com/p697/cloudmusic' -EMAIL = '254139147@qq.com' -AUTHOR = 'p697' -REQUIRES_PYTHON = '>=3.0.0' -VERSION = '0.1.1' - -# What packages are required for this module to be executed? -REQUIRED = [ - 'requests', 'lxml', 'pycryptodomex', 'threadpool' -] - -# What packages are optional? -EXTRAS = { - # 'fancy feature': ['django'], -} - -# The rest you shouldn't have to touch too much :) -# ------------------------------------------------ -# Except, perhaps the License and Trove Classifiers! -# If you do change the License, remember to change the Trove Classifier for that! - -here = os.path.abspath(os.path.dirname(__file__)) - -# Import the README and use it as the long-description. -# Note: this will only work if 'README.md' is present in your MANIFEST.in file! -try: - with io.open(os.path.join(here, 'README.md'), encoding='utf-8') as f: - long_description = '\n' + f.read() -except FileNotFoundError: - long_description = DESCRIPTION - -# Load the package's __version__.py module as a dictionary. -about = {} -if not VERSION: - project_slug = NAME.lower().replace("-", "_").replace(" ", "_") - with open(os.path.join(here, project_slug, '__version__.py')) as f: - exec(f.read(), about) -else: - about['__version__'] = VERSION - - -class UploadCommand(Command): - """Support setup.py upload.""" - - description = 'Build and publish the package.' - user_options = [] - - @staticmethod - def status(s): - """Prints things in bold.""" - print('\033[1m{0}\033[0m'.format(s)) - - def initialize_options(self): - pass - - def finalize_options(self): - pass - - def run(self): - try: - self.status('Removing previous builds…') - rmtree(os.path.join(here, 'dist')) - except OSError: - pass - - self.status('Building Source and Wheel (universal) distribution…') - os.system('{0} setup.py sdist bdist_wheel --universal'.format(sys.executable)) - - self.status('Uploading the package to PyPI via Twine…') - os.system('twine upload dist/*') - - self.status('Pushing git tags…') - os.system('git tag v{0}'.format(about['__version__'])) - os.system('git push --tags') - - sys.exit() - - -# Where the magic happens: -setup( - name=NAME, - version=about['__version__'], - description=DESCRIPTION, - long_description=long_description, - long_description_content_type='text/markdown', - author=AUTHOR, - author_email=EMAIL, - python_requires=REQUIRES_PYTHON, - url=URL, - packages=find_packages(exclude=["tests", "*.tests", "*.tests.*", "tests.*"]), - # If your package is a single module, use this instead of 'packages': - # py_modules=['mypackage'], - - # entry_points={ - # 'console_scripts': ['mycli=mymodule:cli'], - # }, - install_requires=REQUIRED, - extras_require=EXTRAS, - include_package_data=True, - license='MIT', - classifiers=[ - # Trove classifiers - # Full list: https://pypi.python.org/pypi?%3Aaction=list_classifiers - 'License :: OSI Approved :: MIT License', - 'Programming Language :: Python', - 'Programming Language :: Python :: 3', - 'Programming Language :: Python :: 3.6', - 'Programming Language :: Python :: Implementation :: CPython', - 'Programming Language :: Python :: Implementation :: PyPy' - ], - # $ setup.py publish support. - cmdclass={ - 'upload': UploadCommand, - }, -) +setup() diff --git a/test.py b/test.py index f1a1b65..37e353c 100644 --- a/test.py +++ b/test.py @@ -1,53 +1,11 @@ -import cloudmusic -import time -import re -import urllib.request - -# playlist = api.getSong(445702291) -# 601776277 是我的一个歌单id -# print(playlist) -# [