hpp

K-ballo · K-ballo · commit c49932fc03a4 · 2026-06-04T22:22:07.000+02:00
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -83,6 +83,7 @@ target_sources(
             BASE_DIRS include "${CMAKE_CURRENT_BINARY_DIR}/include"
             FILES
                 include/eggs/assert.h
+                include/eggs/assert.hpp
                 "${CMAKE_CURRENT_BINARY_DIR}/include/eggs/assert-export.h"
 )
 
diff --git a/README.md b/README.md
@@ -4,6 +4,11 @@
 
 **Eggs.Assert** is a **C++23** assertion library with stacktrace.
 
+Link against `Eggs::Assert` and include one of:
+
+- `<eggs/assert.h>` — replaces the standard `assert` macro with one that prints a full stacktrace on failure.
+- `<eggs/assert.hpp>` — provides `EGGS_ASSERT` under its own name, leaving the standard `assert` untouched.
+
 ---
 
 > Copyright *Agustín Bergé*, *Fusion Fenix* 2026
diff --git a/include/eggs/assert.hpp b/include/eggs/assert.hpp
@@ -0,0 +1,33 @@
+// Eggs.Assert
+//
+// Copyright Agustin K-ballo Berge, Fusion Fenix 2026
+//
+// Distributed under the Boost Software License, Version 1.0. (See accompanying
+// file LICENSE.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+#pragma once
+
+#ifdef NDEBUG
+
+#    define EGGS_ASSERT(...) ((void)0)
+
+#else
+
+#    include <eggs/assert-export.h>
+
+#    include <source_location>
+
+extern "C" [[noreturn]] EGGS_ASSERT_EXPORT void eggs_assert_failed(
+    char const* message, char const* file, unsigned line, char const* function
+);
+
+#    define EGGS_ASSERT(...)                                                  \
+        ((__VA_ARGS__)                                                        \
+             ? (void)0                                                        \
+             : ::eggs_assert_failed(                                          \
+                   #__VA_ARGS__, std::source_location::current().file_name(), \
+                   (unsigned)std::source_location::current().line(),          \
+                   std::source_location::current().function_name()            \
+               ))
+
+#endif // NDEBUG

Original file line number	Diff line number	Diff line change
`@@ -83,6 +83,7 @@ target_sources(`
`83`	`83`	`BASE_DIRS include "${CMAKE_CURRENT_BINARY_DIR}/include"`
`84`	`84`	`FILES`
`85`	`85`	`include/eggs/assert.h`
	`86`	`+ include/eggs/assert.hpp`
`86`	`87`	`"${CMAKE_CURRENT_BINARY_DIR}/include/eggs/assert-export.h"`
`87`	`88`	`)`
`88`	`89`