Blorp CLI
blorp is the command line surface for checking, running, testing, formatting, compiling, and inspecting programs.
Run
blorp run compiles and executes one file. Put program arguments after -- so they are passed to your main function.
blorp run hello.brp
blorp run greet.brp -- Ada Lovelace
blorp run --release app.brp
Check
blorp check parses, imports, and type checks a file or every .brp file in a directory without running the program.
blorp check program.brp
blorp check src/
blorp check --no-format src/
Test
blorp test runs test files or directories. Use --doc or --suite when you want only doctests or only TestSuite tests.
blorp test tests/
blorp test --doc std/string.brp
blorp test --suite tests/
blorp test -j 8 --timeout 30 tests/
Format
blorp format rewrites source in place. Use --check in CI when formatting should be verified without modifying files.
blorp format file.brp
blorp format --check file.brp
Compile and Inspect
blorp compile emits generated C. The inspection flags expose parser, type, and compiler pipeline output for debugging.
blorp compile program.brp
blorp compile -o program.c program.brp
blorp compile --ast program.brp
blorp compile --time-phases program.brp
Debugging Flags
Use runtime and compiler flags when you need debug-only code, sanitizer coverage, leak checks, or a specific standard library checkout.
blorp run --debug program.brp
blorp run --sanitize program.brp
BLORP_LEAK_CHECK=1 blorp run program.brp
BLORP_STD=std blorp check src/
Editor and REPL
blorp lsp serves editor integrations, blorp repl starts an interactive session, and blorp purify helps mark pure functions.
blorp lsp
blorp repl
blorp purify src/main.brp