Files
Flaro/server/src/Halo.Core/Library/LibraryWalker.cs
T
ScarriffleandClaude Opus 5 78b7e3bcb8 Stufe 2a: Der Bestand wird gelesen, nicht mehr nur verwaltet
Dateinamen erkennen, Verzeichnisse durchlaufen, abgleichen, blättern. Noch
ohne TMDB — die Titel kommen vorerst aus den Dateinamen, und genau daran
entscheidet sich später, ob die Metadatenquelle etwas findet.

**Der Dateiname ist die Stelle, an der Medienserver in der Praxis scheitern.**
Was auf der Platte liegt, heisst nicht „Der Fall", sondern
`Notruf.Hafenkante.S01E01.German.1080p.WEB-DL.x264-GRP.mkv`. Das Verfahren
schneidet ab dem ersten Technik-Merkmal ab, statt einzelne Tags
herauszulösen: Letzteres klingt gründlicher, lässt aber bei jedem unbekannten
Tag Bruchstücke stehen — und unbekannte Tags gibt es immer.

Drei Fälle, an denen sich die Regeln entscheiden, alle geprüft:

- **„Blade Runner 2049" behält seine Zahl.** Eine Jahreszahl muss plausibel
  sein; was weit in der Zukunft liegt, gehört zum Titel. Ohne diese Grenze
  hiesse der Film „Blade Runner", erschienen 2049, und keine Metadatenquelle
  fände ihn so.
- **„S.W.A.T." behält seine Punkte.** Trennpunkte werden nur dort zu
  Leerzeichen, wo sonst keine sind — stehen welche im Namen, hat jemand von
  Hand benannt, und seine Punkte sind gewollt. (Der Schlusspunkt fiel erst
  einem Test auf.)
- **Ohne Folgennummer wird nichts geraten.** Eine erfundene Staffel 1 landete
  unter einer Serie, zu der die Datei nicht gehört.

**`@eaDir` ist der Grund, warum der Walker von Hand absteigt.** Synologys
Vorschauablage enthält eine Kopie *jeder* Datei; mit
`SearchOption.AllDirectories` — der bequemen Fassung — stünde jeder Film
zweimal in der Mediathek, zur Hälfte als unbrauchbare Kopie. Äste beschneiden
kann nur, wer selbst absteigt. Ein gesperrter Unterordner bricht den Lauf
nicht ab, sondern wird vermerkt.

**Die Datei zeigt auf den Titel, nicht umgekehrt.** Sieht herumgedreht aus und
ist Absicht: ein Film liegt oft als 4K *und* als 1080p vor. Trüge der Film den
Verweis auf seine eine Datei, wäre die zweite Fassung ein Umbau am
Datenmodell — so ist sie eine Zeile mehr. Geprüft.

**Der Scan läuft im Hintergrund**, nicht in der Anfrage: ein Bestand mit
40 000 Titeln braucht Minuten, und eine so lange offene Anfrage läuft hinter
jedem Reverse Proxy ins Zeitlimit. Einer je Bibliothek, sonst löschen sich
zwei Läufe gegenseitig die Einträge. Aufgeräumt wird über den Zeitstempel des
Laufs — billiger, als sich alle gesehenen Pfade zu merken.

Zweimal scannen ergibt dasselbe wie einmal. Das ist der Fehler, den man sonst
erst nach Wochen bemerkt, wenn jeder Film fünfmal dasteht.

131 Tests grün (88 Kern, 43 Schnittstelle).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-03 13:56:25 +02:00

94 lines
3.4 KiB
C#

namespace Halo.Core.Library;
/// <summary>Eine gefundene Datei, so wie das Dateisystem sie beschreibt.</summary>
public sealed record ScannedFile(string Path, long SizeBytes, DateTimeOffset ModifiedAt);
/// <summary>Was beim Durchlaufen schiefging, ohne den Lauf abzubrechen.</summary>
public sealed record WalkProblem(string Path, string Reason);
public sealed record WalkResult(IReadOnlyList<ScannedFile> Files, IReadOnlyList<WalkProblem> Problems);
/// <summary>Läuft ein Bibliotheksverzeichnis ab und sammelt Videodateien.</summary>
///
/// <remarks>
/// <para>
/// <b>Von Hand rekursiv statt mit <c>AllDirectories</c>.</b> Die bequeme
/// Fassung läuft auch in <c>@eaDir</c> hinein — Synologys Vorschauablage, die
/// eine Kopie <i>jeder</i> Datei enthält. Wer sie mitnimmt, hat seine
/// Mediathek doppelt, zur Hälfte mit unbrauchbaren Dateien. Äste beschneiden
/// kann nur, wer selbst absteigt.
/// </para>
/// <para>
/// <b>Ein gesperrtes Unterverzeichnis bricht den Lauf nicht ab</b>, sondern
/// wird vermerkt. Sonst entschiede ein einzelner falsch gesetzter Ordner
/// darüber, ob überhaupt etwas gefunden wird — und die Mediathek bliebe leer,
/// ohne dass jemand sagen könnte, warum.
/// </para>
/// </remarks>
public static class LibraryWalker
{
/// <summary>Tiefer als das ist kein Bestand, sondern eine Schleife.</summary>
///
/// <remarks>
/// Verweise im Dateisystem können im Kreis zeigen. Ohne Grenze liefe der
/// Scan, bis der Arbeitsspeicher voll ist.
/// </remarks>
private const int MaximaleTiefe = 12;
public static WalkResult Walk(string wurzel)
{
var gefunden = new List<ScannedFile>();
var probleme = new List<WalkProblem>();
if (!Directory.Exists(wurzel))
{
probleme.Add(new WalkProblem(wurzel, "Das Verzeichnis gibt es nicht."));
return new WalkResult(gefunden, probleme);
}
Absteigen(wurzel, 0, gefunden, probleme);
return new WalkResult(gefunden, probleme);
}
private static void Absteigen(string ordner, int tiefe, List<ScannedFile> gefunden, List<WalkProblem> probleme)
{
if (tiefe > MaximaleTiefe)
{
probleme.Add(new WalkProblem(ordner, $"Tiefer als {MaximaleTiefe} Ebenen — hier wird nicht weitergesucht."));
return;
}
string[] dateien, unterordner;
try
{
dateien = Directory.GetFiles(ordner);
unterordner = Directory.GetDirectories(ordner);
}
catch (Exception fehler) when (fehler is UnauthorizedAccessException or IOException)
{
probleme.Add(new WalkProblem(ordner, fehler.Message));
return;
}
foreach (var datei in dateien)
{
if (!MediaExtensions.IsVideo(datei)) continue;
try
{
var angaben = new FileInfo(datei);
gefunden.Add(new ScannedFile(datei, angaben.Length, angaben.LastWriteTimeUtc));
}
catch (Exception fehler) when (fehler is UnauthorizedAccessException or IOException)
{
probleme.Add(new WalkProblem(datei, fehler.Message));
}
}
foreach (var unter in unterordner)
{
if (MediaExtensions.IsSkippedDirectory(Path.GetFileName(unter))) continue;
Absteigen(unter, tiefe + 1, gefunden, probleme);
}
}
}