d90216e9c4
## 主な変更点 ### 🎯 戦略の転換と明確化 - PyVMを開発ツールとして位置づけ（本番経路ではない） - EXE-first戦略を明確に優先（build_compiler_exe.sh実装済み） - Phase順序の整理: 15.2(LLVM)→15.3(コンパイラ)→15.4(VM) ### 🚀 セルフホスティング基盤の実装 - apps/selfhost-compiler/にNyashコンパイラMVP実装 - compiler.nyash: メインエントリー（位置引数対応） - boxes/: parser_box, emitter_box, debug_box分離 - tools/build_compiler_exe.sh: ネイティブEXEビルド＋dist配布 - Python MVPパーサーStage-2完成（local/if/loop/call/method/new） ### 📝 ドキュメント整備 - Phase 15 README/ROADMAP更新（Self-Hosting優先明記） - docs/guides/exe-first-wsl.md: WSLクイックスタート追加 - docs/private/papers/: 論文G～L、爆速事件簿41事例収録 ### 🔧 技術的改善 - JSON v0 Bridge: If/Loop PHI生成実装（ChatGPT協力） - PyVM/llvmliteパリティ検証スイート追加 - using/namespace機能（gated実装、Phase 15では非解決） ## 次のステップ 1. パーサー無限ループ修正（未実装関数の実装） 2. EXEビルドとセルフホスティング実証 3. c0→c1→c1'ブートストラップループ確立 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
57 lines
2.6 KiB
Markdown
57 lines
2.6 KiB
Markdown
# EXE‑First Quickstart (WSL/Ubuntu)
|
||
|
||
This guide prioritizes building and running the Nyash parser as a native executable on WSL (Ubuntu). It uses the LLVM harness (llvmlite) and the NyRT static runtime.
|
||
|
||
Prerequisites
|
||
- Rust toolchain (stable): `curl https://sh.rustup.rs -sSf | sh`
|
||
- Build tools: `sudo apt update && sudo apt install -y build-essential git python3 python3-pip`
|
||
- llvmlite: `pip3 install --user llvmlite`
|
||
- LLVM 18 (for `llvm-config-18` used by the Rust build + tools):
|
||
- Ubuntu (with apt.llvm.org):
|
||
- `sudo apt install -y wget gnupg lsb-release`
|
||
- `wget https://apt.llvm.org/llvm.sh && chmod +x llvm.sh && sudo ./llvm.sh 18`
|
||
- This installs `llvm-18` and `llvm-18-dev` (provides `llvm-config-18`).
|
||
|
||
Verify
|
||
- `rustc --version`
|
||
- `python3 -c "import llvmlite, sys; print('llvmlite', llvmlite.__version__)"`
|
||
- `llvm-config-18 --version`
|
||
|
||
Build Parser EXE (bundle)
|
||
- `tools/build_compiler_exe.sh`
|
||
- Result: `dist/nyash_compiler/` containing `nyash_compiler`, `nyash.toml`, and the FileBox plugin.
|
||
|
||
Smoke (Parser EXE → JSON)
|
||
- `echo 'return 1+2*3' > dist/nyash_compiler/tmp/sample.ny`
|
||
- `(cd dist/nyash_compiler && ./nyash_compiler tmp/sample.ny > sample.json)`
|
||
- `head -n1 dist/nyash_compiler/sample.json` should start with `{` and contain `"kind":"Program"`.
|
||
|
||
End‑to‑End (JSON → execute via bridge)
|
||
- `./tools/exe_first_smoke.sh`
|
||
- Builds the EXE bundle, runs parser → JSON, and executes via the bridge to verify exit code `7`.
|
||
|
||
MIR Builder (optional, EXE)
|
||
- Build: `cargo build --release --features llvm`
|
||
- EXE from JSON: `./target/release/ny_mir_builder --in dist/nyash_compiler/sample.json --emit exe -o app_out`
|
||
- Run: `./app_out` (exit `7` expected for `return 1+2*3`).
|
||
|
||
Runner with EXE‑First Parser
|
||
- `NYASH_USE_NY_COMPILER=1 NYASH_USE_NY_COMPILER_EXE=1 ./target/release/nyash --backend vm tmp/sample.nyash`
|
||
- Smoke: `./tools/exe_first_runner_smoke.sh`
|
||
|
||
Troubleshooting
|
||
- `llvm-config-18: not found`
|
||
- Ensure apt.llvm.org installation worked (see above), or install the distro’s `llvm-18-dev` package.
|
||
- `ModuleNotFoundError: llvmlite`
|
||
- `pip3 install --user llvmlite` and re‑run the build/smoke.
|
||
- Link errors (`cc` not found or missing libs)
|
||
- `sudo apt install -y build-essential`
|
||
- If you have a custom toolchain, export `CC` to point at your compiler.
|
||
- Plugin resolution
|
||
- The EXE bundle includes a minimal `nyash.toml` and plugin paths under `dist/nyash_compiler/plugins/`.
|
||
|
||
Notes
|
||
- The EXE‑first path is the delivery priority. PyVM remains a development aid for semantics parity.
|
||
- Windows support is evolving; WSL is the recommended environment for now.
|
||
|