测试体系与回归验证指南 (Testing Guide)

本项目拥有完备的多层级测试体系，涵盖单元测试 (Unit Tests)、API 契约测试 (Contract Tests)、真实网络样本回归 (Live Regression Tests) 以及 交互式手动验证工具。

🧪 测试套件分层

tests/
├── test_api_contract.py            # API 统一契约与错误码断言测试
├── test_api_video_compat.py        # 兼容性测试
├── test_parser_factory.py          # 解析器自动注册与工厂路由测试
├── test_web_fetcher.py             # 302跳转与URL正则提取测试
├── test_*_parser.py                # 各平台专属的单元测试
├── live_parser_samples.json        # 真实线上验证样本库 (50 平台活跃样例，300+ 用例)
├── test_live_parser_samples.py     # 自动化执行样本库回归测试
└── manual_verify_parsers.py        # 命令行交互式/全量人工排查脚本

🚀 常用测试命令

1. 运行所有基础单元测试

用于日常开发与 CI 流程，速度极快（使用 Mock 或本地逻辑）：

pytest

2. 运行指定平台的测试

调试某个特定解析器时使用：

# 测试抖音解析器
pytest tests/test_douyin_parser.py -v

# 测试小红书解析器
pytest tests/test_xiaohongshu_parser.py -v

# 测试 B 站解析器
pytest tests/test_bilibili_parser.py -v

3. 运行真实线上样例回归测试 (Live Tests)

通过 tests/live_parser_samples.json 中的真实链接，发起实际网络请求测试各大平台的可用性：

pytest tests/test_live_parser_samples.py -s

4. 运行交互式真实样本回归验证工具

tests/manual_verify_parsers.py 支持对 50 个平台的多种形态（短链、长链、视频、图集等）发起真实网络请求与字段契约校验：

# 1. 快速冒烟测试 (每个平台只测 1 条最具代表性的链接，极速完成 50 平台基准健康检查)
python3 tests/manual_verify_parsers.py --limit 1

# 2. 验证指定平台的多形态覆盖 (支持重复传入多个 --platform 参数)
python3 tests/manual_verify_parsers.py --platform 微博 --platform 哔哩哔哩 --platform 虎牙

# 3. 限制指定平台的测试用例数量 (例如每个平台最多测 2 条)
python3 tests/manual_verify_parsers.py --platform 抖音 --platform 小红书 --limit 2

# 4. 全量深度回归测试 (运行 300+ 条全部多形态真实用例，适合发版前全量巡检)
python3 tests/manual_verify_parsers.py

# 5. 列出当前用例库中未配置真实链接的平台
python3 tests/manual_verify_parsers.py --list-missing

📝 如何为新平台添加测试用例？

当你开发了一个新的解析器（例如 NewPlatformParser）时，请按以下两步补齐测试：

步骤 1：添加专属单元测试 (`tests/test_newplatform_parser.py`)

import pytest
from src.parsers.newplatform_parser import NewPlatformParser

def test_newplatform_parser_success(monkeypatch):
    # 构造假数据或测试实例
    parser = NewPlatformParser("https://example.com/item/12345")
    assert parser.get_title_content() is not None

步骤 2：在 `tests/live_parser_samples.json` 登记真实测试样例

{
  "platform": "新平台",
  "url": "https://example.com/share/xxxx",
  "media_types": ["video"],
  "expected_fields": ["video", "cover", "title", "author"],
  "note": "2026-08-29 已验证"
}

登记后，自动化回归测试脚本将自动纳入该平台的持续健康检查。

FilesExpand file tree

testing.md

Latest commit

History