| name | cmake-workflow |
| description | Build and test the libuipc project using CMake. Use when building the project, running cmake configure/build commands, compiling with RelWithDebInfo, running Catch2 tests, or when the user asks how to build or test libuipc. |
CMake Workflow for libuipc
Build
The build directory is libuipc/build. Run all cmake commands from there.
Configure:
cd libuipc/build
cmake -S ..
Build:
cmake --build . -j32 --config RelWithDebInfo
Use -j32 for parallel compilation. The config is always RelWithDebInfo.
Testing
Tests use Catch2. After a successful build, run the test executable directly — no separate test runner command is needed.
Find the compiled test binary in the build output (typically under libuipc/build/bin/ or the relevant subdirectory) and execute it:
./path/to/test_executable
Catch2 test binaries accept standard flags such as:
--list-tests — list all test cases[tag] — filter by tag"test name" — run a specific test by name
Quick Reference
| Step | Command |
|---|
| Configure | cmake -S .. (from libuipc/build) |
| Build | cmake --build . -j32 --config RelWithDebInfo |
| Run tests | Execute the test binary directly |
