using Chronos.Core.Localization; using Chronos.Core.Project; using Chronos.Testing; namespace Chronos.Core.Tests.Project; /// The .chronos project file (BRIEF ยง18): a sequence reference plus the settings to open it with. public sealed class ProjectBundleTests(TestContext context) { private static readonly Guid ArchiveId = Guid.Parse("0192a4c1-7b3e-7cc0-8a51-2f9d0e6b1a01"); private static readonly Guid SequenceId = Guid.Parse("0192a4c1-7b3e-7cc0-8a51-2f9d0e6b1a02"); [Test] public void ARoundTripKeepsTheReferenceAndTheSettings() { var bundle = Sample(); var path = Path.Combine(context.CreateTempDirectory("bundle"), ProjectBundle.FileNameFor("Harbour sunset")); bundle.Save(path); var back = ProjectBundle.Load(path); Assert.Equal(bundle.Archive, back.Archive); Assert.Equal(bundle.Sequence, back.Sequence); Assert.Equal(bundle.Saved, back.Saved); Assert.Equal(bundle.Project.ToJson(), back.Project.ToJson()); Assert.Equal(0.8, back.Project.Exposure.DeflickerStrength.Resolve(1.0)); Assert.SequenceEqual([3, 7], back.Project.ExcludedFrames); var json = File.ReadAllText(path); Assert.Contains("\"format\": \"chronos-project\"", json); Assert.Contains("\"formatVersion\": 1", json); } [Test] public void OtherFilesAreRefusedAsNotProjectFiles() { Assert.Throws(() => ProjectBundle.Parse("not json")); Assert.Throws(() => ProjectBundle.Parse("[1, 2]")); // The archive's own meta files are JSON too, but not project files. Assert.Throws(() => ProjectBundle.Parse("""{ "schemaVersion": 1, "id": "0192a4c1-7b3e-7cc0-8a51-2f9d0e6b1a01" }""")); var json = Sample().ToJson(); Assert.Throws(() => ProjectBundle.Parse(json.Replace("\"formatVersion\": 1", $"\"formatVersion\": {ProjectBundle.CurrentFormatVersion + 1}", StringComparison.Ordinal))); Assert.Throws(() => ProjectBundle.Parse(json.Replace(SequenceId.ToString(), "not-a-guid", StringComparison.Ordinal))); Assert.Throws(() => ProjectBundle.Parse(json.Replace("\"version\": 1", "\"version\": 99", StringComparison.Ordinal))); Assert.Throws(() => ProjectBundle.Parse(json.Replace("\"folder\"", "\"place\"", StringComparison.Ordinal))); } [Test] public void AWorkspaceProjectFileRoundTripsItsWorkspaceSection() { var basis = new BundleBase(Guid.Parse("0192a4c1-7b3e-7cc0-8a51-2f9d0e6b1a10"), 7, new string('a', 64)); var workspace = new BundleWorkspace(Guid.Parse("0192a4c1-7b3e-7cc0-8a51-2f9d0e6b1a11"), "Vertical social", false, new BundleHome(BundleHome.ArchiveKind, SequenceId, ArchiveId), basis, new BundleMedia(BundleMedia.Proxies, 12)); var bundle = Sample() with { Workspace = workspace }; var path = Path.Combine(context.CreateTempDirectory("bundle"), "project.chronos"); bundle.Save(path); var json = File.ReadAllText(path); Assert.Contains("\"formatVersion\": 2", json); Assert.Contains("\"kind\": \"archive\"", json); var back = ProjectBundle.Load(path); Assert.Equal(workspace, back.Workspace); Assert.Equal(bundle.Project.ToJson(), back.Project.ToJson()); Assert.False(back.IsReadOnly); // Holding the originals: format 3, which a Chronos before phase 5c refuses as newer rather than reading as proxies. var originals = bundle with { Workspace = workspace with { Media = new BundleMedia(BundleMedia.Originals, 12) } }; Assert.Contains("\"formatVersion\": 3", originals.ToJson()); Assert.Equal(BundleMedia.Originals, ProjectBundle.Parse(originals.ToJson()).Workspace!.Media.Kind); Assert.Equal(3, ProjectBundle.CurrentFormatVersion); // A server home names its server; a project not pulled yet has no base. var remote = workspace with { Home = new BundleHome(BundleHome.ServerKind, SequenceId, Server: "https://nas:8443"), Base = null, IsMain = true }; Assert.Equal(remote, ProjectBundle.Parse((bundle with { Workspace = remote }).ToJson()).Workspace); Assert.Throws(() => ProjectBundle.Parse(json.Replace("\"kind\": \"archive\"", "\"kind\": \"cloud\"", StringComparison.Ordinal))); } [Test] public void AFileOfTheFirstFormatStillOpens() { const string v1 = """ { "format": "chronos-project", "formatVersion": 1, "saved": "2026-10-12T09:30:00+00:00", "archive": { "id": "0192a4c1-7b3e-7cc0-8a51-2f9d0e6b1a01", "name": "Main archive" }, "sequence": { "id": "0192a4c1-7b3e-7cc0-8a51-2f9d0e6b1a02", "folder": "2026/Harbour", "frames": 10 }, "project": { "excludedFrames": [4] }, "workspace": { "projectId": "0192a4c1-7b3e-7cc0-8a51-2f9d0e6b1a11" } } """; var bundle = ProjectBundle.Parse(v1); Assert.SequenceEqual([4], bundle.Project.ExcludedFrames); // A format 1 file has no workspace section, whatever it holds. Assert.Null(bundle.Workspace); Assert.Contains("\"formatVersion\": 1", bundle.ToJson()); } [Test] public void ANewerProjectOpensReadOnlyInAWorkspaceFileOnly() { var workspace = new BundleWorkspace(Guid.CreateVersion7(), "Main", true, new BundleHome(BundleHome.ArchiveKind, SequenceId, ArchiveId), null, new BundleMedia(BundleMedia.Proxies, 0)); var json = (Sample() with { Workspace = workspace }).ToJson().Replace("\"version\": 1", "\"version\": 4", StringComparison.Ordinal); var bundle = ProjectBundle.Parse(json); Assert.True(bundle.IsReadOnly); Assert.True(bundle.Project.IsNewerFormat); Assert.Equal(0.8, bundle.Project.Exposure.DeflickerStrength.Resolve(1.0)); var plain = Sample().ToJson().Replace("\"version\": 1", "\"version\": 4", StringComparison.Ordinal); Assert.Throws(() => ProjectBundle.Parse(plain)); } [Test] public void AFileTooLargeToBeAProjectIsNotRead() { var path = Path.Combine(context.CreateTempDirectory("bundle"), "huge.chronos"); using (var stream = File.Create(path)) stream.SetLength(ProjectBundle.MaxBytes + 1L); Assert.Throws(() => ProjectBundle.Load(path)); } [Test] public void AFileNoReadCouldTakeBackIsRefusedBeforeItIsWritten() { var folder = context.CreateTempDirectory("bundle"); var path = Path.Combine(folder, "huge.chronos"); var sample = Sample(); var huge = sample with { Sequence = sample.Sequence with { Title = new string('x', ProjectBundle.MaxBytes) } }; var refused = Assert.Throws(() => huge.Save(path)); Assert.Equal(Loc.L("Errors.Project.TooLarge", ProjectBundle.MaxBytes >> 20), refused.Message); Assert.False(File.Exists(path)); Assert.Empty(Directory.GetFiles(folder)); // Within the limit, the file is written and read back. sample.Save(path); Assert.Equal(sample.Sequence.Title, ProjectBundle.Load(path).Sequence.Title); } [Test] public void FramePositionsApplyOnlyToTheFramesTheyWereSavedFor() { var bundle = Sample(); var current = new ProjectSettings { ExcludedFrames = [1], HeroFrame = 2, Camera = new CameraSettings { Keyframes = [new CameraKey(0, 0.5, 0.5, 1, 0)] }, }; Assert.Same(bundle.Project, bundle.ProjectFor(current, frameCount: 3600)); var changed = bundle.ProjectFor(current, frameCount: 3610); Assert.SequenceEqual([1], changed.ExcludedFrames); Assert.Equal(2, changed.HeroFrame); Assert.Same(current.Camera.Keyframes, changed.Camera.Keyframes); // Everything else comes from the file. Assert.Equal(0.8, changed.Exposure.DeflickerStrength.Resolve(1.0)); Assert.Equal(bundle.Project.Camera.Crop, changed.Camera.Crop); } [Theory] [Case("Harbour sunset", "Harbour sunset.chronos")] [Case("Roof: 12/03 \"storm\"?", "Roof_ 12_03 _storm__.chronos")] [Case("CON", "_CON.chronos")] [Case(" ", "Chronos.chronos")] public void TheFileNameComesFromTheTitle(string title, string expected) => Assert.Equal(expected, ProjectBundle.FileNameFor(title)); [Test] public void SavingNeverReplacesAnEarlierProjectFile() { var folder = context.CreateTempDirectory("bundle"); Assert.Equal(Path.Combine(folder, "Harbour sunset.chronos"), ProjectBundle.FreePathIn(folder, "Harbour sunset")); File.WriteAllText(Path.Combine(folder, "Harbour sunset.chronos"), "{}"); Directory.CreateDirectory(Path.Combine(folder, "Harbour sunset (2).chronos")); Assert.Equal(Path.Combine(folder, "Harbour sunset (3).chronos"), ProjectBundle.FreePathIn(folder, "Harbour sunset")); } private static ProjectBundle Sample() => new( new BundleArchive(ArchiveId, "Main archive", @"D:\Timelapse"), new BundleSequence(SequenceId, "2026/2026-09-28 Harbour sunset", "Harbour sunset", 3600), new ProjectSettings { Exposure = new ExposureSettings { DeflickerStrength = new Auto().WithManual(0.8) }, Camera = new CameraSettings { Crop = [0.1, 0.1, 0.9, 0.9], Keyframes = [new CameraKey(120, 0.4, 0.5, 1.2, 0)] }, ExcludedFrames = [3, 7], HeroFrame = 1800, }, new DateTimeOffset(2026, 10, 12, 9, 30, 0, TimeSpan.Zero)); }