 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
|
d7d3cfce69
|
refactor: HTTP 垫片异常层次收敛到 core.http_errors 单一来源
为什么：core/aiohttp_compat.py 与 core/sync_http.py 各自定义了一份
RequestException / HTTPError，是**两个不同的类**。调用方在同步段捕获
core.sync_http.HTTPError、异步段抛的却是 core.aiohttp_compat.HTTPError，
两者无继承关系——异常会穿透所有 except 分支，属于隐藏的跨层 bug。
改法：新建 core/http_errors.py 作为唯一定义处（RequestException 基类 +
HTTPError / Timeout / ConnectionError），两个垫片改为从它导入并再导出。
刻意保留 requests 的命名约定（Timeout / ConnectionError 与内置同名，
调用方需带模块前缀引用），已在 docstring 写明，避免后来者误改。
注意：sync_http 补了 __all__ 显式再导出——models._RetryFromScratch 继承它、
tests/test_aria2.py 直接导入它，符号必须保持可导入。
|
2026-09-26 18:53:53 +08:00 |
|
|
snowy-yang
|
8446166120
|
refactor!: uv 管理环境 + 彻底删除技术债（Flask 与 requests 全部移除）
## uv 环境管理
- pyproject.toml 声明 dependencies + [dependency-groups].dev，uv.lock 精确锁定
- 删除 requirements.txt / requirements-fastapi.txt / requirements-dev.txt
- .python-version = 3.12；Dockerfile 改用 uv sync --frozen（可复现构建）
- 新增 jinja2（首页渲染）
## 删除 Flask 技术债
- 从 main.py 用 ast 精确剥离 56 个 Flask 节点（路由/中间件/错误处理/启动），
框架无关的服务层落为 services/runtime.py（MusicAPIService、下载/打包 worker、
任务监控、缓存清扫），零 Flask 依赖
- 删除 main.py（4527 行）与 auth_routes.py（1050 行）
- auth_system.py 移除会话/请求上下文层（login_session/current_user/login_required/
admin_required/_client_ip 等），保留数据与业务层
- 新增 core/net.py（IP 解析）、web/auth_state.py（登录锁定/2FA 票据/发码限流）
- FastAPI 侧改直接依赖 services.runtime，不再 import main
- web/app.py 去掉 Flask fallback；入口默认根路径模式（API_PREFIX 可选）
## 删除 requests 技术债
- 新增 core/sync_http.py：requests 风格的同步门面（底层 aiohttp 连接池，
流式读取经有界队列背压），含 Session/headers/(connect,read) 元组超时兼容
- core/utils、auth_system、podcast_api、music_downloader、services 全部切换
- 实测真实下载 5.2MB 音频完整成功
## 质量门禁归零
- ruff：0 错误（B904 全部修复，不再忽略）
- pyright：0 错误（类型收窄修复）
- pytest：140/140（含 golden 契约回归、root 模式 66 项路径覆盖）
- 真实 uvicorn 启动：/health、/、/static、受保护端鉴权全部正确
新增 tests/golden/responses.json：删除 Flask 前捕获的 32 例响应快照，
FastAPI 逐字段复现——删除巨石后行为回归仍有硬证据。
|
2026-09-26 11:10:17 +08:00 |
|