Files
hakorune/docs/guides/macro-profiles.md

40 lines
1.1 KiB
Markdown
Raw Permalink Normal View History

# Macro Profiles — Simple, Practical Defaults
Profiles simplify CLI/ENV by choosing sensible defaults for macro execution.
Profiles
- lite
- macros: OFF
- strict: OFF
- trace: OFF
- dev (default behavior)
- macros: ON
- strict: ON
- trace: OFF
- ci / strict
- macros: ON
- strict: ON
- trace: OFF
CLI
- `nyash --profile lite file.hako`
- `nyash --profile dev file.hako`
- `nyash --profile ci file.hako`
ENV mapping (non-breaking; can be overridden)
- lite → `NYASH_MACRO_ENABLE=0`, `NYASH_MACRO_STRICT=0`, `NYASH_MACRO_TRACE=0`
- dev → `NYASH_MACRO_ENABLE=1`, `NYASH_MACRO_STRICT=1`, `NYASH_MACRO_TRACE=0`
- ci/strict → `NYASH_MACRO_ENABLE=1`, `NYASH_MACRO_STRICT=1`, `NYASH_MACRO_TRACE=0`
Recommended ENV (minimal)
- `NYASH_MACRO_ENABLE=1`
- `NYASH_MACRO_PATHS=...`
- `NYASH_MACRO_STRICT=1`
- `NYASH_MACRO_TRACE=0|1`
Deprecated ENV (kept for compatibility for now)
- `NYASH_MACRO_BOX_NY=1` + `NYASH_MACRO_BOX_NY_PATHS=...` → use `NYASH_MACRO_PATHS`
- `NYASH_MACRO_BOX_CHILD_RUNNER` → no longer needed
- `NYASH_MACRO_TOPLEVEL_ALLOW` → default OFF; prefer CLI `--macro-top-level-allow` when necessary