36 lines
1.3 KiB
Markdown
36 lines
1.3 KiB
Markdown
# Smokes — How‑To（前提→手順→検証）
|
||
|
||
目的
|
||
- 代表スモークを素早く回して、回帰を検知する。
|
||
|
||
前提
|
||
- リリースビルド済み: `cargo build --release --features llvm`
|
||
- LLVM 18 が導入済み（AOT 経路のとき）
|
||
|
||
手順（推奨ランナー）
|
||
1) LLVM curated
|
||
- 実行: `tools/smokes/curated_llvm.sh [--phi-off]`
|
||
- `--phi-off`: `NYASH_MIR_NO_PHI=1` を有効化し、検証を緩和
|
||
2) PHI 不変条件パリティ
|
||
- 実行: `tools/smokes/curated_phi_invariants.sh`
|
||
- PyVM と llvmlite の stdout/exit code を比較
|
||
|
||
手動スモーク（例）
|
||
- Core (LLVM): `examples/llvm11_core_smoke.nyash`
|
||
- Async (LLVM only):
|
||
- `apps/tests/async-await-min/main.nyash`
|
||
- `apps/tests/async-spawn-instance/main.nyash`
|
||
- `apps/tests/async-await-timeout-fixed/main.nyash`（`NYASH_AWAIT_MAX_MS=100`）
|
||
|
||
アーカイブ（非推奨）
|
||
- `tools/smokes/archive/` に旧ランナー（JIT/Cranelift 時代）が存在
|
||
- `smoke_phase_10_10.sh`, `smoke_vm_jit.sh`, `smoke_async_spawn.sh`, `jit_smoke.sh`, `aot_smoke_cranelift.sh`
|
||
- これらは基本使わず、curated 系を使用
|
||
|
||
便利フラグ
|
||
- `NYASH_LLVM_USE_HARNESS=1`: llvmlite ハーネス経由
|
||
- `NYASH_MIR_NO_PHI=1`, `NYASH_VERIFY_ALLOW_NO_PHI=1`: PHI 無しモード
|
||
|
||
検証
|
||
- 0 で成功、非 0 で失敗（CI 連携可）
|