110 lines
4.1 KiB
Markdown
110 lines
4.1 KiB
Markdown
|
# テスト実行ガイド
|
|||
|
|
|
|||
|
|
## 📁 **テストファイル配置ルール（超重要！）**
|
|||
|
|
|
|||
|
|
⚠️ **ルートディレクトリの汚染防止ルール** ⚠️
|
|||
|
|
```bash
|
|||
|
|
# ❌ 絶対ダメ：ルートで実行
|
|||
|
|
./target/release/nyash test.nyash # ログがルートに散乱！
|
|||
|
|
cargo test > test_output.txt # 出力ファイルがルートに！
|
|||
|
|
|
|||
|
|
# ✅ 正しい方法：必ずディレクトリを使う
|
|||
|
|
cd local_tests && ../target/release/nyash test.nyash
|
|||
|
|
./target/release/nyash local_tests/test.nyash
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**必須ルール：**
|
|||
|
|
- **テストファイル**: 必ず `local_tests/` に配置
|
|||
|
|
- **ログファイル**: 環境変数で `logs/` に出力するか、実行後即削除
|
|||
|
|
- **デバッグ出力**: `local_tests/` または `logs/` に保存
|
|||
|
|
- **一時ファイル**: `/tmp/` を使用
|
|||
|
|
|
|||
|
|
**なぜ毎回ルートが散らかるのか：**
|
|||
|
|
1. テスト実行時にカレントディレクトリにログ出力
|
|||
|
|
2. エラー時のデバッグファイルが自動削除されない
|
|||
|
|
3. VM統計やMIRダンプがデフォルトでカレントに出力
|
|||
|
|
|
|||
|
|
## 🧪 テスト実行
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 基本機能テスト
|
|||
|
|
cargo test
|
|||
|
|
|
|||
|
|
# テストファイル作成・実行例
|
|||
|
|
mkdir -p local_tests
|
|||
|
|
echo 'print("Hello Nyash!")' > local_tests/test_hello.nyash
|
|||
|
|
./target/debug/nyash local_tests/test_hello.nyash
|
|||
|
|
|
|||
|
|
# 演算子統合テスト（local_testsから実行）
|
|||
|
|
./target/debug/nyash local_tests/test_comprehensive_operators.nyash
|
|||
|
|
|
|||
|
|
# 実用アプリテスト
|
|||
|
|
./target/debug/nyash app_dice_rpg.nyash
|
|||
|
|
|
|||
|
|
# JIT 実行フラグ（CLI）
|
|||
|
|
./target/release/nyash --backend vm \
|
|||
|
|
--jit-exec --jit-stats --jit-dump --jit-threshold 1 \
|
|||
|
|
--jit-phi-min --jit-hostcall --jit-handle-debug \
|
|||
|
|
examples/jit_branch_demo.nyash
|
|||
|
|
# 既存の環境変数でも可:
|
|||
|
|
# NYASH_JIT_EXEC/NYASH_JIT_STATS(/_JSON)/NYASH_JIT_DUMP/NYASH_JIT_THRESHOLD
|
|||
|
|
# NYASH_JIT_PHI_MIN/NYASH_JIT_HOSTCALL/NYASH_JIT_HANDLE_DEBUG
|
|||
|
|
|
|||
|
|
# HostCallハンドルPoCの例
|
|||
|
|
./target/release/nyash --backend vm --jit-exec --jit-hostcall examples/jit_array_param_call.nyash
|
|||
|
|
./target/release/nyash --backend vm --jit-exec --jit-hostcall examples/jit_map_param_call.nyash
|
|||
|
|
./target/release/nyash --backend vm --jit-exec --jit-hostcall examples/jit_map_int_keys_param_call.nyash
|
|||
|
|
./target/release/nyash --backend vm --jit-exec --jit-hostcall examples/jit_string_param_length.nyash
|
|||
|
|
./target/release/nyash --backend vm --jit-exec --jit-hostcall examples/jit_string_is_empty.nyash
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🔌 **プラグインテスター（BID-FFI診断ツール）**
|
|||
|
|
```bash
|
|||
|
|
# プラグインテスターのビルド
|
|||
|
|
cd tools/plugin-tester
|
|||
|
|
cargo build --release
|
|||
|
|
|
|||
|
|
# プラグインの診断実行
|
|||
|
|
./target/release/plugin-tester ../../plugins/nyash-filebox-plugin/target/debug/libnyash_filebox_plugin.so
|
|||
|
|
|
|||
|
|
# 出力例：
|
|||
|
|
# Plugin Information:
|
|||
|
|
# Box Type: FileBox (ID: 6) ← プラグインが自己宣言！
|
|||
|
|
# Methods: 6
|
|||
|
|
# - birth [ID: 0] (constructor)
|
|||
|
|
# - open, read, write, close
|
|||
|
|
# - fini [ID: 4294967295] (destructor)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**plugin-testerの特徴**:
|
|||
|
|
- Box名を決め打ちしない汎用設計
|
|||
|
|
- プラグインのFFI関数4つ（abi/init/invoke/shutdown）を検証
|
|||
|
|
- birth/finiライフサイクル確認
|
|||
|
|
- 将来の拡張: TLV検証、メモリリーク検出
|
|||
|
|
|
|||
|
|
## 🐛 デバッグ
|
|||
|
|
|
|||
|
|
### パーサー無限ループ対策（2025-08-09実装）
|
|||
|
|
```bash
|
|||
|
|
# 🔥 デバッグ燃料でパーサー制御
|
|||
|
|
./target/release/nyash --debug-fuel 1000 program.nyash # 1000回制限
|
|||
|
|
./target/release/nyash --debug-fuel unlimited program.nyash # 無制限
|
|||
|
|
./target/release/nyash program.nyash # デフォルト10万回
|
|||
|
|
|
|||
|
|
# パーサー無限ループが検出されると自動停止＋詳細情報表示
|
|||
|
|
🚨 PARSER INFINITE LOOP DETECTED at method call argument parsing
|
|||
|
|
🔍 Current token: IDENTIFIER("from") at line 17
|
|||
|
|
🔍 Parser position: 45/128
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**対応状況**: must_advance!マクロでパーサー制御完全実装済み✅
|
|||
|
|
**効果**: 予約語"from"など問題のあるトークンも安全にエラー検出
|
|||
|
|
|
|||
|
|
### アプリケーション デバッグ
|
|||
|
|
```nyash
|
|||
|
|
// DebugBox活用
|
|||
|
|
DEBUG = new DebugBox()
|
|||
|
|
DEBUG.startTracking()
|
|||
|
|
DEBUG.trackBox(myObject, "説明")
|
|||
|
|
print(DEBUG.memoryReport())
|
|||
|
|
```
|