Archived
snowy-yang
65adfc9089
core/aiohttp_compat 是「同步转异步」迁移期的 requests 同形异步垫片：它存在的 唯一理由是让既有 `requests.post/get + raise_for_status()` 风格的代码以最小 改动迁到异步。其两个调用方（music_api/api.py、music_api/client.py）**本就已是 async def**——垫片只剩「保留 requests 语义」这一层包装，属于迁移残留。 改动： - api.py：23 处 requests.post/get → await core.http_client.request()。 该文件每处都在请求后立刻 raise_for_status() 才取 .json()，从不把 4xx 当数据读， 故「_once 对非 2xx 直接抛 UpstreamHTTPError」与旧语义等价（原 raise_for_status 抛的 HTTPError 也一律落入 RequestException 分支）； except requests.RequestException → except UpstreamError。 - client.py：两个自管重试的方法改用新公开的 core.http_client.request_once() （单次、不重试），保留原有「5xx 退避重试一次 / 4xx 立即失败」的分流—— 把 status_code>=500 的判断换成 UpstreamHTTPError.status，行为逐条对齐 （4xx=风控不重试，网络/5xx 重试一次）。响应体上限交由客户端 max_bytes 统一把关。 post_request_full 返回类型改为 HTTPResult（qr.py 用到的 .text/.cookies/.headers 三者在 HTTPResult 上齐备）。 - core/http_client：_once 更名并公开为 request_once（自管重试的调用方需要它）。 注：这是为「删垫片」而补的唯一一个小口子，不是新增抽象。 注意一处**有意的行为变化**：api.py 原经垫片请求零重试，现在 request() 自带 「网络异常/5xx 退避重试一次、4xx 不重试」（core.http_client 既定口径）。 429/460 属 4xx 不重试，不加剧风控。 - 删除 core/aiohttp_compat.py；web/app.py 去掉其 close()；pyproject 去掉其 per-file-ignore；core/http_errors.py 注释更正为「仅供 core.sync_http」。 - 测试：test_aiohttp_compat.py 拆解为 test_async_bridge.py（只留桥的两条契约， 垫片自身的 4 条随垫片消亡）；test_search_music / test_playlist_detail 的替身 边界从 api.requests.post 换成 api._http.request，异常类型换成 UpstreamNetworkError。 门禁：ruff 全过 / pyright 0-0 / pytest 383 项全绿（0 失败；383=387-6+2，账面吻合）。
64 lines
1.2 KiB
Python
64 lines
1.2 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""网易云音乐API模块
|
|
|
|
提供网易云音乐相关API接口的封装，包括：
|
|
- 音乐URL获取
|
|
- 歌曲详情获取
|
|
- 歌词获取
|
|
- 搜索功能
|
|
- 歌单和专辑详情
|
|
- 二维码登录
|
|
"""
|
|
|
|
# 兼容门面：实现已按职责拆分到同包各子模块，此处原样再导出。
|
|
# 用 `__all__` 声明再导出（ruff F401 与 pyright 均据此认定「有意再导出」），
|
|
# 使既有调用点（music_api.xxx / from music_api import Y）零改动。
|
|
|
|
from .api import (
|
|
NeteaseAPI,
|
|
)
|
|
from .client import (
|
|
HTTPClient,
|
|
_as_dict,
|
|
_ensure_dict,
|
|
)
|
|
from .compat import (
|
|
url_v1,
|
|
)
|
|
from .constants import (
|
|
APIConstants,
|
|
QualityLevel,
|
|
)
|
|
from .cookies import (
|
|
DEFAULT_COOKIE_FILE,
|
|
load_cookies,
|
|
parse_cookie_string,
|
|
)
|
|
from .crypto import (
|
|
CryptoUtils,
|
|
WeapiCrypto,
|
|
)
|
|
from .errors import (
|
|
APIException,
|
|
)
|
|
from .qr import (
|
|
QRLoginManager,
|
|
)
|
|
|
|
__all__ = [
|
|
'DEFAULT_COOKIE_FILE',
|
|
'APIConstants',
|
|
'APIException',
|
|
'CryptoUtils',
|
|
'HTTPClient',
|
|
'NeteaseAPI',
|
|
'QRLoginManager',
|
|
'QualityLevel',
|
|
'WeapiCrypto',
|
|
'_as_dict',
|
|
'_ensure_dict',
|
|
'load_cookies',
|
|
'parse_cookie_string',
|
|
'url_v1',
|
|
]
|