lwlog: A High-Performance C++17 Logging Library

lwlog is a high-efficiency, versatile logging library for C++17 that offers both synchronous and asynchronous capabilities. Prioritized for speed and performance, it is designed to allow developers to integrate advanced logging features with minimal impact on their application's efficiency.

Key Features

• High Performance: Optimized for speed with both synchronous and asynchronous logging options. Benchmarks demonstrate superior performance compared to leading libraries.
• Easily Configurable: Built with policy classes that allow users to tailor how the logger operates to match your application's exact requirements.
• Extensibility: Easily extendable with custom sinks and loggers. Create custom behaviors or integrate into unique workflows with minimal effort.
• Dynamic Topics and Attributes: Organize logs with hierarchical topics and enhance messages with custom attributes for additional context.
• Rich Formatting Options: Offers an intuitive pattern syntax for alignment, colors, and dynamic FMT-style formatting, enabling highly customized log outputs.
• Modern C++ Design: Written in C++17, utilizing modern practices for clean, maintainable, and efficient code.
• Thread-Safety Options: Flexibly supports thread-safe and non-thread-safe implementations to accommodate both single-threaded and concurrent applications.
• Global Logger Registry: Centralized access to all loggers, simplifying management and configuration in complex systems.

Design Highlights

• Code Base: The code is crafted with clarity, elegance, and readability in mind, hoping it is structured enough to prove relatively easy for developers to understand, modify, extend, and learn from.
• Performance: lwlog offers very fast logging capabilities, both in synchronous and asynchronous modes, ensuring minimal impact on your application’s performance.
• Extensibility: Adding new types of sinks and loggers is straightforward, providing flexibility to adapt the library to your specific needs. Check out how to create your own sink for a practical example
• Configurability: lwlog uses policy classes which you can just plug in based on your needs.
• Ease of Use: lwlog tries to follow a philosophy of intuitiveness. As the author, I am biased, so I can only hope the API is as intuitive as I see it in my eyes. Convenient easy-to-use predefined types(convenience aliases) are made for simplicity without too much configuration. Most of the time, you will be just fine with using the predefined types.

Usage

Basic Example

#include "lwlog.h"

int main() {
    auto console = std::make_shared<lwlog::async_console_logger>("ConsoleLogger");
    console->set_level_filter(lwlog::level::info | lwlog::level::debug);
    console->set_pattern("[%T] [%n] [%l]: %v");
    console->critical("Initializing critical log message");
    return 0;
}

Advanced Benchmarks

• Extensive benchmarks against industry standards like spdlog showcase lwlog's superior speed and efficiency, particularly in high-load, asynchronous environments, where it exhibits remarkable message handling and faster throughput.

Why Choose lwlog?

lwlog is more than just a logging library; it represents a commitment to the craft of software development. Born from a desire to improve and excel, it encapsulates a journey from novice to mastery, ensuring both practical utility and a refined touch for software artisans. Built with a focus on clarity, performance, and extensibility, it assures developers a reliable and robust toolkit for their logging needs.

For Further Learning

• Explore custom configurations and predefined logger aliases to maximize lwlog’s capabilities.
• For custom sinks and advanced configuration, refer to the detailed documentation and examples.

Whether starting a new project or enhancing an existing one, lwlog equips developers with trusted logging utilities, ensuring clarity and precision without compromise.