Developer Tools
Implemented — this category documents tools for Karkain
(the CLI, engines, formatter, LSP, profiler) and carries example programs in
examples/15-developer-tools/ that exercise them.
Corpus
File |
Demonstrates |
|---|---|
|
The write → build → run loop for any environment |
|
|
The toolchain loop
$ karkain check examples/15-developer-tools/01_hello_toolchain.kark
$ karkain build examples/15-developer-tools/01_hello_toolchain.kark -o bin/hello.exe
$ karkain run examples/15-developer-tools/01_hello_toolchain.kark
Run the test file through the real test runner:
$ karkain test examples/15-developer-tools/02_assertions_test.kark
Expected summary:
3 passed; 0 failed; 0 skipped; 3 total
What the CLI covers today
karkain check— syntax + semantics, exit 3 on error,--format=jsonkarkain build— native executable (PE32+ on Windows, ELF elsewhere)karkain run— build + run in an isolated working directorykarkain test—*_test.karkdiscovery,--filter, exit 4 on failurekarkain debug— trace (frame enter / line) on stderrkarkain prof— call counts, inclusive/exclusive timing, flame-graph datakarkain target— host triple + supported target matrixkarkain fmt/karkain lint/karkain explain/karkain lsp
Each command is documented in Tools.