Add print logger (#829)

To support VSCode/Cursor envs or where OSLog is broken

Author: pblazej

Sources/LiveKit/LiveKit.swift

@@ -15,12 +15,8 @@
  */
 
 import Foundation
-import OSLog
 internal import LiveKitWebRTC
 
-// Lazily initialized to the first logger
-let sharedLogger = LiveKitSDK.state.logger
-
 /// The open source platform for real-time communication.
 ///
 /// See [LiveKit's Online Docs](https://docs.livekit.io/) for more information.
@@ -80,3 +76,6 @@ public class LiveKitSDK: NSObject, Loggable {
         DeviceManager.prepare()
     }
 }
+
+// Lazily initialized to the first logger
+let sharedLogger = LiveKitSDK.state.logger

Sources/LiveKit/Support/Logger.swift

@@ -66,6 +66,45 @@ public struct DisabledLogger: Logger {
     ) {}
 }
 
+/// A simple `print` logger suitable for debugging in terminal environments outside Xcode
+public struct PrintLogger: Logger {
+    private let minLevel: LogLevel
+    private let colors: Bool
+
+    public init(minLevel: LogLevel = .info, colors: Bool = true) {
+        self.minLevel = minLevel
+        self.colors = colors
+    }
+
+    public func log(
+        _ message: @autoclosure () -> CustomStringConvertible,
+        _ level: LogLevel,
+        source _: @autoclosure () -> String?,
+        file _: StaticString,
+        type: Any.Type,
+        function: StaticString,
+        line _: UInt,
+        metaData _: ScopedMetadataContainer
+    ) {
+        guard level >= minLevel else { return }
+        print("[\(colorCode(level))\(level)\(resetCode)] \(type).\(function) \(message())")
+    }
+
+    private func colorCode(_ level: LogLevel) -> String {
+        guard colors else { return "" }
+        switch level {
+        case .debug: return "\u{001B}[36m"
+        case .info: return "\u{001B}[94m"
+        case .warning: return "\u{001B}[33m"
+        case .error: return "\u{001B}[31m"
+        }
+    }
+
+    private var resetCode: String {
+        colors ? "\u{001B}[0m" : ""
+    }
+}
+
 /// A logger that logs to OSLog
 /// - Parameter minLevel: The minimum level to log
 /// - Parameter rtc: Whether to log WebRTC output
@@ -172,7 +211,7 @@ extension Loggable {
 
 @objc
 @frozen
-public enum LogLevel: Int, Sendable, Comparable {
+public enum LogLevel: Int, Sendable, Comparable, CustomStringConvertible {
     case debug
     case info
     case warning
@@ -201,6 +240,15 @@ public enum LogLevel: Int, Sendable, Comparable {
     public static func < (lhs: LogLevel, rhs: LogLevel) -> Bool {
         lhs.rawValue < rhs.rawValue
     }
+
+    public var description: String {
+        switch self {
+        case .debug: "Debug"
+        case .info: "Info"
+        case .warning: "Warning"
+        case .error: "Error"
+        }
+    }
 }
 
 extension LKRTCLoggingSeverity {