pyperformance-suite-run

pyperformance Suite Run

负责正式 pyperformance 运行。单 benchmark 调试先用 pyperformance-worker-run。

三类测试边界

• RuntimeTests 是功能测试。
• test_cinderx/lib test 是集成测试。
• pyperformance 是性能测试；正式性能测试前必须说明功能测试和集成测试是否已通过、跳过或仍待验证。

使用场景

• L3 相关子集
• L4 full 全量性能验证
• baseline/candidate 正式对照
• 生成 run.json

规则

• 用 python -m pyperformance run。
• 运行前必须读取 ../using-cpython-optimize/references/pyperformance-env-contract.md，先列出 driver env、--inherit-environ、worker env 和 baseline/candidate 差异轴。
• 使用 --affinity 前必须读取 ../using-cpython-optimize/references/pyperformance-affinity-guidance.md，说明它是 CPU 绑核参数；先检查当前可用 CPU，再把用户真实命令中的 affinity 映射到当前环境，不要逐字照抄不可用核号。
• CinderX JIT 口径必须证明真实 worker 启用 JIT：检查 CinderX .pth、worker pyvenv.cfg / include-system-site-packages 或等价 PYTHONPATH、worker 内 import cinderx / _cinderx、cinderx.__file__、cinderx.get_import_error() 和 cinderx.is_initialized()。
• 正式非 debug 命令形态必须包含 --affinity、--warmup、-b <benchmark-selector>（subset 时）、-o <result.json> 和 --inherit-environ。
• --affinity 必须落在当前 nproc / lscpu / taskset -pc $$ / 容器 cpuset 显示的可用 CPU 内；高核号不可用时，重分配可用 CPU 并记录原始 affinity -> 实际 affinity。
• --inherit-environ 至少覆盖代理、LD_LIBRARY_PATH、PYTHONPATH、插件开关和 JIT 关键变量。
• 若 validation-skill-router deny 了 pyperformance 命令，不要把它当测试失败；先补齐 pyperformance-env-contract.md 要求的 worker venv / .pth / --inherit-environ / JIT 初始化证据，再用 CPYTHON_OPTIMIZE_HOOK_ACK=1 前缀重试同一条正式命令。
• 不能在未完成前置证据时提前加 CPYTHON_OPTIMIZE_HOOK_ACK=1 绕过 hook；ACK 只表示已经完成环境契约检查。
• 记录 warmup、loops、CPU affinity、容器线、Python、CinderX commit。
• 正式数据关闭 HIR/JIT dump、--debug-single-value 和临时诊断变量；这些只用于 L2 调试，不进入正式性能结论。
• subset/full 选择必须来自 validation-strategy 的晋级理由。
• 文档和报告只写 <benchmark-selector>、<result.json>、<baseline.json>、<candidate.json> 等占位，不硬编码具体 pyperformance 用例名或文件名。

命令形态

目标集合正式性能测试：

<env-vars> <python> -m pyperformance run \
  --affinity=<cpu-list-or-set> \
  --warmup <n> \
  -b <benchmark-selector> \
  --inherit-environ <comma-separated-env-list> \
  -o <result.json>