Merge pull request #34 from sukov/version-2.1

Version 2.1.0

Author: sukov

CachingPlayerItem.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = 'CachingPlayerItem'
-  s.version          = '2.0.2'
+  s.version          = '2.1.0'
   s.summary          = 'Cache & Play audio and video files'
 
   s.homepage         = 'https://github.com/sukov/CachingPlayerItem'

Example/Podfile.lock

@@ -1,5 +1,5 @@
 PODS:
-  - CachingPlayerItem (2.0.1)
+  - CachingPlayerItem (2.1.0)
   - Nimble (9.2.1)
   - Quick (4.0.0)
 
@@ -18,7 +18,7 @@ EXTERNAL SOURCES:
     :path: "../"
 
 SPEC CHECKSUMS:
-  CachingPlayerItem: 7a369d20ddc09f5ac79322fd8ecd5f8369523216
+  CachingPlayerItem: 6bde08e430aaea51b65cf6b460f0e1497644113a
   Nimble: e7e615c0335ee4bf5b0d786685451e62746117d5
   Quick: 6473349e43b9271a8d43839d9ba1c442ed1b7ac4
 

Example/Pods/Local Podspecs/CachingPlayerItem.podspec.json

@@ -0,0 +1,68 @@
+//
+//  AppLogger.swift
+//  CachingPlayerItem
+//
+//  Created by Gorjan Shukov on 07/17/25.
+//
+
+import Foundation
+
+/// Log levels for `AppLogger`.
+public enum LogLevel: Int, Comparable, CustomStringConvertible {
+    case none = 0
+    case info
+    case warning
+    case error
+
+    /// Emoji representation of the log level.
+    public var description: String {
+        switch self {
+        case .info:
+            return "ℹ️"
+        case .warning:
+            return "⚠️"
+        case .error:
+            return "🔴"
+        case .none:
+            return ""
+        }
+    }
+
+    /// Comparable conformance.
+    public static func < (lhs: LogLevel, rhs: LogLevel) -> Bool {
+        lhs.rawValue < rhs.rawValue
+    }
+}
+
+/// Internal logger for the library.
+final class AppLogger {
+    private static let dateFormatter: DateFormatter = {
+        let formatter = DateFormatter()
+        formatter.dateFormat = "yyyy-MM-dd HH:mm:ss"
+        return formatter
+    }()
+
+    static var currentLevel: LogLevel { CachingPlayerItemConfiguration.logLevel }
+
+    static func info(_ message: @autoclosure () -> String, file: String = #file, function: String = #function, line: Int = #line) {
+        log(.info, message(), file: file, function: function, line: line)
+    }
+
+    static func warning(_ message: @autoclosure () -> String, file: String = #file, function: String = #function, line: Int = #line) {
+        log(.warning, message(), file: file, function: function, line: line)
+    }
+
+    static func error(_ message: @autoclosure () -> String, file: String = #file, function: String = #function, line: Int = #line) {
+        log(.error, message(), file: file, function: function, line: line)
+    }
+
+    /// Logs a message if the specified log level is greater than or equal to the current log level.
+    private static func log(_ level: LogLevel, _ message: @autoclosure () -> String, file: String, function: String, line: Int) {
+        guard level >= currentLevel, currentLevel != .none else { return }
+
+        let fileName = (file as NSString).lastPathComponent
+        let timestamp = dateFormatter.string(from: Date())
+
+        print("[CachingPlayerItem \(level)] [\(timestamp)] [\(fileName):\(line)] \(function) > \(message())")
+    }
+}

Example/Pods/Manifest.lock

@@ -47,6 +47,7 @@ public final class CachingPlayerItem: AVPlayerItem {
 
     /// Useful for keeping relevant model associated with CachingPlayerItem instance. This is a **strong** reference, be mindful not to create a **retain cycle**.
     public var passOnObject: Any?
+    /// `delegate` for status updates.
     public weak var delegate: CachingPlayerItemDelegate?
 
     // MARK: Public init
@@ -276,14 +277,15 @@ public final class CachingPlayerItem: AVPlayerItem {
         switch status {
         case .readyToPlay:
             // Player item is ready to play.
+            AppLogger.info("CachingPlayerItem status: ready to play")
             DispatchQueue.main.async { self.delegate?.playerItemReadyToPlay?(self) }
         case .failed:
             // Player item failed. See error.
-            print("CachingPlayerItem status: failed with error: \(String(describing: error))")
+            AppLogger.error("CachingPlayerItem status: failed with error: \(String(describing: error))")
             DispatchQueue.main.async { self.delegate?.playerItemDidFailToPlay?(self, withError: self.error) }
         case .unknown:
             // Player item is not yet ready.
-            print("CachingPlayerItem status: uknown with error: \(String(describing: error))")
+            AppLogger.error("CachingPlayerItem status: uknown with error: \(String(describing: error))")
         @unknown default:
             break
         }

Example/Pods/Pods.xcodeproj/project.pbxproj

@@ -24,6 +24,9 @@ public enum CachingPlayerItemConfiguration {
 
     /// Flag for deciding whether an `NSFileWriteOutOfSpaceError` should be thrown when there is not enough available disk space left for caching the entire media file. Defaults to `true`.
     public static var shouldCheckAvailableDiskSpaceBeforeCaching: Bool = true
+
+    /// Log level. Defaults to `none`.
+    public static var logLevel: LogLevel = .none
 }
 
 fileprivate extension Int {

Example/Pods/Target Support Files/CachingPlayerItem/CachingPlayerItem-Info.plist

@@ -23,7 +23,7 @@ final class MediaFileHandle {
         if !FileManager.default.fileExists(atPath: filePath) {
             FileManager.default.createFile(atPath: filePath, contents: nil, attributes: nil)
         } else {
-            print("CachingPlayerItem warning: File already exists at \(filePath). A non empty file can cause unexpected behavior.")
+            AppLogger.warning("File already exists at \(filePath). A non empty file can cause unexpected behavior.")
         }
     }
 
@@ -47,7 +47,7 @@ extension MediaFileHandle {
         do {
             return try FileManager.default.attributesOfItem(atPath: filePath)
         } catch let error as NSError {
-            print("FileAttribute error: \(error)")
+            AppLogger.error("Failed fetching attributes for \(filePath) with error: \(error)")
         }
         return nil
     }
@@ -92,7 +92,7 @@ extension MediaFileHandle {
         do {
             try FileManager.default.removeItem(atPath: filePath)
         } catch let error {
-            print("File deletion error: \(error)")
+            AppLogger.error("File deletion failed at \(filePath) with error: \(error)")
         }
     }
 }