nucleic-brush/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 pre-commit checks (~45s warm): quick + deps, schemas, integration tests
cargo xtask ci pre-commit

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>'