 snowy-yang
|
133beab492
|
chore: 删除 HTTP 线三个垫片，同步/异步桥接层彻底清零
删 core/sync_http.py（requests 同形同步门面）、core/async_bridge.py（run_sync
同步↔异步桥）、core/http_errors.py（两垫片共用的 requests 同形异常层次），
以及 tests/test_async_bridge.py。
为什么必须一次删完：三者是**自闭环三角**——sync_http 是 async_bridge 与
http_errors 的唯一消费者，删掉任何一个其余两个立刻悬空。前序 B1 把 worker 变成
协程、B2 把 auth_system 迁到 aiosqlite、更早一轮把 music_api 改走
core.http_client 之后，这条链上的生产消费者已归零；http_errors 更是在 B2 之后
只剩 sync_http 一个使用者（此前 sync_http 的 docstring 还提到
models._RetryFromScratch 继承它的 RequestException——B1 已改为继承 Exception）。
删除前的核查（避免误删活代码）：
- run_sync / get_loop / SyncResponse / Session( 全仓零残留引用（只剩
aiohttp.ClientSession，那是真正的客户端，不受影响）。
- 所有 HTTPError 命中都是 core.http_client.UpstreamHTTPError——与
core.http_errors 的 HTTPError **名字像但不是一个东西**，删除时别被 grep 骗。
- requests 早已不是声明依赖、全仓零导入；删掉 http_errors 后连 requests 同形
异常的最后残影也没了。
- core/__init__.py 只有 docstring，无需改动；web/app.py 的 async_bridge.shutdown()
已在 B1 移除。
顺带修正两处过时措辞：tests/test_search_music.py 的错误映射注释
RequestException → UpstreamError（异常层次已换）；pyproject.toml 中 pyright
include 的理由注释 requests→sync_http → requests→aiohttp（去掉已删模块名、
保留原意）。auth_system/geo.py 的历史注释本就是过去时，保持不动。
门禁：ruff 全过 / pyright 0-0-0 / pytest 382 项全绿（0 失败 0 error 0 skipped）。
项数 384→382 是 test_async_bridge.py 两条用例**随被测对象一起删除**的预期减项，
不是跳过或漏跑。data/site.db 读写前后 sha256 一致（a19f5db…6487）。
至此「同步调异步 / 异步桥同步」两类垫片全部拆净：DB 线（B1 worker + B2
auth_system）、HTTP 线（本批）。生产代码里 to_thread 仅剩正当的阻塞卸载
（PBKDF2 / smtplib / 备份文件 IO / ZIP 组装 / rmtree），threading.Event 仅剩
取消与暂停的跨线程置位载体。
|
2026-09-28 20:18:08 +08:00 |
|
|
snowy-yang
|
65adfc9089
|
refactor: 删除 aiohttp_compat 垫片，music_api 改走原生 core.http_client
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，账面吻合）。
|
2026-09-28 19:17:03 +08:00 |
|
|
snowy-yang
|
e00ac14460
|
refactor: search_music 四路映射拆解（101 行 / 圈 32 / 嵌套 6 → 42 行 / 圈 7 / 嵌套 1）
为什么：站内搜索的唯一上游通道，101 行里 if/elif 四路条目映射占了
2/3，错误映射与字段容错口径（歌曲 artists 空缺兜底未知歌手、专辑
不兜底、alias 缺省 '' 等）全埋在分支里，改一路要通读全函数。
拆出（模块级，与既有 _ensure_dict 同风格）：
- _map_song_item / _map_album_item / _map_artist_item / _map_playlist_item
——四路口径原样，docstring 标注各路容错差异
- _SEARCH_RESULT_KEYS + _SEARCH_ITEM_MAPPERS 派发表（未知类型不在表内
→ 空结果，原 if/elif 无 else 行为一致）
- _collect_search_items 统一「取键 → 无 id 跳过 → 映射」
先写测试后动代码：新增 tests/test_search_music.py 12 例，在未改动
实现上跑绿（修正 1 例替身形状：网络异常必须抛垫片自己的
RequestException，aiohttp.ClientError 由 aiohttp_compat 内部翻译，
直接抛底层是不存在的形状）。契约测试不为违反 offset: int 签名的
None 入参背书（防御性 int(offset or 0) 保留，不测）。
门禁：ruff 全过 · pyright 0/0 · pytest 330 passed（319→330）。
|
2026-09-27 09:42:07 +08:00 |
|