Files
ocr-server/tests/test_release_helpers.py
T
zimoyin 5ab4bef80e build: CPU/GPU 双环境、产物命名与打包修复
交付:
  · 产物按变体命名:CPU -> dist/ocr-server/,GPU -> dist/ocr-server-gpu/。
    变体由构建环境实际装的 paddle 自动判断,不需要人工声明
  · GPU 包额外加 --collect-binaries nvidia。漏收的后果实测是最难查的那种:
    引擎能正常加载、设备也识别成 GPU,但第一次推理才报
    cudnn64_9.dll error 126
  · --copy-metadata 的发行包名随变体变化(paddlepaddle / paddlepaddle-gpu),
    改由 scripts/paddle_env.py 动态取;写死任何一个在另一种环境下都打不出包
  · 新增 scripts/prepare_release_config.py 按变体覆盖发布配置(用 Python 改写
    以保持 UTF-8,PowerShell 的 Set-Content 会把中文注释写坏)

环境:
  · paddle 从 pyproject 依赖里移除,改用 scripts/install_paddle.py 安装。
    它没法写死:CPU/GPU 互斥,GPU 还得按显卡选 CUDA 通道(RTX 50 系必须 cu129)。
    钉死 CPU 版时,uv sync / uv run / PyCharm 自动同步都会把装好的
    paddlepaddle-gpu 静默挤掉、服务悄悄退回 CPU(实测踩过三次)
  · 新增 scripts/switch_env.py:.venv(CPU)与 .venv-gpu(GPU)两套环境共存,
    切换零成本;所有 uv run 补 --no-sync,打包改用 uv sync --inexact
  · 预置模型扩到 8 套(v4/v5 × 服务端/移动端 × 检测/识别,约 398MB)

其它:
  · scripts/start.* 先找发布包再退回源码环境;入口脚本名固定是 ocr-server
  · benchmark_ocr.py 输出 segments 与 chars,换设备/模型时可直接比对召回
  · .gitignore 覆盖 .venv-gpu/ 与 dist*/

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-14 03:53:48 +08:00

129 lines
4.7 KiB
Python

"""打包辅助脚本的回归测试(config 改写与 paddle 变体探测)。"""
import subprocess
import sys
from pathlib import Path
PROJECT_ROOT = Path(__file__).resolve().parents[1]
PREPARE_CONFIG = PROJECT_ROOT / "scripts" / "prepare_release_config.py"
PADDLE_ENV = PROJECT_ROOT / "scripts" / "paddle_env.py"
INSTALL_PADDLE = PROJECT_ROOT / "scripts" / "install_paddle.py"
SWITCH_ENV = PROJECT_ROOT / "scripts" / "switch_env.py"
SAMPLE = """\
# 中文注释必须原样保留
host: 127.0.0.1
device: cpu
text_recognition_batch_size: 32
"""
def run_script(script: Path, *args: str) -> subprocess.CompletedProcess[str]:
return subprocess.run(
[sys.executable, str(script), *args],
capture_output=True,
text=True,
encoding="utf-8",
cwd=PROJECT_ROOT,
check=False,
)
def test_prepare_release_config_overrides_device(tmp_path: Path) -> None:
source = tmp_path / "config.yaml"
source.write_text(SAMPLE, encoding="utf-8")
target = tmp_path / "release" / "config.yaml"
result = run_script(PREPARE_CONFIG, str(source), str(target), "device=gpu")
assert result.returncode == 0, result.stderr
written = target.read_text(encoding="utf-8")
assert "device: gpu" in written
assert "device: cpu" not in written
# 未被覆盖的项和中文注释都要原样保留(PowerShell 的默认编码会把中文写坏)。
assert "text_recognition_batch_size: 32" in written
assert "# 中文注释必须原样保留" in written
def test_prepare_release_config_appends_missing_key(tmp_path: Path) -> None:
source = tmp_path / "config.yaml"
source.write_text(SAMPLE.replace("device: cpu\n", ""), encoding="utf-8")
target = tmp_path / "config.yaml"
result = run_script(PREPARE_CONFIG, str(source), str(target), "device=gpu")
assert result.returncode == 0, result.stderr
assert "device: gpu" in target.read_text(encoding="utf-8")
def test_prepare_release_config_rejects_bad_override(tmp_path: Path) -> None:
source = tmp_path / "config.yaml"
source.write_text(SAMPLE, encoding="utf-8")
result = run_script(PREPARE_CONFIG, str(source), str(tmp_path / "out.yaml"), "device")
assert result.returncode == 2
def test_paddle_env_reports_variant_and_distribution() -> None:
variant = run_script(PADDLE_ENV, "variant")
assert variant.returncode == 0, variant.stderr
assert variant.stdout.strip() in {"cpu", "gpu"}
distribution = run_script(PADDLE_ENV, "distribution")
assert distribution.returncode == 0, distribution.stderr
reported = distribution.stdout.strip()
assert reported in {"paddlepaddle", "paddlepaddle-gpu"}
# 变体和发行包名必须一致,否则打包时 --copy-metadata 会取错。
expected = "paddlepaddle-gpu" if variant.stdout.strip() == "gpu" else "paddlepaddle"
assert reported == expected
def test_paddle_env_rejects_unknown_mode() -> None:
assert run_script(PADDLE_ENV, "whatever").returncode == 2
def test_install_paddle_dry_run_never_touches_environment() -> None:
"""--dry-run 只打印方案,不能真的去装东西。"""
result = run_script(INSTALL_PADDLE, "--dry-run")
assert result.returncode == 0, result.stderr
assert "[dry-run]" in result.stdout
assert "paddlepaddle" in result.stdout
def test_install_paddle_auto_picks_gpu_channel_for_rtx50() -> None:
"""RTX 50 系(Blackwell sm_120)必须走 cu129,否则推理时报 Mismatched GPU Architecture。"""
result = run_script(INSTALL_PADDLE, "--gpu", "--dry-run")
assert result.returncode == 0, result.stderr
assert "paddlepaddle-gpu==" in result.stdout
def test_install_paddle_rejects_unknown_cuda_channel() -> None:
result = run_script(INSTALL_PADDLE, "--gpu", "--cuda", "cu999", "--dry-run")
assert result.returncode == 2
def test_switch_env_list_reports_both_variants() -> None:
"""--list 只读,不能改动任何环境。"""
result = run_script(SWITCH_ENV, "--list")
assert result.returncode == 0, result.stderr
assert ".venv" in result.stdout
assert ".venv-gpu" in result.stdout
def test_switch_env_rejects_cuda_together_with_cpu() -> None:
result = run_script(SWITCH_ENV, "--cpu", "--cuda", "cu126")
assert result.returncode == 2
def test_recommend_cuda_matches_gpu_generation() -> None:
sys.path.insert(0, str(PROJECT_ROOT / "scripts"))
try:
import install_paddle
finally:
sys.path.pop(0)
assert install_paddle.recommend_cuda("NVIDIA GeForce RTX 5060 Laptop GPU") == "cu129"
assert install_paddle.recommend_cuda("NVIDIA GeForce RTX 4090") == "cu126"
assert install_paddle.recommend_cuda("NVIDIA GeForce RTX 3060") == "cu126"
assert install_paddle.recommend_cuda("Tesla T4") == "cu118"
assert install_paddle.recommend_cuda(None) == "cu126"