Releases: 0xLeif/Scribe
2.0.2
2.0.1
Full Changelog: 2.0.0...2.0.1
2.0.0
1.3.2
Full Changelog: 1.3.1...1.3.2
1.3.1
Full Changelog: 1.3.0...1.3.1
1.3.0
1.2.0
1.1.0
1.0.0
0.1.1
What's Changed
Full Changelog: 0.1.0...0.1.1
Scribe
📜 Logging all events
Scribe is a flexible logging library for Swift, designed to make logging easy and efficient. It provides a centralized system for logging messages and events within your application, and supports multiple logging outputs and plugins to extend its capabilities to meet your needs. Scribe integrates with swift-log for console logging, making it a versatile solution for all your logging requirements.
Usage
Creating a ScribePlugin
To create a Scribe plugin, you need to create a struct or class that conforms to the ScribePlugin protocol and implement its requirements. Here is an example of a simple plugin that increments a count for each log:
class CountPlugin: ScribePlugin {
static let shared = CountPlugin()
var count: Int = 0
private init() {}
func handle(value: Scribe.PluginPayload, output: inout ()) async throws {
count += 1
}
}
Registering plugins to Scribe
Once you have created your Scribe Plugin, you just need to register it with your Scribe object. There are two ways to do this:
- Pass the plugin to the plugins parameter when creating the Scribe object:
let scribe = Scribe(
label: "test.count",
plugins: [
CountPlugin.shared
]
)
- Call
scribe.register(plugin:)
to add the plugin to an existing Scribe object:
let scribe = Scribe(label: "test.count")
scribe.register(plugin: CountPlugin.shared)
Logging to Scribe
Scribe uses swift-log for logging, so the functions are similar in usage. To log a message with Scribe, simply call one of the logging functions, such as debug:
scribe.debug("Test")
Log Levels
Scribe supports the following log levels:
trace
debug
info
notice
warning
error
critical
Choose the appropriate log level depending on the importance and urgency of the message you are logging.