Logging
A version of Apple's SwiftLog that adds some improved formatting for app development and includes OSLog-ish string interpolation.
Feature List
-
Privacy (public, private and masked) -
Log levels -
FormattedLogHandler -
Literal string -
Numerical formats -
Boolean formats - Exponential formats
- Hexadecimal formats
- Column formatting
I've also added many tests to ensure the string interpolation and privacy features are working as expected. However, I have not included any of SwiftLog's tests since the library is simply a direct copy (see below).
Examples
// Somewhere in your code, define your log handler(s)
LoggingSystem.bootstrap { label in
FormattedLogHandler(label: label)
}
// Then in a framework or subsystem, define a logger
let logger = Logger(label: "com.benkau.logging")
logger.debug("Hello, world!")
Similar to OSLog, all interpolated values default to a private scope (in a non-DEBUG) environment, with their values redacted.
logger.debug("Logged in as \(user, privacy: .private)")
// Logged in as <redacted>
logger.debug("Fetching data from \(url, privacy: .private(.hash))")
// Fetching data from 210237823
There are conveniences for logging numerical values:
logger.debug("Pi is \(3.14159265359, format: .fixed(precision: 2))")
// Pi is 3.14
logger.debug("Current score: \(score, format: .decimal(minDigits: 2)")
// Current score: 03
Formatting
The library includes a custom FormattedLogHandler that you're free to use or create your own. The provided handler uses SFSymbols to improve readability and clarity in the console, as well as providing a simple closure based formatter so you can make it your own.
FormattedLogHandler { options in
// simply return your formatted log
FormattedLogHandler(label: label) { data in
"\(data.timestamp()) [\(data.label)] \(data.level.symbol) \(data.message)"
}
}
Obviously you can always use your own
LogHandleras you can directly with SwiftLog.
SwiftLog
The actual logging framework is a direct copy of Apple's own SwiftLog. The reason I didn't include it as a dependency is because there was no way for me to extend it to include string interpolation that I could see. If anyone has ideas on how to make this work, I would love to hear about them. Please open an Issue so we can discuss it as this would allow me to properly attribute and pin to a dependency version etc...
Installation
The code is packaged as a framework. You can install manually (by copying the files in the Sources directory) or using Swift Package Manager (preferred)
To install using Swift Package Manager, add this to the dependencies section of your Package.swift file:
.package(url: "https://github.com/shaps80/Logging.git", .upToNextMinor(from: "1.0.0"))
968 Dec 25, 2022
3 Nov 22, 2022
10 Oct 26, 2022
16.9k Dec 30, 2022
222 Dec 17, 2022
1.8k Jan 3, 2023
1.4k Jan 5, 2023
12.5k Jan 3, 2023
376 Nov 8, 2022
96 Nov 24, 2022
2.2k Dec 22, 2022
1k Dec 23, 2022
704 Dec 17, 2022
3.8k Dec 20, 2022
203 Nov 22, 2022
1.5k Dec 30, 2022
68 Oct 26, 2022
846 Nov 22, 2022
466 Sep 9, 2022