51 lines
2.3 KiB
Markdown
51 lines
2.3 KiB
Markdown
# Einheiten: backend/tft/paths.py
|
|
stand: f41ac76b5789
|
|
|
|
## backend/tft/paths.py::static_dir
|
|
beschreibung: Liefert den Pfad zum Verzeichnis der statischen Daten für ein bestimmtes Set und einen Patch.
|
|
input: `set_number: int`, `patch: str`
|
|
output: Pfad zu `STATIC / f"set{set_number}_{patch}"`.
|
|
entscheidungen:
|
|
- Der Verzeichnisname kombiniert Set-Nummer und Patch durch einen Unterstrich.
|
|
beleg: "return STATIC / f\"set{set_number}_{patch}\""
|
|
- Der Pfad wird relativ zum vordefinierten STATIC-Wurzelverzeichnis gebildet.
|
|
beleg: "STATIC = DATA / \"static\""
|
|
kanten:
|
|
- nutzt: backend/tft/paths.py::STATIC
|
|
|
|
## backend/tft/paths.py::latest_static_pointer
|
|
beschreibung: Liefert den Pfad zur Pointer-Datei, die auf den aktuellsten statischen Datenstand verweist.
|
|
input: keine Parameter
|
|
output: Pfad zu `STATIC / "latest.json"`.
|
|
entscheidungen:
|
|
- Der aktuellste Datenstand wird über eine zentrale `latest.json`-Datei markiert.
|
|
beleg: "return STATIC / \"latest.json\""
|
|
- Die Funktion kapselt den Pfad zur Latest-Pointer-Datei als eigene Einheit.
|
|
beleg: "def latest_static_pointer() -> Path:"
|
|
kanten:
|
|
- nutzt: backend/tft/paths.py::STATIC
|
|
|
|
## backend/tft/paths.py::artifact_dir
|
|
beschreibung: Liefert den Pfad zum Artefakt-Verzeichnis eines Sets zu einem bestimmten Build-Datum.
|
|
input: `set_number: int`, `build_date: str`
|
|
output: Pfad zu `ARTIFACTS / f"set{set_number}" / build_date`.
|
|
entscheidungen:
|
|
- Artefakte werden zweistufig organisiert: erst nach Set-Nummer, dann nach Build-Datum.
|
|
beleg: "return ARTIFACTS / f\"set{set_number}\" / build_date"
|
|
- Der Pfad wird relativ zum vordefinierten ARTIFACTS-Wurzelverzeichnis gebildet.
|
|
beleg: "ARTIFACTS = DATA / \"artifacts\""
|
|
kanten:
|
|
- nutzt: backend/tft/paths.py::ARTIFACTS
|
|
|
|
## backend/tft/paths.py::latest_artifact_pointer
|
|
beschreibung: Liefert den Pfad zur Pointer-Datei des aktuellsten Artefakt-Builds für ein bestimmtes Set.
|
|
input: `set_number: int`
|
|
output: Pfad zu `ARTIFACTS / f"set{set_number}" / "latest.json"`.
|
|
entscheidungen:
|
|
- Pro Set existiert eine eigene `latest.json` als Pointer auf den aktuellsten Build.
|
|
beleg: "return ARTIFACTS / f\"set{set_number}\" / \"latest.json\""
|
|
- Der Set-spezifische Latest-Pointer liegt innerhalb des Set-Unterordners.
|
|
beleg: "ARTIFACTS / f\"set{set_number}\""
|
|
kanten:
|
|
- nutzt: backend/tft/paths.py::ARTIFACTS
|