37 lines
1.9 KiB
Markdown
37 lines
1.9 KiB
Markdown
|
Self‑Hosting Pilot — Quick Guide (Phase‑15)
|
|||
|
|
|
|||
|
|
Overview
|
|||
|
|
- Goal: Run Ny→JSON v0 via the selfhost compiler path and execute with PyVM/LLVM.
|
|||
|
|
- Default remains env‑gated for safety; CI runs smokes to build confidence.
|
|||
|
|
|
|||
|
|
Recommended Flows
|
|||
|
|
- Runner (pilot): `NYASH_USE_NY_COMPILER=1 ./target/release/nyash --backend vm apps/examples/string_p0.nyash`
|
|||
|
|
- Emit‑only: `NYASH_USE_NY_COMPILER=1 NYASH_NY_COMPILER_EMIT_ONLY=1 ...`
|
|||
|
|
- EXE‑first (parser EXE): `tools/build_compiler_exe.sh && NYASH_USE_NY_COMPILER=1 NYASH_USE_NY_COMPILER_EXE=1 ./target/release/nyash --backend vm apps/examples/string_p0.nyash`
|
|||
|
|
- LLVM AOT: `NYASH_LLVM_USE_HARNESS=1 tools/build_llvm.sh apps/... -o app && ./app`
|
|||
|
|
|
|||
|
|
CI Workflows
|
|||
|
|
- Selfhost Bootstrap (always): `.github/workflows/selfhost-bootstrap.yml`
|
|||
|
|
- Builds nyash (`cranelift-jit`) and runs `tools/bootstrap_selfhost_smoke.sh`.
|
|||
|
|
- Selfhost EXE‑first (optional): `.github/workflows/selfhost-exe-first.yml`
|
|||
|
|
- Installs LLVM 18 + llvmlite, then runs `tools/exe_first_smoke.sh`.
|
|||
|
|
|
|||
|
|
Useful Env Flags
|
|||
|
|
- `NYASH_USE_NY_COMPILER=1`: Enable selfhost compiler pipeline.
|
|||
|
|
- `NYASH_NY_COMPILER_EMIT_ONLY=1`: Print JSON v0 only (no execution).
|
|||
|
|
- `NYASH_NY_COMPILER_TIMEOUT_MS=4000`: Child timeout (ms). Default 2000.
|
|||
|
|
- `NYASH_USE_NY_COMPILER_EXE=1`: Prefer external parser EXE.
|
|||
|
|
- `NYASH_NY_COMPILER_EXE_PATH=<path>`: Override EXE path.
|
|||
|
|
- `NYASH_SELFHOST_READ_TMP=1`: Child reads `tmp/ny_parser_input.ny` when supported.
|
|||
|
|
|
|||
|
|
Troubleshooting (short)
|
|||
|
|
- No Python found: install `python3` (PyVM / harness).
|
|||
|
|
- No `llvm-config-18`: install LLVM 18 dev (see EXE‑first workflow).
|
|||
|
|
- llvmlite import error: `python3 -m pip install llvmlite`.
|
|||
|
|
- Parser child timeout: raise `NYASH_NY_COMPILER_TIMEOUT_MS`.
|
|||
|
|
- EXE‑first bridge mismatch: re‑run with `NYASH_CLI_VERBOSE=1` and keep `dist/nyash_compiler/sample.json` for inspection.
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
- JSON v0 schema is stable but not yet versioned; validation is planned.
|
|||
|
|
- Default backend `vm` maps to PyVM unless legacy VM features are enabled.
|