Repository navigation
[Summary]
StormByte Logger is the stream-logging module of the StormByte C++ suite.
It depends directly on StormByte Base 3.0.0 and StormByte-BuildMaster >= 2.1.4. This repository is not Base, Buffer, Config, Crypto, Database, Multimedia, Network or System.
Public headers under StormByte/logger/ cover Log, ThreadedLog, header formats (%L %T %i %c %g), hierarchical components and Scope facades, groups, ANSI colors, temporary formats, human-readable numbers and bytes, redaction of text and numbers, hex dumps (hex / nohex), and binary payloads (std::span<const std::byte>, std::vector<std::byte> and StormByte::Safe::Binary, default Base64). Owned text that crosses the logger DLL boundary uses StormByte::Safe::String / WString; StormByte::Size and StormByte::ByteSize are accepted as payloads. Views and caller-owned std::string are consumed synchronously. group, component and push_format are caller-side factories: a literal binds to const char*, std::string and std::string_view bind to the view, and StormByte::Safe::String binds by identity. The owned text is built in the caller.
From 2.0.0, original Logger sources are dual-licensed: GNU Lesser General Public License v3.0 or later, or a commercial license from the copyright holder. That change does not cover other StormByte modules or third-party material under thirdparty/ (including bundled StormByte Base).
If you landed here from a release link and have not read the tree:
- What this module is, how to build it, and short examples: README.md
- License: dual license LGPL-3.0-or-later or commercial, LICENSE
Added
- Install
FindStormByteLogger.cmakeso Base 3.0.0 can discover Logger as a component.
Changed
- Breaking: Require Base 3.0.0 and select its Linux archive by architecture, libc and C++ standard library. Previous archive names and component packages without their own finder are unsupported.
- Require StormByte-BuildMaster 2.1.4 and pin the bundled submodule to that release.
- Leave CPU targeting and build-type optimization levels to the toolchain instead of imposing architecture-specific flags;
ENABLE_LTOstill controls interprocedural optimization. - Build the same Linux amd64/arm64, glibc/musl and GCC/libstdc++ or Clang/libc++ variants in CI and releases. CI disables PGO and LTO; releases enable both and use the shared action's automatic CPU baselines.
- Breaking: Linux release ZIP names now include
amd64orarm64, libc and C++ standard library; previous asset names are not supported.
Fixed
- PGO training runner now prepends its library directories to
LD_LIBRARY_PATH/DYLD_LIBRARY_PATHwith the:separator (previously;, which broke library lookup on musl) and no longer appends an empty entry when the variable is unset. - Reconfigure automatically when
VERSIONchanges so rebuilt and installed artifacts use the updated project version.