Add libassert::print_stacktrace

Author: jeremy-rifkin

README.md

@@ -439,6 +439,12 @@ namespace libassert {
         const color_scheme& scheme = get_color_scheme(),
         std::size_t skip = 0
     );
+    [[nodiscard]] std::string print_stacktrace(
+        const cpptrace::stacktrace& trace,
+        int width = 0,
+        const color_scheme& scheme = get_color_scheme(),
+        path_mode = get_path_mode()
+    );
     template<typename T> [[nodiscard]] std::string_view type_name() noexcept;
     template<typename T> [[nodiscard]] std::string pretty_type_name() noexcept;
     template<typename T> [[nodiscard]] std::string stringify(const T& value);
@@ -455,6 +461,7 @@ namespace libassert {
 ```
 
 - `stacktrace`: Generates a stack trace, formats to the given width (0 for no width formatting)
+- `print_stacktrace`: Formats a provided stack trace with libassert's internal trace formatting
 - `type_name`: Returns the type name of T
 - `pretty_type_name`: Returns the prettified type name for T
 - `stringify`: Produces a debug stringification of a value
@@ -565,10 +572,12 @@ namespace libassert {
         basename, // only the file name is used
     };
     LIBASSERT_EXPORT void set_path_mode(path_mode mode);
+    path_mode get_path_mode();
 }
 ```
 
 - `set_path_mode`: Sets the path shortening mode for assertion output. Default: `path_mode::disambiguated`.
+- `get_path_mode`: Gets the path shortening mode for assertion output.
 
 ## Assertion information
 

include/libassert/assert.hpp

@@ -117,10 +117,6 @@ LIBASSERT_BEGIN_NAMESPACE
         return highlight(stringify(t), scheme);
     }
 
-    // generates a stack trace, formats to the given width
-    [[nodiscard]] LIBASSERT_ATTR_NOINLINE LIBASSERT_EXPORT
-    std::string stacktrace(int width = 0, const color_scheme& scheme = get_color_scheme(), std::size_t skip = 0);
-
     enum class literal_format : unsigned {
         // integers and floats are decimal by default, chars are of course chars, and everything else only has one
         // format that makes sense
@@ -162,6 +158,20 @@ LIBASSERT_BEGIN_NAMESPACE
         basename,
     };
     LIBASSERT_EXPORT void set_path_mode(path_mode mode);
+    LIBASSERT_EXPORT path_mode get_path_mode();
+
+    // generates a stack trace, formats to the given width
+    [[nodiscard]] LIBASSERT_ATTR_NOINLINE LIBASSERT_EXPORT
+    std::string stacktrace(int width = 0, const color_scheme& scheme = get_color_scheme(), std::size_t skip = 0);
+
+    // formats a stacktrace
+    [[nodiscard]] LIBASSERT_EXPORT
+    std::string print_stacktrace(
+        const cpptrace::stacktrace& trace,
+        int width = 0,
+        const color_scheme& scheme = get_color_scheme(),
+        path_mode = get_path_mode()
+    );
 
     enum class assert_type {
         debug_assertion,

src/assert.cpp

@@ -391,9 +391,12 @@ LIBASSERT_BEGIN_NAMESPACE
         current_path_mode = mode;
     }
 
+    path_mode get_path_mode() {
+        return current_path_mode;
+    }
+
     namespace detail {
-        std::unique_ptr<detail::path_handler> new_path_handler() {
-            auto mode = current_path_mode.load();
+        std::unique_ptr<detail::path_handler> new_path_handler(path_mode mode = get_path_mode()) {
             switch(mode) {
                 case path_mode::disambiguated:
                     return std::make_unique<disambiguating_path_handler>();
@@ -404,7 +407,6 @@ LIBASSERT_BEGIN_NAMESPACE
                     return std::make_unique<identity_path_handler>();
             }
         }
-
     }
 
     [[noreturn]] LIBASSERT_EXPORT
@@ -714,4 +716,22 @@ LIBASSERT_BEGIN_NAMESPACE
         detail::identity_path_handler handler;
         return print_stacktrace(trace, width, scheme, &handler);
     }
+
+    [[nodiscard]]
+    std::string print_stacktrace(
+        const cpptrace::stacktrace& trace,
+        int width,
+        const color_scheme& scheme,
+        path_mode mode
+    ) {
+        auto path_handler = new_path_handler(mode);
+        // if this is a disambiguating handler or similar it needs to be fed all paths
+        if(path_handler->has_add_path()) {
+            for(const auto& frame : trace.frames) {
+                path_handler->add_path(frame.filename);
+            }
+            path_handler->finalize();
+        }
+        return print_stacktrace(trace, width, scheme, path_handler.get());
+    }
 LIBASSERT_END_NAMESPACE

src/libassert.cppm

@@ -25,13 +25,15 @@ LIBASSERT_BEGIN_NAMESPACE
     export using libassert::highlight;
     export using libassert::highlight_stringify;
     export using libassert::stacktrace;
+    export using libassert::print_stacktrace;
     export using libassert::literal_format;
     export using libassert::operator|;
     export using libassert::literal_format_mode;
     export using libassert::set_literal_format_mode;
     export using libassert::set_fixed_literal_format;
     export using libassert::path_mode;
     export using libassert::set_path_mode;
+    export using libassert::get_path_mode;
     export using libassert::assert_type;
     export using libassert::default_failure_handler;
     export using libassert::handler_ptr;