"""Tests für scripts/pruefe_prozesse.py und für den Bestand der Prozessbibliothek – reines Python/pytest.""" import sys import warnings from pathlib import Path ROOT = Path(__file__).resolve().parents[1] sys.path.insert(0, str(ROOT / "scripts")) import pruefe_prozesse as pp # noqa: E402 MODELL = """Prozess: Testprozess S1 Start: Beginn S2 Task: Etwas tun S3 Ende: Fertig """ STECKBRIEF = """# Testprozess | | | |---|---| | Status | {status} | | Stand | 2026-09-23 | """ def lege_prozess_an(wurzel, name="test-prozess", status="Entwurf"): ordner = wurzel / name ordner.mkdir() md = ordner / f"{name}.md" md.write_text(MODELL, encoding="utf-8") (ordner / f"{name}.bpmn").write_bytes(pp.erzeuge_bpmn(md)) (ordner / "README.md").write_text(STECKBRIEF.format(status=status), encoding="utf-8") return ordner def test_bestand_der_bibliothek_und_beispiele_ist_konsistent(): """Prüft, dass alle Prozessordner der geklonten Prozessbibliothek und die Skill-Beispiele ohne Befund sind.""" if not pp.BIBLIOTHEK.is_dir(): warnings.warn(f"Prozessbibliothek nicht geklont ({pp.BIBLIOTHEK}) – nur die Skill-Beispiele geprüft. " "Klonen mit: python scripts/setup_workspace.py") assert pp.pruefe_alles() == [] def test_bibliothek_liegt_als_klon_neben_projektwissen(): """Prüft, dass die Prozessbibliothek unter dem Klon-Ordner aus workspace.toml/workspace.local.toml gesucht wird.""" import setup_workspace assert pp.BIBLIOTHEK == setup_workspace.repos_root() / "Prozessbibliothek" def test_prozessordner_ohne_punktordner(tmp_path): """Prüft, dass .git und andere Punkt-Ordner im Bibliotheks-Klon nicht als Prozess gelten.""" lege_prozess_an(tmp_path) (tmp_path / ".git").mkdir() (tmp_path / ".gitea").mkdir() assert [o.name for o in pp.prozessordner(tmp_path)] == ["test-prozess"] def test_fremde_datei_in_der_bibliothekswurzel_wird_gemeldet(tmp_path): """Prüft, dass in der Wurzel der Bibliothek nur die Repo-Dateien erlaubt sind und alles andere gemeldet wird.""" lege_prozess_an(tmp_path) for erlaubt in ("README.md", "AGENTS.md", "CLAUDE.md", ".gitattributes", ".gitignore"): (tmp_path / erlaubt).write_text("", encoding="utf-8") (tmp_path / "antrag.bpmn").write_text("", encoding="utf-8") befunde = pp.pruefe_bibliothek(tmp_path) assert len(befunde) == 1 and "antrag.bpmn" in befunde[0] def test_fehlende_bibliothek_ist_kein_befund_aber_ein_hinweis(tmp_path): """Prüft, dass eine nicht geklonte Bibliothek keinen Befund, aber einen Hinweis auf setup_workspace.py ergibt.""" fehlt = tmp_path / "Prozessbibliothek" assert pp.pruefe_bibliothek(fehlt) == [] assert "setup_workspace.py" in pp.hinweis_bibliothek(fehlt) fehlt.mkdir() assert pp.hinweis_bibliothek(fehlt) == "" def test_es_gibt_mindestens_ein_beispiel(): """Prüft, dass der Abgleich .md/.bpmn wenigstens an den Skill-Beispielen tatsächlich greift.""" assert pp.beispiele(), "keine Beispiele in .agents/skills/sn-bpmn/beispiele/" def test_gueltiger_prozessordner_hat_keine_befunde(tmp_path): """Prüft, dass ein vollständiger Ordner mit aktueller .bpmn und gültigem Status durchgeht.""" assert pp.pruefe_ordner(lege_prozess_an(tmp_path)) == [] def test_status_abgenommen_ist_gueltig(tmp_path): """Prüft, dass der Status 'abgenommen' akzeptiert wird.""" assert pp.pruefe_ordner(lege_prozess_an(tmp_path, status="abgenommen")) == [] def test_unbekannter_status_wird_gemeldet(tmp_path): """Prüft, dass ein Status außerhalb von Entwurf/abgenommen gemeldet wird.""" befunde = pp.pruefe_ordner(lege_prozess_an(tmp_path, status="fertig")) assert any("Status 'fertig' unbekannt" in b for b in befunde) def test_fehlende_statuszeile_wird_gemeldet(tmp_path): """Prüft, dass ein Steckbrief ohne Statuszeile gemeldet wird.""" ordner = lege_prozess_an(tmp_path) (ordner / "README.md").write_text("# Testprozess\n", encoding="utf-8") assert any("Status | … |' fehlt" in b for b in pp.pruefe_ordner(ordner)) def test_ungueltiger_ordnername_wird_gemeldet(tmp_path): """Prüft, dass Großbuchstaben oder Unterstriche im Ordnernamen gemeldet werden.""" befunde = pp.pruefe_ordner(lege_prozess_an(tmp_path, name="Antrag_Pruefen")) assert any("Ordnername" in b for b in befunde) def test_fehlende_bpmn_wird_gemeldet(tmp_path): """Prüft, dass ein Ordner ohne erzeugte .bpmn gemeldet wird.""" ordner = lege_prozess_an(tmp_path) (ordner / "test-prozess.bpmn").unlink() befunde = pp.pruefe_ordner(ordner) assert any("test-prozess.bpmn fehlt" in b for b in befunde) def test_fremde_datei_im_prozessordner_wird_gemeldet(tmp_path): """Prüft, dass zusätzliche Dateien (etwa eine Original-PDF) im Prozessordner gemeldet werden.""" ordner = lege_prozess_an(tmp_path) (ordner / "quelle.pdf").write_bytes(b"%PDF") assert any("quelle.pdf gehört nicht hierher" in b for b in pp.pruefe_ordner(ordner)) def test_veraltete_bpmn_wird_gemeldet(tmp_path): """Prüft, dass eine .bpmn gemeldet wird, die nach einer Änderung der .md nicht neu erzeugt wurde.""" ordner = lege_prozess_an(tmp_path) md = ordner / "test-prozess.md" md.write_text(MODELL.replace("Etwas tun", "Etwas anderes tun"), encoding="utf-8") assert any("passt nicht zu test-prozess.md" in b for b in pp.pruefe_ordner(ordner)) def test_zeilenenden_der_bpmn_spielen_keine_rolle(tmp_path): """Prüft, dass eine unter Windows mit CRLF ausgecheckte .bpmn nicht als veraltet gilt.""" ordner = lege_prozess_an(tmp_path) bpmn = ordner / "test-prozess.bpmn" bpmn.write_bytes(bpmn.read_bytes().replace(b"\n", b"\r\n")) assert pp.pruefe_ordner(ordner) == [] def test_nicht_umwandelbare_md_wird_gemeldet(tmp_path): """Prüft, dass eine .md mit Syntaxfehler (doppelte Schritt-ID) als Befund statt als Absturz endet.""" ordner = lege_prozess_an(tmp_path) (ordner / "test-prozess.md").write_text(MODELL + "S2 Task: Noch einmal S2\n", encoding="utf-8") assert any("lässt sich nicht umwandeln" in b for b in pp.pruefe_ordner(ordner))