Files
Flaro/Packages/HaloKit/Sources/HaloDownloads/DownloadState.swift
T
ScarriffleandClaude Opus 5 4b9a1e7b67 Flixy heißt ab hier Halo
Reine Umbenennung, kein Verhalten geändert — bewusst als eigener Commit,
damit „umbenannt" und „umgebaut" im Nachhinein auseinanderzuhalten sind.

712 mal `Flixy`, 778 mal `flixy`, 7 mal `FLIXY` in 169 Dateien, dazu 25
Pfade. Ziele: `Halo`, `HaloTV`, `HaloTopShelf`, `HaloUITests`, `HaloKit` mit
`HaloDesign`, `HaloDownloads`, `HaloPlayback` und `HaloProbe`. `MediaKit`,
`JellyfinKit` und `DownloadWidget` tragen den Namen nicht und bleiben.

`docs/superpowers/specs/` ist ausgenommen. Datierte Entwurfsdokumente sind
ein Protokoll getroffener Entscheidungen; sie nachträglich umzuschreiben
hiesse, die Vergangenheit zu glätten.

**Die Bundle-ID wandert mit** — ausdrücklich so gewollt, mit bekanntem Preis:
`com.scarriffleservices.halo` ist für iOS eine *andere* App. Die installierte
Fassung bleibt daneben stehen, mit Downloads und Anmeldung in ihrem Container;
Halo startet leer. Einmal neu anmelden, heruntergeladene Folgen einmal neu
laden. Dasselbe gilt für die App-Gruppe, die sich TV-App und Top Shelf teilen.

**Eine Folge davon, die beim Entscheiden noch nicht auf dem Tisch lag:** der
Aufräumschritt aus dem vorigen Commit kommt an die alten Plex-Token nicht mehr
heran. Der Schlüsselbund grenzt nach Team und Bundle-Kennung ab — was unter
`…flixy` liegt, ist für `…halo` unerreichbar. Erledigt wird es trotzdem, nur
anders: **die alte App löschen.** iOS räumt deren Schlüsselbund-Einträge beim
Deinstallieren mit ab. Der Code bleibt stehen, weil er für jeden Stand vor
dieser Umbenennung richtig ist und im Jahr einen Startvergleich kostet.

Die Projektdatei ist aus `project.yml` neu erzeugt, der alte Ordner gelöscht
statt umbenannt — sie steht ohnehin nicht im Repo.

Das Verzeichnis des Repos selbst heißt weiter `Flixy`; das umzubenennen ist
ein Handgriff ausserhalb des Projekts.

368 Tests grün. iOS und tvOS bauen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-03 11:12:32 +02:00

62 lines
2.2 KiB
Swift

import Foundation
/// Der Lebenslauf eines Downloads.
///
/// Bewusst als geschlossene Aufzählung mit einer geprüften Übergangstabelle:
/// die Engine läuft im Hintergrund weiter, während die App beendet ist, und
/// beim nächsten Start muss aus dem gespeicherten Zustand eindeutig
/// hervorgehen, was zu tun ist.
public enum DownloadState: String, Sendable, Equatable, Codable, CaseIterable {
/// Steht in der Warteschlange, hat noch keinen Platz bekommen.
case queued
/// Überträgt gerade.
case downloading
/// Vom Nutzer angehalten — der Wiederaufnahme-Datensatz liegt bereit.
case paused
/// Wartet auf Bedingungen: WLAN fehlt, Speicherlimit erreicht.
case waiting
case completed
case failed
/// Ob aus diesem Zustand heraus übertragen werden darf.
public var isTransferable: Bool {
switch self {
case .queued, .waiting: true
case .downloading, .paused, .completed, .failed: false
}
}
/// Ob der Eintrag Platz auf dem Gerät belegt.
public var occupiesStorage: Bool {
switch self {
// Angehaltene und laufende Downloads haben bereits Daten auf der
// Platte. Wer sie beim Speicherlimit nicht mitzählt, wundert sich,
// warum das Gerät trotz gesetzter Grenze volläuft.
case .downloading, .paused, .completed: true
case .queued, .waiting, .failed: false
}
}
public func canTransition(to next: DownloadState) -> Bool {
switch (self, next) {
case (.queued, .downloading), (.queued, .waiting), (.queued, .failed):
true
case (.waiting, .downloading), (.waiting, .queued), (.waiting, .failed):
true
case (.downloading, .paused), (.downloading, .completed),
(.downloading, .failed), (.downloading, .waiting):
true
case (.paused, .queued), (.paused, .downloading), (.paused, .failed):
true
// Ein gescheiterter Download darf neu in die Warteschlange — das ist
// der Wiederholen-Knopf.
case (.failed, .queued):
true
case (.completed, _):
false
default:
false
}
}
}