stdan

stdan is a small modern C++ project for experimenting with and implementing data structures, algorithms, and related supporting utilities.

The repository is organized to grow over time. New implementations, tests, and supporting components can be added without changing the overall project structure or build flow.

Layout

• include/ public headers
• src/ library source files
• tests/ test targets and test sources
• vendor/ third-party dependencies

Requirements

• CMake 3.20 or newer
• A C++23-capable compiler with support for explicit object parameters ("deducing this"), e.g.:
  • GCC 14 or newer
  • Clang 19 or newer
  • MSVC from Visual Studio 2022 17.8 or newer
• make for the provided Makefile workflow on Unix-like systems (Windows builds use CMake directly)

Build

Make sure to grab vendored submodules:

git submodule update --init --recursive

With CMake

cmake -B build -DCMAKE_BUILD_TYPE=Debug
cmake --build build

With Make

make build

On Windows (CMake + Visual Studio)

cmake -S . -B build -G "Visual Studio 17 2022" -A x64 -DSTDAN_BUILD_TESTS=ON
cmake --build build --config Debug --target stdan_tests
ctest --test-dir build -C Debug --output-on-failure

Tests

Tests are optional and are enabled with STDAN_BUILD_TESTS=ON.

With CMake

cmake -B build -DCMAKE_BUILD_TYPE=Debug -DSTDAN_BUILD_TESTS=ON
cmake --build build --target stdan_tests
ctest --test-dir build --output-on-failure

With Make

make test

Notes

• The main library target is stdan.
• compile_commands.json can be generated as part of the configured build.
• The project currently uses a static library build.

Contributing

See CONTRIBUTING.md