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:
Test results output to: out/test/<module>/
See Also
- test suite - Run test suites
- test debug - Debug failures
- show tests - View test assertions
- test Commands
Tutorials | How-to Guides | Explanation | Reference
You are here: Reference — information-oriented technical descriptions of the system.