DaveWoodCom/XCGLogger
XCGLogger
XCGLogger is a logging framework for Swift applications designed to capture events and system state for debugging and troubleshooting. It automatically includes metadata such as timestamps, line numbers, function names, and filenames in every log entry.
The framework minimizes CPU overhead through deferred string evaluation, which delays expensive interpolation until the active log level is verified. To prevent blocking the main execution thread during I/O tasks, it utilizes an asynchronous log router that offloads writing operations to background queues.
The system supports multi-destination routing, allowing log data to be sent to the console and local files with independent filters and formatters. File-based management includes persistence with automatic rotation based on file size or age. Terminal output can be visually distinguished using ANSI color codes based on severity levels.
The project provides extensibility through protocol-based destinations, filters, and formatters, enabling the integration of custom logic and third-party services.
Features
- Swift - Provides a comprehensive logging framework for Swift applications with customizable formatting and severity levels.
- Multi-Destination Log Routers - Routes log events to multiple heterogeneous destinations, including consoles and files, using configurable rules.
- Deferred Log Evaluation - Delays expensive string interpolation until the active log level is verified to save CPU cycles.
- Background I/O Queues - Offloads log writing operations to background queues to prevent blocking the main execution thread.
- Log Metadata Injectors - Automatically attaches runtime context such as function names, filenames, and line numbers to log entries.
- Application Event Recording - Captures and writes runtime diagnostic messages and metadata to persistent storage or consoles.
- Asynchronous Log Processing - Processes log entries on background worker threads to prevent blocking the main application execution path.
- Extensible Logging Logic - Offers a protocol-based system for implementing custom logging destinations, filters, and formatters.
- Log File Rotators - Manages log file lifecycles by rotating files based on size or date and appending new entries.
- Log Performance Optimizations - Uses deferred evaluation and severity filtering to minimize CPU overhead during active development.
- Service Message Filters - Filters log entries based on runtime metadata such as filenames, tags, or developer identities.
- Multi-Destination Log Routings - Sends log data to multiple destinations with independent filters and formatters for each target.
- Extensible Log Destinations - Enables the integration of custom logging logic and third-party services through protocol-based destinations.
- Log File Rotation - Automatically manages log file sizes by rolling over to new files when size or age limits are reached.
- Metadata-Based Log Filtering - Filters logs based on runtime metadata such as filenames, user-defined tags, or developer identities.
- Log File Writers - Provides utilities for writing log records to external files with configurable formatting.
- Logging Utilities - Debug logging framework.
- Logging and Debugging - Debug logging framework with console and file support.
- Logging Utilities - Features a full-featured logging utility with log levels.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
