20 lines
1.2 KiB
Markdown
20 lines
1.2 KiB
Markdown
# Einheiten: backend/tft/sim/pool.py
|
|
stand: f41ac76b5789
|
|
|
|
## backend/tft/sim/pool.py::Pool
|
|
beschreibung: Verwaltet einen endlichen Vorrat pro Champion-API-Einheit und regelt Entnahme sowie Rückgabe.
|
|
input: Konstruktor erhält ein Mapping von API-Namen zu Einheitendaten sowie eine Liste von Größen je Kostenstufe; Methoden nehmen API-Namen und Mengen entgegen.
|
|
output: Aktueller verfügbarer Bestand je Einheit, eine Liste lebender Einheiten eines bestimmten Kostens, sowie ein mutierter Vorrat nach Entnahme oder Rückgabe.
|
|
entscheidungen:
|
|
- Einheiten ohne gültige Kostenstufe (1 bis len(sizes)) werden aus dem Vorrat ausgeschlossen.
|
|
beleg: "if 1 <= u[\"cost\"] <= len(sizes)"
|
|
- Die Kosten jedes API-Namens werden in einem separaten Mapping gehalten, um günstig nach Kosten zu filtern.
|
|
beleg: "self.cost_of = {api: u[\"cost\"] for api, u in static_units.items()}"
|
|
- Eine Einheit gilt nur dann als verfügbar, wenn sie noch nicht aufgebraucht ist.
|
|
beleg: "self.copies[a] > 0"
|
|
- Eine Entnahme über den aktuellen Bestand hinaus wird als Fehler signalisiert.
|
|
beleg: "raise ValueError(f\"pool exhausted for {api_name}\")"
|
|
- Nicht im Vorrat enthaltene API-Namen werden bei Anfragen als null verfügbar behandelt.
|
|
beleg: "return self.copies.get(api_name, 0)"
|
|
kanten:
|