sauberer generierter Code ohne manuelle Nacharbeit
Code-Generierung aus OpenAPI-Spezifikationen klingt verlockend, produziert in der Praxis aber oft unlesbaren Müll, der sofort manuell gepatcht werden muss. Das zerstört den Hauptvorteil der Generierung. Dieser Artikel zeigt, wie man openapi-generator so konfiguriert, dass der Ausgabecode wartbar ist – und warum Template-Overrides der Schlüssel dazu sind.
Inhaltsverzeichnis
- 1. Warum Codegen scheitert und warum es trotzdem lohnt
- 2. openapi-generator: Generator-Auswahl und Basis-Setup
- 3. Konfigurationsdatei: alle Hebel an einem Ort
- 4. Template-Overrides: Müll durch eigene Mustache-Templates ersetzen
- 5. PHP-Client generieren: Guzzle, PSR-18 und Namespace-Kontrolle
- 6. TypeScript-Client: fetch-basiert ohne