v0.5.0 ist da · Was ist neu?

fsg

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
Ein Beispiel

Zwei Marker, ein Befehl

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 & Abschnitte
README.md
## Project structure <!-- fsg:start path=src dirs-only --> ```plaintext src/└── fsg/ ├── hooks/ # commit hook setup └── trees/ # git and plain directory walk ``` <!-- fsg:end -->

Beachtet .gitignore

In 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.

Nie veraltet

--update schreibt den markierten Block neu, --check lässt die CI bei veraltetem Baum scheitern und --setup-hook aktualisiert bei jedem Commit.

Keine Abhängigkeiten

Reines Python 3.11+, MIT-lizenziert. Läuft mit uvx unter Linux, macOS und Windows, ohne dass du etwas anderes installieren musst.

Fehler gefunden oder fehlt eine Option?

Eröffne ein Issue auf GitHub. Pull Requests sind willkommen, Übersetzungen dieser Doku auch.