SwiftyBeaver/SwiftyBeaver
SwiftyBeaver
SwiftyBeaver is an extensible logging framework for Swift that routes log output to multiple destinations simultaneously, including the Xcode console, local files, and remote cloud services. It supports recording messages at distinct severity levels with corresponding visual styling, and can attach arbitrary contextual data such as numbers, arrays, or dictionaries to log entries without requiring manual string conversion.
The framework distinguishes itself through destination-based log routing, where each output target can have its own independent format and filter configuration managed by a central dispatch mechanism. It provides color-coded console output that applies ANSI color codes based on severity level for visual differentiation in terminal and Xcode console output, and supports template-driven formatting that allows users to define the structure and order of fields in log messages using customizable template strings.
SwiftyBeaver also offers file logging with rotation and appending capabilities to manage log file lifecycles based on size or date, and cloud transport serialization that formats log entries into JSON or custom formats for transmission to remote logging services over HTTP. The framework is compatible with server-side Swift environments, including Linux, Docker, and the Vapor web framework, enabling backend logging in production deployments.
Features
- Swift - An extensible logging library for Swift that outputs messages to console, files, and cloud services with customizable formatting and severity levels.
- Multi-Destination Log Routers - Routes log output to several destinations simultaneously, such as console, file, and cloud, each with its own format.
- Console Color Mappings - Applies ANSI color codes to log messages based on severity level for visual differentiation in console output.
- Severity-Based Console Colorizers - Outputs color-coded log messages to the Xcode debug console for real-time inspection during development.
- Developer Console Logging - Sends formatted log output directly to the Xcode debug console for real-time inspection during development.
- Console Log Formatters - Outputs color-coded log messages to the Xcode console during development, with customizable log levels and formatting.
- Severity Level Styling - Records messages at distinct priority levels with corresponding visual styling for verbose, debug, info, warning, and error.
- Log File Writers - Writes log entries to a local file for persistent storage and later review outside the development environment.
- Structured Log Field Attachments - Attaches arbitrary key-value pairs or structured data to log entries without requiring manual string conversion.
- Server Side Swift - Runs on Linux and inside Docker containers, integrating with server-side Swift frameworks like Vapor for backend logging.
- Cloud Transport Serializers - Serializes log entries into JSON or custom formats for transmission to remote cloud logging services over HTTP.
- Log File Rotators - Manages log file lifecycle by rotating files based on size or date and appending new entries to existing files.
- Template Formatting Engines - Formats log messages by substituting placeholders in a user-defined template string with runtime values.
- Cloud Log Destinations - Sends log data to remote services like Google Cloud Platform for centralized aggregation and analysis.
- Custom Log Formatting - Formats log messages using a customizable template string that controls which fields appear and in what order.
- Arbitrary Data Type Loggers - Accepts and logs any value, including numbers, dates, arrays, and dictionaries, without requiring string conversion.
- Contextual Logging - Attaches extra context, such as numbers, arrays, or dictionaries, to log messages for richer debugging information.
- Context Attachments - Attaches extra contextual data such as numbers, arrays, or dictionaries to log entries for richer debugging information.
- Log Output Formatting - Formats log output with a template string, supporting variables for time, log level, message, and JSON structure.
- Cloud Log Shippers - Formats and sends log output to cloud services like Google Cloud Platform, supporting JSON and custom formats.
- Remote Log Transmission - Transmits log data to a remote cloud service for centralized aggregation and analysis across multiple sessions.
- Logging and Debugging - Convenient logging for development and production.
- Logging Utilities - Provides multi-platform logging for development and production.
