DataManager

DataManager is a pure Swift library to manage app life-cycle data.

Overview

Almost every application, regardless of the platform, requires some form of data management. On iOS, there are three primary storage options for saving simple data without using a full-fledged database: UserDefaults, Keychain, and FileManager. Each of these serves a different purpose and requires separate implementations for basic operations like create, read, update, and delete (CRUD).

As a result, many apps end up using all three storage methods for different use cases, leading to fragmented code, duplicated logic, and confusion about where specific data is stored.

This library solves that problem by providing a unified interface to manage data across UserDefaults, Keychain, and FileManager. With a single, consistent API, you can choose the desired storage option through a simple configuration—eliminating the need for redundant code and making your data management cleaner and more maintainable.

Installation

Swift Package Manager (SPM)

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler.

If using in Application:

• File > Swift Packages > Add Package Dependency
• Add https://github.com/sahibhussain/data-manager.git
• Select "Up to Next Major" with "1.1.0"

If using in Package:

Once you have your Swift package set up, adding DataManager as a dependency is as easy as adding it to the dependencies value of your Package.swift or the Package list in Xcode.

dependencies: [
    .package(url: "https://github.com/sahibhussain/data-manager.git", .upToNextMajor(from: "1.1.0"))
]

Normally you'll want to depend on the DataManager target:

.product(name: "DataManager", package: "DataManager")

Usage

Save

• key: key for the data
• value: value for the data
• isSecure: whether data should be stored in keychain (default: false)
• isFile: whether data should be stored in FileManager (default: false)

DataManager.shared.save("key", value: "any codable value", isSecure: true, isFile: false)

Check if exists

• key: key for the data
• isSecure: whether data is stored in keychain (default: false)
• isFile: whether data is stored in FileManager (default: false)

DataManager.shared.exist("key", isSecure: true, isFile: false)

Retrieve value

• key: key for the data
• isSecure: whether data is stored in keychain (default: false)
• isFile: whether data is stored in FileManager (default: false)

DataManager.shared.retrieve("key", isSecure: true, isFile: false) 

Delete value

• key: key for the data
• isSecure: whether data is stored in keychain (default: false)
• isFile: whether data is stored in FileManager (default: false)

DataManager.shared.delete("key", isSecure: true, isFile: false) 

Example

Create a helper enum to make your life easier (this is completely optional)

import DataManager

enum SavedContent: String { 
    case keychain, userDefault, fileManager
    
    private var isSecure: Bool {
        switch self {  
            case .keychain: return true  
            default: return false
        }
    } 

    private var isSavedInDoc: Bool {  
        switch self {  
            case .fileManager: return true
            default: return false  
        }  
    } 

    var exists: Bool { 
        DataManager.shared.exist(rawValue, isSecure: isSecure, isFile: isSavedInDoc) 
    } 
    
    func save<T: Codable>(_ value: T) { 
        DataManager.shared.save(rawValue, value: value, isSecure: isSecure, isFile: isSavedInDoc) 
    }  
    
    func retrieve<T: Codable>() -> T? { 
        DataManager.shared.retrieve(rawValue, isSecure: isSecure, isFile: isSavedInDoc) 
    }
          
    func delete() {  
        DataManager.shared.delete(rawValue, isSecure: isSecure, isFile: isSavedInDoc) 
    }
}

// Usage example
SavedContent.keychain.save("hello world")
let exists = SavedContent.keychain.exists
let value: String? = SavedContent.keychain.retrieve()
SavedContent.keychain.delete()

Contact

Follow and contact me on X (Twitter). If you find an issue, open a ticket. Pull requests are warmly welcome as well.