WARNING: This library is currently in a very volatile state. Breaking changes will happen all the time until I think the API is good enough.

This is a C++ library that I use across my projects as an alternative to the STL. It's written in C++20 and its only dependency is libc and a compiler supporting the language features - which should be available virtually anywhere. Compilers that are ensured to work are: Clang, GCC, MSVC.

The code is written with simplicity of use in mind and does not adhere to the principles of the so called "modern" C++. There is no use of exceptions, inheritance, and only a few standard headers are used. For more information, check the style guide.

The library has a bundled compilation unit src/all.cpp which may be used if you wish to compile as a unity build. This is as simple as, e.g.:

# Build static library.
clang++ -c -std=c++20 -Iinclude src/all.cpp -o presheaf.o && llvm-ar rc libpresheaf.a presheaf.o
# Build all library tests.
clang++ -std=c+20 -Iinclude tests/test_all.cpp -o test

Another option is to use the build.lua script, which will manage to build the project with many custom options. For more information, please run the script with the --help flag or refer to the file itself.

Having no inherent build system, this library is extremely easy to integrate to any projects. Since unity build files such as presheaf/src/all.cpp are available, you can also embed the library directly inside of your project.

You may either create a static or shared library binary or you can simply add the include directory presheaf/include and the source file presheaf/src/all.cpp to your compilation command. If you are using CMake (may your soul be forgiven), you can include the following lines to add Presheaf as a library:

add_library(presheaf src/all.cpp)
target_include_directories(presheaf PUBLIC include)
set_property(TARGET presheaf PROPERTY CXX_STANDARD 20)

The following #define macros can be used to tweak the behaviour of the library as you want it:

• psh_malloc and psh_free: Function-like macros for overriding the default allocation functions.
• PSH_DISABLE_LOGGING: Silence all logging calls.
• PSH_DISABLE_ASSERTS: Silence all assert calls.
• PSH_CHECK_BOUNDS: Check the bounds of index-based memory access.
• PSH_CHECK_MEMCPY_OVERLAP: Check if the pointer ranges overlap before calling memcpy.
• PSH_DEBUG: Enables all debug checks.
• PSH_ABORT_AT_MEMORY_ERROR: Aborts the program at any memory (re)allocation errors, for debugging purposes. Not enabled by PSH_DEBUG due to its intrusiveness on the behaviour of fault tolerancy.
• PSH_DEFINE_SHORT_NAMES: Define shorter names for function-like macros defined in psh/core.h, psh/log.h, and psh/assert.h.