Makefile Formatter

Makefile Formatter nimmt Makefile-Text als Eingabe und gibt eine konsistent formatierte Version aus, die GNU Make-Konventionen entspricht. Es richtet sich an Entwickler, Build-Ingenieure und Teams, die große Build-Systeme pflegen, und hilft, Diffs zu reduzieren und Code-Reviews zu verbessern. Die Formatierung bezieht sich auf die Makefile-Semantik, nicht auf die Ausführung von Befehlen, daher beeinflusst sie das Build-Ergebnis nicht.
Der Prozessor tokenisiert Zeilen, identifiziert Ziele, Variablen und Rezeptblöcke und wendet konfigurierbare Regeln an, z. B. das Umwandeln von nicht-tabbed Rezept-Einzügen in Tabs, das Ausrichten von linken Seiten und optional das Beibehalten von Kommentaren. Er unterstützt gängige Konstrukte wie Includes und einfache Konditionen, vermeidet jedoch Änderungen an der Build-Logik.
Mit optionalen Presets können Teams projektspezifische Stile erzwingen, steuern, welche Abschnitte ausgerichtet werden, und entscheiden, ob Definitionen neu angeordnet werden. Die Ausgabe ist eine deterministisch neu formatierte Makefile-Datei plus ein Error-/Issue-Log, das nicht-fatale Formatierungsnotizen beschreibt und revisionssichere Reviews ermöglicht.
Typische Anwendungen umfassen das Standardisieren von Makefiles über Repositorys hinweg, das Vorbereiten von Patches für Beiträge oder die Integration mit Linting- und CI-Pipelines, um einen konsistenten Stil sicherzustellen, ohne das Build-Verhalten zu beeinflussen.