Repository Public
1// SP Lecture Studio — Tests2// File: Tests/Unit/StorageTests.swift3// Description: Unit tests of the project package: creation, atomic manifest, schema migration, event log, ZIP archives, library operations.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import XCTest8@testable import LectureCore9@testable import LectureStorage1011func makeTempDir(_ name: String = "slecture-tests") -> URL {12 let u = FileManager.default.temporaryDirectory.appendingPathComponent("\(name)-\(UUID().uuidString)")13 try! FileManager.default.createDirectory(at: u, withIntermediateDirectories: true)14 return u15}1617final class PackageTests: XCTestCase {18 var dir: URL!19 override func setUp() { dir = makeTempDir() }20 override func tearDown() { try? FileManager.default.removeItem(at: dir) }2122 func fakePDF() -> URL {23 let u = dir.appendingPathComponent("cours.pdf"); try! Data("%PDF-1.4 fake body".utf8).write(to: u); return u24 }2526 func testCreateCopiesPDFAndNeverTouchesTheOriginal() throws {27 let pdf = fakePDF()28 let before = try Hashing.sha256(of: pdf)29 let pkg = try ProjectPackage.create(in: dir, manifest: ProjectManifest(title: "IMM1003 / Séance: 8?", courseCode: "IMM1003", sessionNumber: 8), pdf: pdf, pdfPageCount: 20)30 XCTAssertEqual(pkg.url.lastPathComponent, "IMM1003 Séance 8.slecture")31 let m = try pkg.loadManifest()32 XCTAssertEqual(m.pdf?.sha256, before); XCTAssertEqual(m.pdf?.pageCount, 20); XCTAssertEqual(m.pdf?.originalName, "cours.pdf")33 XCTAssertEqual(try Hashing.sha256(of: pdf), before)34 XCTAssertTrue(pkg.diagnose(m, deep: true).isHealthy)35 try Data("tampered".utf8).write(to: pkg.pdfURL)36 XCTAssertTrue(pkg.diagnose(m, deep: true).pdfChecksumMismatch)37 try FileManager.default.removeItem(at: pkg.pdfURL)38 XCTAssertTrue(pkg.diagnose(m).missingPDF)39 let second = try ProjectPackage.create(in: dir, manifest: ProjectManifest(title: "IMM1003 / Séance: 8?"))40 XCTAssertEqual(second.url.lastPathComponent, "IMM1003 Séance 8 2.slecture") // never overwrites an existing package41 }4243 func testManifestRoundTripAndMigration() throws {44 var m = ProjectManifest(title: "Test", courseCode: "FIN", sessionNumber: 2)45 m.notes = [0: "Rappeler le TP2", 4: "Exemple Maloney"]46 var s = RecordingSession(startedAt: Date(timeIntervalSince1970: 1_800_000_000), timelineStart: .zero)47 s.segments = [MediaSegment(kind: .audio, path: "media/audio-x-00001.caf", index: 1, start: .zero, duration: T(30), sampleRate: 48000, channels: 1, frames: 1_440_000, finalized: true)]48 m.sessions = [s]; m.recomputeDuration()49 XCTAssertEqual(m.duration, T(30))50 let pkg = try ProjectPackage.create(in: dir, manifest: m)51 let back = try pkg.loadManifest()52 XCTAssertEqual(back.notes, m.notes); XCTAssertEqual(back.sessions, m.sessions); XCTAssertEqual(back.duration, T(30))5354 // Schema 1 → 2.55 let v1 = #"{"schemaVersion":1,"id":"\#(UUID().uuidString)","title":"Ancien","course":"IMM1033","lectureDate":"2026-09-01T12:00:00Z","createdAt":"2026-09-01T12:00:00Z","modifiedAt":"2026-09-01T12:00:00Z","sessions":[],"duration":0}"#56 let old = try ManifestMigrator.decode(Data(v1.utf8))57 XCTAssertEqual(old.courseCode, "IMM1033"); XCTAssertEqual(old.schemaVersion, ProjectManifest.currentSchema); XCTAssertEqual(old.lastPage, 0)58 // A package written by a newer version is refused with an explicit error instead of being silently damaged.59 let future = v1.replacingOccurrences(of: "\"schemaVersion\":1", with: "\"schemaVersion\":99")60 XCTAssertThrowsError(try ManifestMigrator.decode(Data(future.utf8))) { XCTAssertEqual($0 as? StorageError, .newerSchema(found: 99, supported: ProjectManifest.currentSchema)) }61 }6263 func testEventLogAppendsAcrossReopenAndRepairsTruncatedTail() throws {64 let pkg = try ProjectPackage.create(in: dir, manifest: ProjectManifest(title: "Log"))65 var w: EventLogWriter? = try EventLogWriter(url: pkg.eventsURL)66 w!.append(.page(index: 0), at: .zero); w!.append(.marker(Marker(kind: .chapter, label: "A")), at: T(1)); w!.flush(); w = nil67 // Simulated crash in the middle of a write.68 let h = try FileHandle(forWritingTo: pkg.eventsURL); try h.seekToEnd(); try h.write(contentsOf: Data("{\"seq\":3,\"t\":2000".utf8)); try h.close()69 let w2 = try EventLogWriter(url: pkg.eventsURL)70 let e = w2.append(.page(index: 1), at: T(3)); w2.flush()71 XCTAssertEqual(e.seq, 3)72 let r = pkg.loadEvents()73 XCTAssertEqual(r.events.count, 3); XCTAssertEqual(r.skippedLines, 1); XCTAssertEqual(r.events.last?.e, .page(index: 1))74 }7576 func testEditsAndTranscriptPersist() throws {77 let pkg = try ProjectPackage.create(in: dir, manifest: ProjectManifest(title: "Edits"))78 var h = EditHistory(); h.apply { $0.addCut(TimeRange(seconds: 1, 2)) }; h.apply { $0.gainDB = 3 }; h.undo()79 try pkg.saveEdits(h)80 let back = pkg.loadEdits()81 XCTAssertEqual(back, h); XCTAssertTrue(back.canRedo); XCTAssertTrue(back.canUndo)82 let t = Transcript(locale: "fr-CA", provider: "x", segments: [TranscriptSegment(range: TimeRange(seconds: 0, 1), text: "Allô")])83 try pkg.saveTranscript(t)84 XCTAssertEqual(pkg.loadTranscript()?.segments.first?.text, "Allô")85 }86}8788final class ZipTests: XCTestCase {89 func testRoundTripAndDeflateInterop() throws {90 let dir = makeTempDir(); defer { try? FileManager.default.removeItem(at: dir) }91 let src = dir.appendingPathComponent("Projet été.slecture")92 try FileManager.default.createDirectory(at: src.appendingPathComponent("media"), withIntermediateDirectories: true)93 try FileManager.default.createDirectory(at: src.appendingPathComponent("vide"), withIntermediateDirectories: true)94 var big = Data(count: 3_000_000); big.withUnsafeMutableBytes { p in for i in 0..<p.count { p[i] = UInt8(truncatingIfNeeded: i &* 31 &+ i / 7) } }95 try big.write(to: src.appendingPathComponent("media/audio.caf"))96 try Data("{\"a\":1}".utf8).write(to: src.appendingPathComponent("manifest.json"))97 let zip = dir.appendingPathComponent("a.zip")98 try ZipArchive.create(at: zip, fromDirectory: src, rootName: "Projet été.slecture")99 let names = try ZipArchive.entries(of: zip).map(\.path)100 XCTAssertTrue(names.contains("Projet été.slecture/media/audio.caf")); XCTAssertTrue(names.contains("Projet été.slecture/vide/"))101 let out = dir.appendingPathComponent("out")102 try ZipArchive.extract(zip, to: out)103 XCTAssertEqual(try Data(contentsOf: out.appendingPathComponent("Projet été.slecture/media/audio.caf")), big)104105 #if os(macOS)106 // The system unzip accepts our archive, and we read an archive deflated by the system zip.107 let p = Process(); p.executableURL = URL(fileURLWithPath: "/usr/bin/unzip"); p.arguments = ["-tq", zip.path]108 p.standardOutput = Pipe(); try p.run(); p.waitUntilExit()109 XCTAssertEqual(p.terminationStatus, 0)110 let sysZip = dir.appendingPathComponent("sys.zip")111 let z = Process(); z.executableURL = URL(fileURLWithPath: "/usr/bin/zip"); z.currentDirectoryURL = dir112 z.arguments = ["-rq", sysZip.path, "Projet été.slecture"]; try z.run(); z.waitUntilExit()113 let out2 = dir.appendingPathComponent("out2")114 try ZipArchive.extract(sysZip, to: out2)115 XCTAssertEqual(try Data(contentsOf: out2.appendingPathComponent("Projet été.slecture/media/audio.caf")), big)116 #endif117118 // Corruption is detected.119 var bytes = try Data(contentsOf: zip); bytes[bytes.count / 2] ^= 0xFF; try bytes.write(to: zip)120 XCTAssertThrowsError(try ZipArchive.extract(zip, to: dir.appendingPathComponent("out3")))121 }122}123124final class LibraryTests: XCTestCase {125 func testLifecycle() throws {126 let root = makeTempDir(); defer { try? FileManager.default.removeItem(at: root) }127 let lib = try Library(root: root)128 let pdf = root.appendingPathComponent("x.pdf"); try Data("%PDF".utf8).write(to: pdf)129 let a = try lib.create(title: "Méthode du coût", courseCode: "IMM1033", sessionNumber: 9, pdf: pdf, pdfPageCount: 3)130 _ = try lib.create(title: "Comparaison", courseCode: "IMM1003", pdf: nil, pdfPageCount: 0)131 var scan = lib.scan()132 XCTAssertEqual(scan.items.count, 2)133 XCTAssertEqual(scan.items.filter { Library.matches($0, query: "methode") }.count, 1) // accent-insensitive134 XCTAssertEqual(scan.items.filter { Library.matches($0, query: "imm10") }.count, 2)135136 let copy = try lib.duplicate(a, titleSuffix: "(copie)")137 XCTAssertNotEqual(try copy.loadManifest().id, try a.loadManifest().id)138 let renamed = try lib.rename(a, to: "Coût — séance 9")139 XCTAssertEqual(renamed.url.lastPathComponent, "Coût — séance 9.slecture")140 try lib.setArchived(renamed, true)141 XCTAssertTrue(try renamed.loadManifest().archived)142143 // Deleting is a move to the trash and can be undone.144 try lib.moveToTrash(copy)145 XCTAssertEqual(lib.scan().items.count, 2); XCTAssertEqual(lib.trashedProjects().count, 1)146 try lib.restoreFromTrash(lib.trashedProjects()[0].package)147 XCTAssertEqual(lib.scan().items.count, 3)148149 // Portable archive: export, import on the "same device" gets a fresh identity, content identical.150 let zip = root.appendingPathComponent("export.slecture.zip")151 try Library.exportArchive(renamed, to: zip)152 let imported = try lib.importProject(from: zip)153 scan = lib.scan()154 XCTAssertEqual(scan.items.count, 4)155 XCTAssertEqual(Set(scan.items.map(\.manifest.id)).count, 4)156 XCTAssertEqual(try Hashing.sha256(of: imported.pdfURL), try Hashing.sha256(of: renamed.pdfURL))157 XCTAssertTrue(scan.unreadable.isEmpty)158 }159}160