fsg/ ├── file/ # beachtet .gitignore├── structure/ # Kommentare bleiben erhalten└── generator.py # hält deine README aktuell fsg erzeugt saubere Projektbäume, die .gitignore beachten, und hält sie in deiner README aktuell – mit Prüfung für die CI und einem Commit-Hook, der das für dich erledigt.
$ uv tool install fsg Setz die Marker dorthin, wo der Baum stehen soll, und führe fsg --update README.md aus. Optionen im Start-Marker gelten nur für diesen Baum, Kommentare neben einem Eintrag bleiben bei jedem Update erhalten.
Marker & AbschnitteIn einem Git-Repository erscheinen nur Dateien, die git verfolgt oder verfolgen würde. Außerhalb werden Build- und Tool-Ordner wie .venv, node_modules oder target übersprungen.
--update schreibt den markierten Block neu, --check lässt die CI bei veraltetem Baum scheitern und --setup-hook aktualisiert bei jedem Commit.
Reines Python 3.11+, MIT-lizenziert. Läuft mit uvx unter Linux, macOS und Windows, ohne dass du etwas anderes installieren musst.
Eröffne ein Issue auf GitHub. Pull Requests sind willkommen, Übersetzungen dieser Doku auch.