archive.json and sequence.json with source-generated JSON, forward-compatible reading (unknown fields kept, unknown enum names tolerated) and atomic writes; lease files with expiry and stale takeover; thumbs.pack with index, crash-safe append and random access; folder scanning, in-place adoption, reconcile, verify, index snapshot, rename planning and thumbnail/proxy rendering. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
158 lines
7.1 KiB
C#
158 lines
7.1 KiB
C#
using System.Text;
|
|
using System.Text.Json;
|
|
using Titano.Core.Archiving;
|
|
using Titano.Core.Imaging;
|
|
using Titano.Core.IO;
|
|
using Titano.Core.Model;
|
|
using Titano.Testing;
|
|
|
|
namespace Titano.Core.Tests.Archiving;
|
|
|
|
[Category("archive")]
|
|
public sealed class ManifestStoreTests(TestContext context)
|
|
{
|
|
private static SequenceManifest Sample() => new()
|
|
{
|
|
Id = Guid.CreateVersion7(),
|
|
Title = "Harbour sunset",
|
|
Camera = new SidecarCamera { Make = "Canon", Model = "Canon EOS R5", Serial = "0431" },
|
|
Lens = "RF24-70mm F2.8 L IS USM",
|
|
Frames =
|
|
[
|
|
new SidecarFrame
|
|
{
|
|
Id = Guid.CreateVersion7(), I = 0, File = "originals/2026-09-28_18-02-11_0001.CR2", Original = "IMG_0001.CR2", Size = 25_000_000,
|
|
Sha256 = new string('a', 64), CapturedAt = new DateTime(2026, 9, 28, 18, 2, 11, 250), UtcOffset = 120,
|
|
TimeSource = TimestampSource.ExifOriginal, Exposure = 1.0 / 250, FNumber = 8, Iso = 100, Focal = 24, Bias = -0.3, Wb = 0,
|
|
Orientation = 6, W = 8192, H = 5464, Format = ImageFileFormat.Cr2, PreviewOffset = 1234, PreviewLength = 567_890,
|
|
Flags = FrameFlags.Excluded,
|
|
},
|
|
],
|
|
Tags = ["sunset", "harbour"],
|
|
Rating = 4,
|
|
Notes = "Windy",
|
|
Status = SequenceStatus.ThumbsBuilt | SequenceStatus.Verified,
|
|
Versions = new ManifestVersions { Settings = 3, Frames = 7 },
|
|
CreatedBy = "alberto",
|
|
Created = new DateTimeOffset(2026, 9, 28, 20, 0, 0, TimeSpan.Zero),
|
|
UpdatedAt = new DateTimeOffset(2026, 9, 29, 8, 0, 0, TimeSpan.Zero),
|
|
VerifiedAt = new DateTimeOffset(2026, 9, 30, 8, 0, 0, TimeSpan.Zero),
|
|
SessionKeys = ["card-1234abcd-20260928-180211"],
|
|
};
|
|
|
|
private string SidecarPath() => Path.Combine(context.CreateTempDirectory(), ".titano", "sequence.json");
|
|
|
|
private static string Canonical(SequenceManifest m) => JsonSerializer.Serialize(m, ArchiveJson.Default.SequenceManifest);
|
|
|
|
[Test]
|
|
public void SequenceSidecarRoundTripsEveryField()
|
|
{
|
|
var path = SidecarPath();
|
|
var original = Sample();
|
|
ManifestStore.WriteSequence(path, original);
|
|
var read = ManifestStore.ReadSequence(path);
|
|
Assert.Equal(Canonical(original), Canonical(read));
|
|
Assert.Equal(original.Frames[0], read.Frames[0] with { Extra = original.Frames[0].Extra });
|
|
var json = File.ReadAllText(path);
|
|
foreach (var field in new[] { "\"i\":", "\"file\":", "\"sha256\":", "\"capturedAt\":", "\"fNumber\":", "\"w\":", "\"previewOffset\":", "\"flags\":" })
|
|
Assert.Contains(field, json);
|
|
}
|
|
|
|
[Test]
|
|
public void UnknownFieldsAndEnumValuesFromANewerBuildAreReadAndKept()
|
|
{
|
|
var path = SidecarPath();
|
|
Directory.CreateDirectory(Path.GetDirectoryName(path)!);
|
|
var id = Guid.CreateVersion7();
|
|
var frameId = Guid.CreateVersion7();
|
|
File.WriteAllText(path, $$"""
|
|
{
|
|
"schemaVersion": 1, "id": "{{id}}", "title": "Comet", "futureBlock": { "a": [1, 2] },
|
|
"camera": { "make": "Nikon", "sensorTemp": 31 },
|
|
"frames": [ { "id": "{{frameId}}", "i": 0, "file": "x.nef", "size": 10, "format": "Nef2030", "timeSource": "Atomic",
|
|
"flags": 4096, "aiScore": 0.9 } ],
|
|
"status": 1024, "versions": { "settings": 1, "frames": 2, "renders": 5 },
|
|
}
|
|
""");
|
|
var read = ManifestStore.ReadSequence(path);
|
|
Assert.Equal(id, read.Id);
|
|
Assert.Equal(ImageFileFormat.Unknown, read.Frames[0].Format);
|
|
Assert.Equal(TimestampSource.Unknown, read.Frames[0].TimeSource);
|
|
Assert.Equal((FrameFlags)4096, read.Frames[0].Flags);
|
|
|
|
ManifestStore.WriteSequence(path, read with { Title = "Comet 2026" });
|
|
var json = File.ReadAllText(path);
|
|
foreach (var kept in new[] { "futureBlock", "sensorTemp", "aiScore", "renders", "4096", "1024" }) Assert.Contains(kept, json);
|
|
Assert.Equal("Comet 2026", ManifestStore.ReadSequence(path).Title);
|
|
}
|
|
|
|
[Test]
|
|
public void ANewerSchemaIsReadableButNeverRewritten()
|
|
{
|
|
var path = SidecarPath();
|
|
ManifestStore.WriteSequence(path, Sample());
|
|
var newer = ManifestStore.ReadSequence(path) with { SchemaVersion = SequenceManifest.CurrentSchemaVersion + 1 };
|
|
var before = File.ReadAllBytes(path);
|
|
Assert.Throws<NewerFormatException>(() => ManifestStore.WriteSequence(path, newer));
|
|
Assert.BytesEqual(before, File.ReadAllBytes(path));
|
|
}
|
|
|
|
[Test]
|
|
public void DamagedJsonIsReportedAsInvalidData()
|
|
{
|
|
var path = SidecarPath();
|
|
Directory.CreateDirectory(Path.GetDirectoryName(path)!);
|
|
File.WriteAllText(path, "{ \"id\": ");
|
|
Assert.Throws<InvalidDataException>(() => ManifestStore.ReadSequence(path));
|
|
File.WriteAllText(path, "{ \"title\": \"no id\" }");
|
|
Assert.Throws<InvalidDataException>(() => ManifestStore.ReadSequence(path));
|
|
}
|
|
|
|
[Test]
|
|
public void ACrashDuringAWriteLeavesThePreviousSidecarIntact()
|
|
{
|
|
var path = SidecarPath();
|
|
var first = Sample();
|
|
ManifestStore.WriteSequence(path, first);
|
|
// Simulated crash: the next version was half written to the temporary sibling and never renamed.
|
|
var torn = AtomicFile.TempPathFor(path);
|
|
File.WriteAllBytes(torn, Encoding.UTF8.GetBytes(Canonical(first with { Title = "Lost" })[..40]));
|
|
|
|
Assert.Equal(Canonical(first), Canonical(ManifestStore.ReadSequence(path)));
|
|
ManifestStore.WriteSequence(path, first with { Title = "Second" });
|
|
Assert.Equal("Second", ManifestStore.ReadSequence(path).Title);
|
|
Assert.FileExists(torn);
|
|
Assert.Equal(2, Directory.GetFiles(Path.GetDirectoryName(path)!).Length);
|
|
}
|
|
|
|
[Test]
|
|
public void CreatingASidecarClaimsTheFolderOnce()
|
|
{
|
|
var path = SidecarPath();
|
|
Directory.CreateDirectory(Path.GetDirectoryName(path)!);
|
|
var a = Sample();
|
|
var b = Sample();
|
|
Assert.True(ManifestStore.TryCreateSequence(path, a));
|
|
Assert.False(ManifestStore.TryCreateSequence(path, b));
|
|
Assert.Equal(a.Id, ManifestStore.ReadSequence(path).Id);
|
|
Assert.Count(1, Directory.GetFiles(Path.GetDirectoryName(path)!));
|
|
}
|
|
|
|
[Test]
|
|
public void ArchiveManifestRoundTripsAndKeepsUnknownFields()
|
|
{
|
|
var path = Path.Combine(context.CreateTempDirectory(), "archive.json");
|
|
File.WriteAllText(path, $$"""
|
|
{ "schemaVersion": 1, "id": "{{Guid.CreateVersion7()}}", "name": "Main", "created": "2026-10-02T09:00:00+00:00",
|
|
"layoutTemplates": { "folder": "{year}/{title}", "file": "{n:00000}" }, "proxyPolicy": { "longEdge": 2560, "quality": 90 },
|
|
"syncPolicy": "mirror" }
|
|
""");
|
|
var read = ManifestStore.ReadArchive(path);
|
|
Assert.Equal("{year}/{title}", read.LayoutTemplates.Folder);
|
|
Assert.Equal(2560, read.ProxyPolicy.LongEdge);
|
|
ManifestStore.WriteArchive(path, read with { Name = "Studio" });
|
|
Assert.Contains("syncPolicy", File.ReadAllText(path));
|
|
Assert.Equal("Studio", ManifestStore.ReadArchive(path).Name);
|
|
}
|
|
}
|