tree-sitter test

The test command is used to run the test suite for a parser.

tree-sitter test [OPTIONS] # Aliases: t

Options

-i/--include <INCLUDE>

Only run tests whose names match this regex.

-e/--exclude <EXCLUDE>

Skip tests whose names match this regex.

-u/--update

Update the expected output of tests. Note that tests containing ERROR nodes or MISSING nodes will not be updated.

-d/--debug

Outputs parsing and lexing logs. This logs to stderr.

-0/--debug-build

Compile the parser with debug flags enabled. This is useful when debugging issues that require a debugger like gdb or lldb.

-D/--debug-graph

Outputs logs of the graphs of the stack and parse trees during parsing, as well as the actual parsing and lexing message. The graphs are constructed with [graphviz dot][dot], and the output is written to log.html.

--wasm

Compile and run the parser as a WASM module.

--open-log

When using the --debug-graph option, open the log file in the default browser.

--config-path <CONFIG_PATH>

The path to an alternative configuration (config.json) file. See the init-config command for more information.

--show-fields

Force showing fields in test diffs.

--stat <STAT>

Show parsing statistics when tests are being run. One of all, outliers-and-total, or total-only.

  • all: Show statistics for every test.

  • outliers-and-total: Show statistics only for outliers, and total statistics.

  • total-only: Show only total statistics.

-r/--rebuild

Force a rebuild of the parser before running tests.

--overview-only

Only show the overview of the test results, and not the diff.