First commit

Author: tataruRobert

.gitignore

@@ -0,0 +1,9 @@
+.DS_Store
+/.build
+/Packages
+xcuserdata/
+DerivedData/
+.swiftpm/configuration/registries.json
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+.netrc
+.swiftpm/xcode/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tech Artists Agency
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Package.resolved

@@ -0,0 +1,57 @@
+/*
+MIT License
+
+Copyright (c) 2025 Tech Artists Agency
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+*/
+
+// swift-tools-version: 6.0
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "SwiftLogFileLogHandler",
+    platforms: [ .iOS(.v14), .macOS(.v10_13)],
+    products: [
+        // Products define the executables and libraries a package produces, making them visible to other packages.
+        .library(
+            name: "SwiftLogFileLogHandler",
+            targets: ["SwiftLogFileLogHandler"]),
+    ],
+    dependencies: [
+        .package(
+            url: "https://github.com/apple/swift-log.git",
+            from: "1.6.1"
+        )
+    ],
+    targets: [
+        .target(
+            name: "SwiftLogFileLogHandler",
+            dependencies: [
+                .product(name: "Logging", package: "swift-log")
+            ]
+        ),
+        .testTarget(
+            name: "SwiftLogFileLogHandlerTests",
+            dependencies: ["SwiftLogFileLogHandler"]
+        ),
+    ]
+)

Package.swift

@@ -0,0 +1,86 @@
+# SwiftLogFileLogHandler
+
+**SwiftLogFileLogHandler** is a file-based logging backend for Apple’s [swift-log](https://github.com/apple/swift-log). It provides automatic log file rotation and structured metadata handling.
+
+---
+
+## Features
+
+- **File-based Logging**: Persist logs to files for later analysis.
+- **Automatic Log Rotation**: Ensures that log files are managed efficiently.
+- **Metadata Support**: Includes structured metadata with each log entry.
+
+---
+
+## Installation
+
+### Swift Package Manager
+
+To include **SwiftLogFileLogHandler** in your project, add it to your `Package.swift` file:
+
+```swift
+let package = Package(
+    name: "YourProject",
+    platforms: [
+        .iOS(.v14),
+        .macOS(.v10_13)
+    ],
+    dependencies: [
+        .package(
+            url: "git@github.com:TechArtists/ios-swift-log-file-log-handler.git",
+            from: "1.0.0"
+        )
+    ],
+    targets: [
+        .target(
+            name: "YourTarget",
+            dependencies: [
+                .product(name: "SwiftLogFileLogHandler", package: "ios-swift-log-file-log-handler")
+            ]
+        )
+    ]
+)
+```
+
+Alternatively, to add the package using Xcode:
+
+    1. Navigate to File > Add Packages.
+    2. Enter the repository URL: `git@github.com:YourRepo/SwiftLogFileLogHandler.git`.
+    3. Add the package to your target.
+
+## Usage
+
+### Basic Logging Example
+
+```swift
+import Logging
+import SwiftLogFileLogHandler
+
+let logger = Logger(label: "com.yourapp.main") { label in
+    SwiftLogFileLogHandler(label: label)
+}
+
+logger.info("Application started successfully.")
+logger.warning("Low disk space detected.")
+```
+
+### Accessing Log Files
+
+To retrieve the current log file or combined stashed logs:
+
+```swift
+if let logFileURL = logger.getCurrentLogFileURL() {
+    print("Current log file located at: \(logFileURL)")
+}
+
+if let combinedLogsURL = logger.getCombinedStashedLogFilesURL() {
+    print("Combined log file at: \(combinedLogsURL)")
+}
+
+let stashedCount = logger.getCurrentStashedCount()
+print("Number of stashed log files: \(stashedCount)")
+```
+
+## License
+
+This project is licensed under the MIT License. See the LICENSE file for more details.