Add new convenience initializer for simple LoggingSystem bootstrap

Author: Frizlab

Package.swift

@@ -15,7 +15,7 @@ let package = Package(
 		.target(name: "JSONLogger", dependencies: [
 			.product(name: "GenericJSON",   package: "generic-json"),
 			.product(name: "Logging",       package: "swift-log"),
-		], path: "Sources"),
+		], path: "Sources", exclude: ["JSONLogger+WithSendable.swift"]),
 		.testTarget(name: "JSONLoggerTests", dependencies: ["JSONLogger"]),
 	]
 )

[email protected]

@@ -24,7 +24,7 @@ let package = Package(
 		.target(name: "JSONLogger", dependencies: [
 			.product(name: "GenericJSON",   package: "generic-json"),
 			.product(name: "Logging",       package: "swift-log"),
-		], path: "Sources", swiftSettings: swiftSettings),
+		], path: "Sources", exclude: ["JSONLogger+NoSendable.swift"], swiftSettings: swiftSettings),
 		.testTarget(name: "JSONLoggerTests", dependencies: ["JSONLogger"], swiftSettings: swiftSettings),
 	]
 )

Sources/JSONLogger+NoSendable.swift

@@ -0,0 +1,15 @@
+import Foundation
+
+import Logging
+
+
+
+extension JSONLogger {
+	
+	public init(label: String, metadataProvider: Logger.MetadataProvider? = LoggingSystem.metadataProvider) {
+		/* The fileHandle argument should be present to avoid infinite recursion
+		 *  but its value should be the same as the default value of the initializer we’re calling (for API consistency). */
+		self.init(label: label, fileHandle: .standardOutput, metadataProvider: metadataProvider)
+	}
+	
+}

Sources/JSONLogger+WithSendable.swift

@@ -0,0 +1,19 @@
+import Foundation
+
+import Logging
+
+
+
+/* The @Sendable attribute is only available starting at Swift 5.5.
+ * We make these methods only available starting at Swift 5.8 for our convenience (avoids creating another Package@swift-... file)
+ *  and because for Swift <5.8 the non-@Sendable variants of the methods are available. */
+extension JSONLogger {
+	
+	@Sendable
+	public init(label: String, metadataProvider: Logger.MetadataProvider? = LoggingSystem.metadataProvider) {
+		/* The fileHandle argument should be present to avoid infinite recursion
+		 *  but its value should be the same as the default value of the initializer we’re calling (for API consistency). */
+		self.init(label: label, fileHandle: .standardOutput, metadataProvider: metadataProvider)
+	}
+	
+}

Tests/JSONLoggerTests/JSONLoggerTests.swift

@@ -29,7 +29,7 @@ final class JSONLoggerTests : XCTestCase {
 	}()
 
 	override class func setUp() {
-		LoggingSystem.bootstrap{ JSONLogger(label: $0) }
+		LoggingSystem.bootstrap(JSONLogger.init, metadataProvider: nil)
 	}
 
 	/* From <https://apple.github.io/swift-log/docs/current/Logging/Protocols/LogHandler.html#treat-log-level-amp-metadata-as-values>. */