5ab4bef80e
交付:
· 产物按变体命名: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>
129 lines
4.7 KiB
Python
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"
|