Skip to content

Test.md

Latest commit

 

History

History
53 lines (36 loc) · 1.62 KB

Test.md

File metadata and controls

53 lines (36 loc) · 1.62 KB

Unit Tests

KAI uses GoogleTest-based executables under Bin/Test/. The source tree for tests lives under Test/, with additional guides in Test/README.md and the per-folder READMEs there.

Running Tests

Test programs are located in the Bin/Test/ directory after building the project. The main test programs are:

  • TestCore: Core functionality tests
  • TestPi: Pi language tests
  • TestRho: Rho language tests
  • TestTau: Tau language tests
  • Test_Network: Networking and Tau-over-network tests when KAI_NETWORKING=ON

To run the full suite from the repository root:

./run_all_tests.sh

Command-Line Options

All test programs support standard Google Test command-line options, plus some custom options:

  • --debug-color or --color: Explicitly enable colored output (redundant as color is on by default)
  • --no-color: Disable colored output

Example:

# Run all Pi tests with colored output (default)
./Bin/Test/TestPi

# Run a specific test with colored output
./Bin/Test/TestPi --gtest_filter="PiBinaryOpTests.IntegerAddition"

# Run without colored output
./Bin/Test/TestPi --no-color

See ColorOutput.md for more details about the colored output feature.

Test Output

Test output includes:

  • Standard Google Test result reporting
  • Color-coded log messages (INFO in green, WARNING in yellow, ERROR in red)
  • Grey console metadata for improved readability

Test Organization

Tests are organized by language and functionality:

  • Core tests: Basic data structures, memory management, registry operations
  • Language tests: Pi, Rho, and Tau language features