OrcaSlicer/doc/developer-reference/How-to-test.md

How to Test

This wiki page describes how to build and run tests on Linux. It should eventually provide guidance on how to add tests for a new feature.

Build Tests

Can be built when you are building Orca Slicer binary by including the -t flag for build_linux.sh:

build_linux.sh -st

(or -ster or -stb etc).

When running build_linux.sh with -t, make sure you always include the -e or -b flag if you built the binary with them, otherwise you'll rebuild all of OrcaSlicer again before the tests are ready.

Test binaries will then appear under build/tests or build-dbginfo/tests or build-dbg/tests. As of this writing, not all tests will be built.

For rebuilding after changes, you can look into build_linux.sh for the cmake command which triggers the build, but it should be something like:

# Obviously only use the appropriate one
BUILD_CONFIG=Release
BUILD_CONFIG=RelWithDebInfo
cd $BUILD_DIR # build or build-dbginfo probably

cmake --build . --config $BUILD_CONFIG --target tests/all
# or
cmake --build . --config $BUILD_CONFIG --target libslic3r_tests
# etc

Run Unit Tests

Run All

cd $BUILD_DIR # build or build-dbginfo probably
ctest --test-dir tests

Run a Specific Set

cd $BUILD_DIR # build or build-dbginfo probably
ctest --test-dir tests/slic3rutils