Swift Network Manager
KNetKitSwift is a lightweight Swift networking library that uses async/await and URLSession to perform API requests. It’s designed to be highly configurable and easily integrated into your app with minimal setup.
- Async/Await Support: Easily perform network requests using Swift concurrency.
- Customizable Configuration: Configure your base URL, headers, timeout, and more.
- Authentication Support: Use a custom auth provider to automatically add authorization headers.
- Logging: Log requests and responses for debugging.
- Centralized Setup: Use
AppNetworkServiceto initialize and access your network manager globally.
Add MyNetworkPackage to your project via Swift Package Manager.
- In Xcode, open your project.
- Navigate to File > Swift Packages > Add Package Dependency...
- Enter the GitHub repository URL for MyNetworkPackage.
- Follow the prompts to add the package to your project.
dependencies: [
.package(url: "https://github.com/kusalrajapaksha/KNetKitSwift.git", from: "1.0.0")
]
In your app, create your custom configuration, authentication provider, and logger.
import Foundation
import KNetKitSwift
struct AppNetworkConfiguration: KNetKitManagerConfiguration {
var baseURL: URL {
URL(string: "https://your-api.com")! // Change to your API base URL.
}
var defaultHeaders: [String: String] {
["Content-Type": "application/json"]
}
var timeoutInterval: TimeInterval {
30.0 // Timeout interval in seconds.
}
var sessionConfiguration: URLSessionConfiguration {
let config = URLSessionConfiguration.default
config.timeoutIntervalForRequest = timeoutInterval
return config
}
}import Foundation
import KNetKitSwift
actor SimpleAuthProvider: KNetKitAuthProvider {
var authToken: String? {
get async { "your_access_token" } // Retrieve your token securely.
}
var tokenType: String? {
get async { "Bearer" }
}
}import Foundation
import KNetKitSwift
struct ConsoleLogger: KNetKitLogger {
func log(request: URLRequest) {
print("➡️ Request: \(request.httpMethod ?? "") \(request.url?.absoluteString ?? "")")
if let headers = request.allHTTPHeaderFields {
print("Headers: \(headers)")
}
if let body = request.httpBody, let bodyString = String(data: body, encoding: .utf8) {
print("Body: \(bodyString)")
}
}
func log(response: HTTPURLResponse?, data: Data?) {
print("⬅️ Response: \(response?.statusCode ?? 0)")
if let data = data, let responseBody = String(data: data, encoding: .utf8) {
print("Response Body: \(responseBody)")
}
}
func log(error: Error, forRequest request: URLRequest) {
print("❌ Error: \(error.localizedDescription) for \(request.url?.absoluteString ?? "")")
}
}Create an AppNetworkService class that initializes your network manager with the above dependencies. This ensures your configuration is set up once and is available globally.
import Foundation
import KNetKitSwift
final class AppNetworkService {
static let shared = AppNetworkService() // Singleton instance.
let networkManager: KNetKitManager
private init() {
let config = AppNetworkConfiguration()
let authProvider = SimpleAuthProvider()
let logger = ConsoleLogger()
self.networkManager = KNetKitManager(
configuration: config,
authProvider: authProvider,
logger: logger
)
}
}For SwiftUI apps, initialize it in your @main App struct. For UIKit apps, you can initialize it in your AppDelegate.
import SwiftUI
import KNetKitSwift
@main
struct MyApp: App {
init() {
_ = AppNetworkService.shared // Initializes the network service.
}
var body: some Scene {
WindowGroup {
ContentView()
}
}
}import UIKit
import KNetKitSwift
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
_ = AppNetworkService.shared // Initialize your network service.
return true
}
}Now, anywhere in your app, you can access your network manager via the singleton:
import KNetKitSwift
// Define your API endpoint.
let getUsersEndpoint = Endpoint(
path: "users",
method: .get,
requiresAuth: true
)
// Use async/await to perform a request.
func fetchUsers() async {
do {
let users: [User] = try await AppNetworkService.shared.networkManager.request(getUsersEndpoint)
print("Fetched users:", users)
} catch {
print("Error fetching users:", error)
}
}Contributions are welcome! Please feel free to submit issues or pull requests.
This project is licensed under the MIT License.