Skip to content

test

test - Test one or more modules by moniker

Test one or more modules by moniker using suite-based filtering.

This command discovers tests, applies inference rules (e.g., Go tests default to @L1), filters by suite tags, and runs matching tests with consistent summary output.

Use --suite to select which tests to run. The default runs suites not marked as extended_suite in config (typically unit + integration).

Flags

Flag Description
--suite Filter tests by suite (default: non-extended suites from config)
--coverage Enable coverage reporting
--skip-deps Skip dependency checks before running tests
--skip-depm Skip module dependency build artifact validation
--list-only List tests without running them
--timings Show detailed timing summary after tests complete
--debug Enable debug logs to console (file logging always enabled)
--tui Enable TUI console (default for local console mode)
--no-tui Disable TUI console (use plain output)
--sequential Run tests sequentially instead of parallel
--retest Force retest, bypassing incremental test state
--tui-height Set TUI console height (3-20, default: 6)

Notes

Expected Output:

  • Test execution results with pass/fail status
  • Detailed test summary table showing modules, packages, and assertions
  • Test logs written to out/test// directory
  • Exit code 0 if all tests pass, non-zero on failure

Examples

test eac-commands                    # Test single module
test eac-core r2r-cli                # Test multiple modules
test                                 # Test all modules
test eac-commands --suite acceptance # Run acceptance tests only

Language Support

The test command supports multiple test frameworks:

  • Go - gotest (unit tests), godog (BDD/Gherkin)
  • TypeScript - mocha (unit tests), cucumber-js (BDD/Gherkin)

Tests are discovered by file patterns (*_test.go, *.test.ts, *.feature).

Test Suites

Use composite suites with + to run multiple suites in a single pass:

r2r eac test eac-commands --suite unit+integration

Test results output to: out/test/<module>/

See Also


Tutorials | How-to Guides | Explanation | Reference

You are here: Reference — information-oriented technical descriptions of the system.