update

backend/verzeichnis.py

@@ -0,0 +1,75 @@
+"""Das Arbeitsverzeichnis eines Projekts — dort implementiert der Agent.
+
+Der Pfad liegt als eine Zeile im Projektordner und wandert beim Umbenennen mit.
+Er ist eine Eigenschaft des Projekts, nicht der Planung: gelesen und geschrieben
+wird immer im Projektstand, damit ein Planungsabbruch ihn nicht mitnimmt.
+"""
+
+import os
+from pathlib import Path
+
+import projekte
+
+DATEI = ".verzeichnis"
+
+
+def _pfad(projekt: str):
+    return projekte.stand(projekt) / DATEI
+
+
+def lies(projekt: str) -> str:
+    """Der eingestellte Pfad, oder leer."""
+    try:
+        return _pfad(projekt).read_text().strip()
+    except OSError:
+        return ""
+
+
+def pruefe(pfad: str) -> Path:
+    """Taugt der Pfad als Arbeitsverzeichnis? Gibt ihn aufgelöst zurück oder wirft."""
+    pfad = (pfad or "").strip()
+    if not pfad:
+        raise ValueError("Kein Pfad angegeben")
+    ziel = Path(os.path.expanduser(pfad))
+    if not ziel.is_absolute():
+        raise ValueError("Der Pfad muss absolut sein")
+    ziel = ziel.resolve()
+    if not ziel.is_dir():
+        raise FileNotFoundError(f"„{ziel}“ ist kein Verzeichnis")
+    if ziel == Path(ziel.anchor) or ziel == Path.home():
+        # Die Wurzel oder das ganze Heimatverzeichnis ist immer ein Fehlgriff
+        raise ValueError("Bitte ein Projektverzeichnis wählen, nicht die Wurzel")
+    return ziel
+
+
+def setze(projekt: str, pfad: str) -> str:
+    ziel = pruefe(pfad)
+    _pfad(projekt).write_text(f"{ziel}\n")
+    return str(ziel)
+
+
+def loesche(projekt: str):
+    _pfad(projekt).unlink(missing_ok=True)
+
+
+def ordner(pfad: str = "") -> dict:
+    """Ein Verzeichnis zum Durchblättern: Unterordner, ohne Verstecktes.
+
+    Kein Pfad heißt Heimatverzeichnis — dort beginnt die Suche. Die Auswahl
+    trifft der Mensch; hier wird nur gelistet, nie geschrieben.
+    """
+    ziel = Path(os.path.expanduser(pfad.strip())) if pfad.strip() else Path.home()
+    if not ziel.is_absolute():
+        raise ValueError("Der Pfad muss absolut sein")
+    ziel = ziel.resolve()
+    if not ziel.is_dir():
+        raise FileNotFoundError(f"„{ziel}“ ist kein Verzeichnis")
+    try:
+        unter = sorted(
+            (e.name for e in ziel.iterdir()
+             if e.is_dir() and not e.name.startswith(".")),
+            key=str.lower)
+    except PermissionError:
+        raise ValueError(f"„{ziel}“ ist nicht lesbar")
+    eltern = str(ziel.parent) if ziel.parent != ziel else ""
+    return {"pfad": str(ziel), "eltern": eltern, "ordner": unter}