1. Directory guide
| Directory | Coverage |
|---|---|
writer/ |
Writer, write sessions, synchronous callbacks and writer queues |
reader/ |
Current-block scanning, notifications, single/multiple-writer reading and completion; dated checks |
queue/ |
Full-queue options and unified message delivery |
pool/ |
Slice allocation, capacity and release checks |
handoff/ |
Live resource handoff, current snapshots and concurrent FIFO |
performance/ |
Benchmark harness contracts and Python search/report tests; these check correctness rather than publish performance scores |
support/ |
Shared test fixtures and helper headers |
func/ |
Detailed functional and concurrent contracts; case catalog |
integration/ |
Vendored, FetchContent and installed-package integration |
2. Run tests
From the repository root:
Shell
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel
ctest --test-dir build --output-on-failureBenchmark harness tests are enabled with BRQ_BUILD_SPSC_BENCHMARKS=ON after verifying the bundled pinned dependencies. See the test guide and benchmark navigation.