hyperion::assert

hyperion::assert is a C++20 library for all manner of runtime assertions. It includes assertions for verifying contract requirements (i.e. pre-conditions, post-conditions), assertions for verifying error conditions have not occurred, debug assertions, optimization suggestions, and more, all with stacktrace support, user-configurable handling, optional syntax highlighting, and expression decomposition.

Example

    #include <hyperion/assert.h>

    auto example() {
        const auto lambda = []() {
            return 4;
        };
        HYPERION_ASSERT_DEBUG(2 + lambda() == 7, "lambda() wasn't {}", 5);
    }

Quick Start

See the Quick Start Guide for how to get started using hyperion::assert.

Documentation

You can also find the rest of the project documentation here

Contributing

Feel free to submit issues, pull requests, etc.!
When contributing code, please follow the general style expectations of Hyperion projects:

Follow the project .clang-format (except in judicious cases of templates or requires clauses ruining formatting),
Use trailing returns types,
Use assign-init (e.g. auto var = value;) instead of direct-init (e.g. auto var{value}),
By default, prefer simplicity and correctness over performance
We try to target Clang/LLVM 15, which doesn't yet support usage of concepts in function definitions occurring after the declaration (for example, defining a function template outside of the class it was declared in). In these cases, revert to using enable_if instead.

License