38 lines
999 B
Markdown
38 lines
999 B
Markdown
# Fun CLI
|
|
|
|
Reference for the `fun` command-line interface.
|
|
|
|
## Synopsis
|
|
```
|
|
fun [options] <script.fun> [-- args...]
|
|
```
|
|
|
|
If no script is supplied and interactive mode is available, `fun` starts a REPL (see `docs/repl.md`).
|
|
|
|
## Common options
|
|
- `-i`, `--repl` — start an interactive REPL
|
|
- `-v`, `--version` — print version and exit
|
|
- `-h`, `--help` — show help and exit
|
|
|
|
Options may vary between versions; run `fun --help` to see what your build supports.
|
|
|
|
## Exit codes
|
|
- `0` — success
|
|
- non-zero — error during parse, compile, or runtime
|
|
|
|
## Includes and library paths
|
|
- `FUN_LIB_DIR` — environment variable that points to the stdlib location; when running from the repo, set this to `./lib`.
|
|
- `DEFAULT_LIB_DIR` — compiled-in fallback path determined at build/install time.
|
|
|
|
See also: `docs/includes.md` for namespaced includes and search order.
|
|
|
|
## Examples
|
|
Run a script:
|
|
```
|
|
FUN_LIB_DIR=./lib ./build_debug/fun examples/hello.fun
|
|
```
|
|
|
|
Start the REPL:
|
|
```
|
|
./build_debug/fun -i
|
|
```
|