SPB Git

Repository Public

JSONFileStore.swift 3.9 KB 98 lines swift

1import Foundation23/// Localisation helper. Keys are the English strings; `fr.lproj/Localizable.strings` carries the French text.4/// Using one helper everywhere lets `scripts/check-localization.py` verify that every key is translated.5func L(_ key: String) -> String {6    NSLocalizedString(key, comment: "")7}89/// Localised format string, e.g. `L("Close %d tabs", count)`.10func L(_ key: String, _ args: CVarArg...) -> String {11    String(format: NSLocalizedString(key, comment: ""), locale: Locale.current, arguments: args)12}1314enum JSONFile {15    static func encoder() -> JSONEncoder {16        let e = JSONEncoder()17        e.outputFormatting = [.sortedKeys]18        e.dateEncodingStrategy = .iso860119        return e20    }2122    static func decoder() -> JSONDecoder {23        let d = JSONDecoder()24        d.dateDecodingStrategy = .iso860125        return d26    }2728    /// Atomically writes `value` to `url`, creating intermediate directories.29    static func write<T: Encodable>(_ value: T, to url: URL) throws {30        try FileManager.default.createDirectory(at: url.deletingLastPathComponent(), withIntermediateDirectories: true)31        let data = try encoder().encode(value)32        try data.write(to: url, options: [.atomic])33    }3435    static func read<T: Decodable>(_ type: T.Type, from url: URL) throws -> T {36        try decoder().decode(type, from: Data(contentsOf: url))37    }3839    /// Decodes `type` from `stored` layered over the JSON of `defaults`.40    /// Keys that are missing in an older file keep their default value, so adding a field41    /// to a settings struct never invalidates files written by previous versions.42    static func decodeMerging<T: Codable>(_ type: T.Type, stored: Data, defaults: T) throws -> T {43        let base = try JSONSerialization.jsonObject(with: encoder().encode(defaults))44        let overlay = try JSONSerialization.jsonObject(with: stored)45        let merged = merge(base, overlay)46        return try decoder().decode(type, from: JSONSerialization.data(withJSONObject: merged))47    }4849    private static func merge(_ base: Any, _ overlay: Any) -> Any {50        guard let b = base as? [String: Any], let o = overlay as? [String: Any] else { return overlay }51        var result = b52        for (key, value) in o {53            if let existing = b[key] { result[key] = merge(existing, value) } else { result[key] = value }54        }55        return result56    }57}5859/// A small persisted value: loaded once, saved atomically on every mutation.60/// A file that cannot be decoded is moved aside (`.corrupt-<timestamp>`) instead of being overwritten silently.61final class JSONFileStore<Value: Codable>: @unchecked Sendable {62    let url: URL?63    private let lock = NSLock()64    private var cached: Value65    private(set) var recoveredFromCorruption = false6667    /// `url == nil` keeps the value in memory only (private windows, tests).68    init(url: URL?, defaults: Value) {69        self.url = url70        self.cached = defaults71        guard let url, let data = try? Data(contentsOf: url) else { return }72        if let value = try? JSONFile.decodeMerging(Value.self, stored: data, defaults: defaults) {73            cached = value74        } else if let value = try? JSONFile.decoder().decode(Value.self, from: data) {75            cached = value76        } else {77            recoveredFromCorruption = true78            let stamp = Int(Date().timeIntervalSince1970)79            let aside = url.deletingLastPathComponent().appendingPathComponent(url.lastPathComponent + ".corrupt-\(stamp)")80            try? FileManager.default.moveItem(at: url, to: aside)81        }82    }8384    var value: Value {85        get { lock.lock(); defer { lock.unlock() }; return cached }86        set {87            lock.lock(); cached = newValue; lock.unlock()88            if let url { try? JSONFile.write(newValue, to: url) }89        }90    }9192    func update(_ body: (inout Value) -> Void) {93        var copy = value94        body(&copy)95        value = copy96    }97}98
Files main
Menu

Theme