SPB Git

Repository Public

Library.swift 8.8 KB 159 lines swift

1// SP Lecture Studio — LectureStorage2// File: Packages/LectureStorage/Sources/Library.swift3// Description: Library of lecture projects on disk: listing, search, create, duplicate, rename, archive, recoverable trash, portable archives.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import Foundation8import LectureCore910public struct LibraryItem: Sendable, Hashable, Identifiable {11    public var package: ProjectPackage12    public var manifest: ProjectManifest13    public var byteCount: Int6414    public var needsRecovery: Bool15    public var id: UUID { manifest.id }16}1718public struct Library: Sendable {19    public let root: URL20    public var trashURL: URL { root.appendingPathComponent(".Trash", isDirectory: true) }2122    public init(root: URL) throws {23        self.root = root24        try FileManager.default.createDirectory(at: root, withIntermediateDirectories: true)25    }2627    /// Projects found in the library folder, most recently modified first. Unreadable packages are reported, never removed.28    public func scan(measureSize: Bool = true) -> (items: [LibraryItem], unreadable: [URL]) {29        let fm = FileManager.default30        var items: [LibraryItem] = [], bad: [URL] = []31        for u in (try? fm.contentsOfDirectory(at: root, includingPropertiesForKeys: nil, options: [.skipsHiddenFiles])) ?? [] where u.pathExtension == ProjectLayout.packageExtension {32            let pkg = ProjectPackage(url: u)33            if let m = try? pkg.loadManifest() {34                items.append(LibraryItem(package: pkg, manifest: m, byteCount: measureSize ? pkg.diskUsage() : 0,35                                         needsRecovery: ProjectRecovery.needsRecovery(pkg, manifest: m)))36            } else { bad.append(u) }37        }38        return (items.sorted { $0.manifest.modifiedAt > $1.manifest.modifiedAt }, bad)39    }4041    public static func matches(_ item: LibraryItem, query: String) -> Bool {42        let q = query.trimmingCharacters(in: .whitespaces).folding(options: [.diacriticInsensitive, .caseInsensitive], locale: nil)43        guard !q.isEmpty else { return true }44        let m = item.manifest45        var hay = [m.title, m.courseCode, m.publishingDestination, m.pdf?.originalName ?? ""]46        if let n = m.sessionNumber { hay.append(String(n)) }47        hay.append(contentsOf: m.notes.values)48        return hay.contains { $0.folding(options: [.diacriticInsensitive, .caseInsensitive], locale: nil).contains(q) }49    }5051    public func create(title: String, courseCode: String = "", sessionNumber: Int? = nil, lectureDate: Date = Date(),52                       pdf: URL?, pdfPageCount: Int) throws -> ProjectPackage {53        let m = ProjectManifest(title: title, courseCode: courseCode, sessionNumber: sessionNumber, lectureDate: lectureDate)54        return try ProjectPackage.create(in: root, manifest: m, pdf: pdf, pdfPageCount: pdfPageCount)55    }5657    /// Full copy with a new identity. Recordings and edits are copied too.58    public func duplicate(_ package: ProjectPackage, titleSuffix: String) throws -> ProjectPackage {59        var m = try package.loadManifest()60        let dest = ProjectPackage(url: ProjectPackage.uniqueURL(in: root, baseName: ProjectPackage.safeFileName(m.title + " " + titleSuffix)))61        try FileManager.default.copyItem(at: package.url, to: dest.url)62        m.id = UUID(); m.title += " " + titleSuffix; m.createdAt = Date(); m.exports = []63        try dest.saveManifest(m)64        return dest65    }6667    /// Renames the lecture; the package folder follows the title when possible.68    public func rename(_ package: ProjectPackage, to title: String) throws -> ProjectPackage {69        var m = try package.loadManifest()70        m.title = title71        try package.saveManifest(m)72        let wanted = ProjectPackage.safeFileName(title)73        guard package.url.deletingPathExtension().lastPathComponent != wanted else { return package }74        let dest = ProjectPackage.uniqueURL(in: package.url.deletingLastPathComponent(), baseName: wanted)75        do { try FileManager.default.moveItem(at: package.url, to: dest); return ProjectPackage(url: dest) } catch { return package }76    }7778    public func setArchived(_ package: ProjectPackage, _ archived: Bool) throws {79        var m = try package.loadManifest(); m.archived = archived; try package.saveManifest(m)80    }8182    /// Moves a project to the library trash. Nothing is erased until `emptyTrash()` is called explicitly.83    @discardableResult84    public func moveToTrash(_ package: ProjectPackage) throws -> URL {85        let fm = FileManager.default86        try fm.createDirectory(at: trashURL, withIntermediateDirectories: true)87        let dest = ProjectPackage.uniqueURL(in: trashURL, baseName: package.url.deletingPathExtension().lastPathComponent)88        try fm.moveItem(at: package.url, to: dest)89        return dest90    }9192    public func trashedProjects() -> [LibraryItem] {93        let urls = (try? FileManager.default.contentsOfDirectory(at: trashURL, includingPropertiesForKeys: nil)) ?? []94        return urls.filter { $0.pathExtension == ProjectLayout.packageExtension }.compactMap { u in95            let pkg = ProjectPackage(url: u)96            return (try? pkg.loadManifest()).map { LibraryItem(package: pkg, manifest: $0, byteCount: pkg.diskUsage(), needsRecovery: false) }97        }98    }99100    @discardableResult101    public func restoreFromTrash(_ package: ProjectPackage) throws -> ProjectPackage {102        let dest = ProjectPackage.uniqueURL(in: root, baseName: package.url.deletingPathExtension().lastPathComponent)103        try FileManager.default.moveItem(at: package.url, to: dest)104        return ProjectPackage(url: dest)105    }106107    /// Permanently erases the trash. Only ever called from an explicit, confirmed user action.108    public func emptyTrash() throws {109        if FileManager.default.fileExists(atPath: trashURL.path) { try FileManager.default.removeItem(at: trashURL) }110    }111112    public func totalUsage() -> Int64 { ProjectPackage.directorySize(root) }113114    // MARK: Portable archives115116    /// Writes a single-file `.slecture.zip` holding the whole package (caches excluded unless `includeCaches`).117    public static func exportArchive(_ package: ProjectPackage, to destination: URL, includeCaches: Bool = false, progress: ((Double) -> Bool)? = nil) throws {118        try ZipArchive.create(at: destination, fromDirectory: package.url, rootName: package.url.lastPathComponent,119                              exclude: { rel in (!includeCaches && rel.hasPrefix(ProjectLayout.cacheDirectory)) || rel.hasPrefix(ProjectLayout.exportsDirectory + "/") || rel.hasSuffix(".DS_Store") },120                              progress: progress)121    }122123    /// Imports a `.slecture` package folder or a `.slecture.zip` archive into the library (always as a copy).124    /// A project whose identifier already exists is imported under a new identifier so that nothing is overwritten.125    public func importProject(from source: URL, progress: ((Double) -> Bool)? = nil) throws -> ProjectPackage {126        let fm = FileManager.default127        var isDir: ObjCBool = false128        guard fm.fileExists(atPath: source.path, isDirectory: &isDir) else { throw StorageError.io("missing \(source.lastPathComponent)") }129        let staging = root.appendingPathComponent(".import-\(UUID().uuidString)", isDirectory: true)130        defer { try? fm.removeItem(at: staging) }131        var found: URL132        if isDir.boolValue {133            found = source134        } else {135            try ZipArchive.extract(source, to: staging, progress: progress)136            guard let pkg = Self.findPackage(in: staging) else { throw StorageError.notAPackage(source.lastPathComponent) }137            found = pkg138        }139        var manifest = try ProjectPackage(url: found).loadManifest()140        let dest = ProjectPackage(url: ProjectPackage.uniqueURL(in: root, baseName: ProjectPackage.safeFileName(manifest.title)))141        if isDir.boolValue { try fm.copyItem(at: found, to: dest.url) } else { try fm.moveItem(at: found, to: dest.url) }142        for dir in [ProjectLayout.mediaDirectory, ProjectLayout.cacheDirectory, ProjectLayout.thumbnailsDirectory, ProjectLayout.exportsDirectory] {143            try fm.createDirectory(at: dest.url(dir), withIntermediateDirectories: true)144        }145        if scan(measureSize: false).items.contains(where: { $0.manifest.id == manifest.id && $0.package != dest }) {146            manifest.id = UUID(); try dest.saveManifest(manifest)147        }148        return dest149    }150151    static func findPackage(in directory: URL) -> URL? {152        let fm = FileManager.default153        if fm.fileExists(atPath: directory.appendingPathComponent(ProjectLayout.manifest).path) { return directory }154        guard let e = fm.enumerator(at: directory, includingPropertiesForKeys: nil) else { return nil }155        for case let u as URL in e where u.lastPathComponent == ProjectLayout.manifest { return u.deletingLastPathComponent() }156        return nil157    }158}159
Files main
Menu

Theme