jik

jik command [arguments] [--option [value]...]

jik is the compiler and runner for the Jik language. Command arguments come before options: `jik run hello.jik --cc clang`. help covers commands and the standard library (`jik help vector`, `jik help jik/string`).run and build need a C compiler. check, tran, test --list, and test --emit-suite do not. Native directives in reachable modules (`@includedir`, `@libdir`, `@link`, `@copy`) are applied by build and run. `@platform` and `@profile` restrict those directives. Profile matching is checked before the host compiler runs. MSVC is not a native build profile.Tests are top-level functions whose names start with the test prefix, taking one `jik/testing` suite argument and returning nothing. Discovery walks in relative-path order, skips linked directories, and does not follow imports out of the selected tree.Package imports under `pkg/` resolve through the JIK PKG PATH environment variable.

new directory

Create directory with `src/` named after that directory, a README, and a `.gitignore`. The destination must not exist. Git is not initialized

Translate to C, compile, run, and delete the temporary build. Arguments after `--` are the program's, including empty strings and values that start with `-`

Syntax, types, and regions only. --verbose and --dump-ast are accepted. No C compiler is required

Write C. --out sets the path (default: the source with `.jik` replaced by `.c`). --embed-core includes the support library. --emit-source-loc adds source comments. --format-c runs `clang-format` on the result

Translate and compile. --out is the executable (default: the source path without `.jik`, plus `.exe` on Windows). --preview prints the compiler command and writes nothing. --release compiles with `-O3`

Find test files under a directory: names that start with `test`, then an underscore, and end in `.jik`. The default directory is `.`. A path that is a `.jik` file may have any name. --list prints names and stops. --emit-suite file writes a runner and stops. Those two flags cannot be combined and need no C compiler

Print `key=value` lines: version, platform, root, library path, package path, include path, selected C compiler, its target, and Jik's compiler profile

Print the Jik version

Help for a command, a language topic, or a standard-library entry. help topics lists documentation keys

C compiler for run, build, and test. Else the JIK CC environment variable, else the first of `clang`, `gcc`, and `cc`

Extra arguments for that compiler

Disable runtime vector bounds checks

After a run, print region statistics, or one row per region with nesting

Print the parsed syntax tree

Print pipeline status

run removes its temporary C and binary after the program exits. Use build when you need to keep the executable, and tran when you need the C.build --preview and test --list do not prove the program links. --release is `-O3` only. It does not change Jik's safety checks unless you also pass --unsafe-no-bounds-checks.On Windows the default build output adds `.exe`. Elsewhere the output is the source path with the `.jik` suffix removed.

Jik is a language that compiles through C, with the CLI documented in the jik-lang/jik repository (`docs/cli.md`) and at jik-lang.org. The host compiler is clang, gcc, or cc. Windows and Linux are both targets.

gcc(1)

Source code · Homepage · Documentation