Files
Flaro/server/tests/Halo.Core.Tests/LibraryWalkerTests.cs
T
ScarriffleandClaude Opus 5 acfe2668a8 Stufe 2b: Metadaten von TMDB — und ein Testlauf, der 19-mal schneller ist
Titel, Beschreibungen und Bilder kommen jetzt von TMDB. Dazu zwei Fehler, die
erst das Zusammenspiel zeigte.

**Der Anbieter steckt hinter einer Schnittstelle, und das ist kein Vorrat für
einen zweiten.** Es geht darum, dass alles, was darauf aufbaut, *ohne Netz und
ohne Schlüssel* prüfbar bleibt. Ein Projekt, dessen Tests einen fremden Dienst
brauchen, hat am Ende keine Tests: sie scheitern, wenn das WLAN hakt, und
irgendwann schaltet sie jemand ab.

**Ein Fehlschlag bei TMDB ist kein Abbruch.** Kein Netz, Kontingent erschöpft,
ein Anmeldeportal im Hotel-WLAN, das HTML mit Status 200 schickt — in allen
Fällen bleibt der Titel beim Dateinamen und der Scan läuft durch. Die eine
Ausnahme ist ein zurückgewiesener Schlüssel: „nichts gefunden" und „dein
Schlüssel ist falsch" sehen in der Mediathek gleich aus, und ohne diese
Unterscheidung sucht jemand stundenlang. Der Schlüssel steht im Scanbericht.

**Der Schlüssel kommt nie wieder heraus.** Abgefragt wird nur, ob einer da
ist — sonst gäbe die Oberfläche jedem Angemeldeten das TMDB-Kontingent des
Betreibers in die Hand. Geprüft, dass er nicht einmal versehentlich im
Antwortkörper steht.

**Bilder holt die App bei Halo, nicht bei TMDB.** Sonst bräuchte sie Internet
für ein Plakat, das zehn Zentimeter weiter auf der Platte liegt — und TMDB
erführe, wer wann was ansieht. Der Schlüssel ist der Hash der Quelladresse,
also lädt dasselbe Plakat nie zweimal. Dass daraus kein Weg ins Dateisystem
wird, ist eigens geprüft: ohne die Formprüfung wäre
`/api/v1/images/../../config/halo.db` ein Weg, die Datenbank samt aller
Token-Fingerabdrücke herunterzuladen.

---

**Der erste Fehler: nach dem Eintragen der Metadaten legte der nächste Scan
den Film erneut an.** Zugeordnet wurde über den Titel — und den hatte TMDB
gerade von „The Matrix" auf „Matrix" geändert. Beim übernächsten Lauf dasselbe
noch einmal. Das ist die Sorte Fehler, die man erst nach Wochen bemerkt, wenn
jeder Film fünfmal dasteht. Jetzt gibt es `ParsedTitle`: den Titel aus dem
Dateinamen, der sich nie ändert, und nur der entscheidet beim Zuordnen.

**Der zweite Fehler kostete 15 Minuten je Testlauf.** Zwei Tests löschen die
Pfadvariablen, um den Rückfall auf die Voreinstellung zu prüfen — und liessen
sie gelöscht zurück. Jeder danach gestartete Testserver fiel dann auf
`<Projektverzeichnis>/data` zurück, und Dutzende Server teilten sich **eine**
SQLite-Datei, auf die sie der Reihe nach warteten. Dazu wartete jeder Host
beim Herunterfahren die vollen fünf Sekunden.

Gefunden durch Halbieren, nicht durch Raten: einzeln war jede Testklasse
schnell, zusammen nicht. Der Beweis lag am Ende als leeres Verzeichnis
`src/Halo.Api/data` auf der Platte.

**15 Minuten 32 → 49 Sekunden.** 180 Tests grün.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-03 16:52:46 +02:00

153 lines
5.5 KiB
C#

using Halo.Core.Library;
namespace Halo.Core.Tests;
public class LibraryWalkerTests
{
private string _wurzel = "";
[SetUp]
public void Anlegen() => _wurzel = Directory.CreateDirectory(
Path.Combine(Path.GetTempPath(), "halo-bestand-" + Guid.CreateVersion7().ToString("N"))).FullName;
[TearDown]
public void Aufraeumen()
{
// Ein Test sperrt absichtlich einen Ordner; ohne Zurücksetzen liesse
// er sich nicht mehr löschen.
if (!OperatingSystem.IsWindows())
{
foreach (var d in Directory.EnumerateDirectories(_wurzel, "*", SearchOption.AllDirectories))
File.SetUnixFileMode(d, UnixFileMode.UserRead | UnixFileMode.UserWrite | UnixFileMode.UserExecute);
}
try { Directory.Delete(_wurzel, recursive: true); } catch (IOException) { }
}
private void Datei(string relativ, int bytes = 1024)
{
var voll = Path.Combine(_wurzel, relativ);
Directory.CreateDirectory(Path.GetDirectoryName(voll)!);
File.WriteAllBytes(voll, new byte[bytes]);
}
private string[] GefundeneNamen(WalkResult ergebnis) =>
ergebnis.Files.Select(f => Path.GetFileName(f.Path)).Order().ToArray();
[Test]
public void Videodateien_werden_gefunden_Beiwerk_nicht()
{
Datei("Filme/The Matrix (1999).mkv");
Datei("Filme/The Matrix (1999).srt");
Datei("Filme/poster.jpg");
Datei("Filme/The Matrix (1999).nfo");
Assert.That(GefundeneNamen(LibraryWalker.Walk(_wurzel)), Is.EqualTo(new[] { "The Matrix (1999).mkv" }));
}
[Test]
public void Auch_tief_verschachtelt_wird_gefunden()
{
Datei("Serien/Dark/Staffel 1/Dark - S01E01.mkv");
Datei("Serien/Dark/Staffel 2/Dark - S02E01.mkv");
Assert.That(LibraryWalker.Walk(_wurzel).Files, Has.Count.EqualTo(2));
}
/// <summary>Der Fund, der eine Mediathek sonst verdoppelt.</summary>
///
/// <remarks>
/// <b>@eaDir ist Synologys Vorschauablage und enthält eine Kopie jeder
/// Datei.</b> Mit <c>SearchOption.AllDirectories</c> — der bequemen
/// Fassung — liefe der Scan hinein und fände jeden Film zweimal, einmal
/// davon als unbrauchbare Kopie. Genau deshalb steigt der Walker von Hand
/// ab.
/// </remarks>
[Test]
public void Vorschauablagen_und_Papierkoerbe_werden_uebersprungen()
{
Datei("Filme/The Matrix (1999).mkv");
Datei("Filme/@eaDir/The Matrix (1999).mkv/SYNOPHOTO_THUMB.mkv");
Datei("Filme/#recycle/Alter Film (2001).mkv");
Datei("Filme/.versteckt/Noch einer (2002).mkv");
Datei("Filme/Extras/Making Of.mkv");
Assert.That(GefundeneNamen(LibraryWalker.Walk(_wurzel)), Is.EqualTo(new[] { "The Matrix (1999).mkv" }));
}
[Test]
public void Groesse_und_Aenderungszeit_kommen_mit()
{
Datei("Filme/Film (2000).mkv", bytes: 4096);
var gefunden = LibraryWalker.Walk(_wurzel).Files.Single();
Assert.That(gefunden.SizeBytes, Is.EqualTo(4096));
Assert.That(gefunden.ModifiedAt, Is.GreaterThan(DateTimeOffset.UtcNow.AddMinutes(-5)));
}
/// <summary>Ein gesperrter Ordner darf nicht den ganzen Lauf verderben.</summary>
///
/// <remarks>
/// Sonst entschiede ein einzelner falsch gesetzter Unterordner darüber, ob
/// überhaupt etwas gefunden wird — und die Mediathek bliebe leer, ohne dass
/// jemand sagen könnte, warum.
/// </remarks>
[Test]
public void Ein_gesperrter_Ordner_wird_vermerkt_und_uebersprungen()
{
if (OperatingSystem.IsWindows()) Assert.Ignore("Dateirechte verhalten sich dort anders.");
Datei("Filme/Erreichbar (2000).mkv");
var gesperrt = Directory.CreateDirectory(Path.Combine(_wurzel, "Filme", "gesperrt")).FullName;
File.WriteAllBytes(Path.Combine(gesperrt, "Versteckt (2001).mkv"), new byte[10]);
if (OperatingSystem.IsWindows()) return;
File.SetUnixFileMode(gesperrt, UnixFileMode.None);
var ergebnis = LibraryWalker.Walk(_wurzel);
Assert.That(GefundeneNamen(ergebnis), Is.EqualTo(new[] { "Erreichbar (2000).mkv" }));
Assert.That(ergebnis.Problems, Has.Count.EqualTo(1));
Assert.That(ergebnis.Problems[0].Path, Is.EqualTo(gesperrt));
}
[Test]
public void Ein_Verzeichnis_das_es_nicht_gibt_wird_gemeldet_statt_zu_werfen()
{
var ergebnis = LibraryWalker.Walk(Path.Combine(_wurzel, "gibtesnicht"));
Assert.That(ergebnis.Files, Is.Empty);
Assert.That(ergebnis.Problems, Has.Count.EqualTo(1));
}
[Test]
public void Ein_leerer_Bestand_ist_kein_Fehler()
{
var ergebnis = LibraryWalker.Walk(_wurzel);
Assert.That(ergebnis.Files, Is.Empty);
Assert.That(ergebnis.Problems, Is.Empty);
}
}
public class SortTitleTests
{
[TestCase("Der Untergang", "Untergang")]
[TestCase("Die Welle", "Welle")]
[TestCase("Das Boot", "Boot")]
[TestCase("The Matrix", "Matrix")]
[TestCase("A Quiet Place", "Quiet Place")]
[TestCase("An American Werewolf", "American Werewolf")]
[TestCase("Blade Runner", "Blade Runner")]
[TestCase("Theater", "Theater")]
public void Der_Artikel_faellt_fuers_Sortieren_weg(string titel, string erwartet)
{
Assert.That(SortTitle.For(titel), Is.EqualTo(erwartet));
}
/// <summary>Ein Titel, der nur aus einem Artikel besteht, bleibt stehen.</summary>
[TestCase("Die")]
[TestCase("The")]
public void Ein_blosser_Artikel_bleibt_als_Titel_erhalten(string titel)
{
Assert.That(SortTitle.For(titel), Is.EqualTo(titel));
}
}