sausage/userland/brush/source/docs/how-to/run-tests.md

How to run tests

Using xtask (Recommended)

The project provides cargo xtask commands for running tests:

# Run unit tests (fast tests excluding integration binaries)
cargo xtask test unit

# Run integration tests (all workspace tests including compat tests)
cargo xtask test integration

# Run tests with code coverage
cargo xtask test integration --coverage --coverage-output codecov.xml

CI Workflows

For comprehensive validation, use the CI workflows:

# Quick inner-loop checks (~7s warm): fmt, build, lint, unit tests
cargo xtask ci quick

# Full workflow (~60s warm): quick + pre-commit hooks, schemas, integration tests
cargo xtask ci full

Manual Approach (Alternate)

To run all workspace tests:

cargo test --workspace

To run just bash compatibility tests:

cargo test --test brush-compat-tests

To run a specific compatibility test case

cargo test --test brush-compat-tests -- '<name of test case>'