Skip to main content
Version: v1.0.4

Workflow for writing a C++ test

We strongly recommend each developer to write C++ unit tests when sending a PR.

  • We use googletest as the C++ test infrastructure.
  • C++ tests should be added to the tests/cpp/ directory.
  • Make sure your C++ test source file is covered by this CMake glob.

Build and run Taichi C++ tests

# inside build/
cmake .. -DTI_BUILD_TESTS=ON # ... other regular Taichi cmake args

# run the C++ test
TI_LIB_DIR=$TAICHI_INSTALL_DIR/_lib/runtime ./taichi_cpp_tests

$TAICHI_INSTALL_DIR can be retrieved from taichi.__path__[0] in python.


On Windows, taichi_cpp_tests.exe will be placed inside the %TAICHI_REPO_DIR%\bin directory.


Consider polishing the C++ test infrastructure:

  • Separate each translation unit into its own test executable
  • Have a unified script to control the execution of which set of tests

Adding a new test case

Please follow Googletest Primer and Advanced googletest Topics.