rux test

Purpose

Run package unit tests

Synopsis

rux test [options]

Behavior

Discovers test Program packages, builds them with test mode enabled, and runs every executable. Workspaces include root and member test trees. --define and --release apply consistently to every test target.

Arguments

This command accepts no operands.

Options

OptionDescription
--define <name[=value]>Set or override a config compile-time value
--releaseBuild with release profile
--target <triple>Build and run the tests for the specified target platform

Global options may appear before or after the command. See Global options.

Output and exit status

A summary is written to stdout; compiler diagnostics and failed test details identify unsuccessful targets. The command returns 1 when any build or test fails.

Success exits 0, invalid command-line usage exits 2, and compiler, validation, filesystem, network, or generation failures exit 1 unless stated otherwise above.

Examples

rux test
rux test --release

Environment variables

This command defines no command-specific environment variables.

The global color environment behavior is described under Global options.