48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
Self‑Hosting Dev (JIT / VM)
|
||
|
||
Focus: Ny → MIR → MIR‑Interp → VM/JIT quick loops to validate semantics and bootstrap paths.
|
||
|
||
Quickstart
|
||
|
||
- Core build (JIT):
|
||
- `cargo build --release --features cranelift-jit`
|
||
- Core smokes (plugins disabled):
|
||
- `NYASH_CLI_VERBOSE=1 ./tools/jit_smoke.sh`
|
||
- Roundtrip (parser pipe + json):
|
||
- `./tools/ny_roundtrip_smoke.sh`
|
||
- Plugins smoke (optional gate):
|
||
- `NYASH_SKIP_TOML_ENV=1 ./tools/smoke_plugins.sh`
|
||
- Using/Resolver E2E sample (optional):
|
||
- `./tools/using_e2e_smoke.sh` (requires `--enable-using`)
|
||
- Bootstrap c0→c1→c1' (optional):
|
||
- `./tools/bootstrap_selfhost_smoke.sh`
|
||
|
||
Docs
|
||
|
||
- One‑page guide: `docs/how-to/self-hosting.md`
|
||
|
||
Flags
|
||
|
||
- `NYASH_DISABLE_PLUGINS=1`: stabilize core path
|
||
- `NYASH_LOAD_NY_PLUGINS=1`: enable nyash.toml ny_plugins
|
||
- `NYASH_ENABLE_USING=1`: using/namespace enable
|
||
- `NYASH_SKIP_TOML_ENV=1`: suppress [env] mapping in nyash.toml
|
||
|
||
Tips
|
||
|
||
- For debug, set `NYASH_CLI_VERBOSE=1`.
|
||
- Keep temp artifacts under this folder (`dev/selfhosting/_tmp/`) to avoid polluting repo root.
|
||
|
||
|
||
Dev Loop (Ny-only)
|
||
|
||
- One-off run (VM): `./tools/dev_selfhost_loop.sh apps/selfhost-minimal/main.hako`
|
||
- Watch + std libs: `./tools/dev_selfhost_loop.sh --watch --std apps/selfhost/ny-parser-nyash/main.hako`
|
||
- Make targets:
|
||
- `make dev` (VM, std on, verbose)
|
||
- `make dev-watch` (watch mode)
|
||
|
||
Notes
|
||
- Rebuild Rust only when core changes; Ny scripts reload on each run.
|
||
- Flags: `--backend mir|vm`, `-v` for verbose, `--std` to load `[ny_plugins]`.
|