| slug | /cli |
|---|
The rue command line tool is installed with cargo install rue-cli (see Installation).
| Command | Description |
|---|---|
rue init [path] |
Create a new project with a Rue.toml manifest. |
rue build [file] |
Compile the project (or a single file) and print the CLVM output. |
rue test [file] |
Run every test fn in the project. |
rue fmt [paths...] [--check] |
Format Rue source files, or check that they're already formatted. |
rue debug <program> [solution] |
Run a CLVM program against a solution and print the result. |
rue lints |
List every lint and its default level, and the lint groups. |
Creates a new project in the given directory (or the current directory, if none is given), with a Rue.toml manifest and a puzzles/main.rue file. It fails if either of those files already exist.
rue init my-projectCompiles the project's main function, and prints the CLVM output.
$ rue build
(q . "Hello, world!")If you pass a file, its main function is compiled instead:
rue build puzzles/other.rue| Flag | Description |
|---|---|
-e, --export |
Compile the exported function with this name instead of main. |
-x, --hex |
Output the serialized bytecode as hex, instead of the CLVM text. |
-h, --hash |
Output the tree hash of the compiled program. This can be combined with --hex to output both. |
-s, --split |
Split the hex output into lines of 64 characters. This requires --hex (or --all). |
-d, --debug |
Compile in debug mode, which includes debug statements and messages for failed assertions, and disables some optimizations. |
-a, --all |
Compile every entrypoint in the project, and write each one to a file. See Building Everything. |
-A, --allow |
Allow a lint or lint group. Can be repeated. |
-W, --warn |
Report a lint or lint group as a warning. Can be repeated. |
-D, --deny |
Report a lint or lint group as an error, which fails compilation. Can be repeated. |
-F, --forbid |
Like --deny, but attributes and later flags can't change the level. Can be repeated. |
:::note
Since -h is short for --hash, the help text for rue build is only available as --help.
:::
Errors and warnings are printed with the file, line, and column they occurred at. If there are any errors (including lints that are denied), nothing is output and the command fails.
Compiles the project in debug mode, and runs every test function in it. If you pass a file or directory, it's used to find the project, and all of that project's tests are run. A file that isn't part of a project is tested by itself.
$ rue test
Running test `factorial_works` (1/1)A test passes if it finishes without raising an error and returns nil. The command fails if any of the tests fail.
| Flag | Description |
|---|---|
--max-cost |
The maximum CLVM cost each test can use before it fails. Defaults to 11000000000, Chia's block cost limit. |
-A, -W, -D, -F |
Set the level of a lint or lint group, the same as for rue build. |
Formats Rue source files in place. With no arguments, every file in the project is formatted. Otherwise, you can pass any number of files, directories, or glob patterns:
rue fmt
rue fmt puzzles/main.rue
rue fmt 'puzzles/**/*.rue'With --check, files are not changed. Instead, it lists the files that need to be formatted, and fails if there are any. This is useful in CI.
See Formatting for more details.
Runs a CLVM program against a solution (which defaults to nil), and prints the result. Both are written in CLVM's text format, or as hex with --hex:
$ rue debug "(+ 2 5)" "(10 20)"
30Unlike other CLVM runners, this supports the debug output from programs compiled with rue build --debug, which prints the value of each debug statement as the program runs. See Debugging.
| Flag | Description |
|---|---|
-x, --hex |
Read the program and solution as serialized hex, instead of CLVM text. |
--max-cost |
The maximum CLVM cost the program can use before it fails. Defaults to 11000000000, Chia's block cost limit. |
Lists every lint, along with its default level and a short description, as well as the lint groups and the lints in each of them. See Lints.