Go fmt Formatter

Zweck & Benutzerziel: Der Go fmt Formatter analysiert Go-Quellcode und formatiert ihn gemäß dem standard Gofmt-Stil neu. Hauptnutzer sind Go-Entwickler, Code-Wartungsteams, Editorinnen und CI-Pipelines, die deterministische Formatierung vor Commits oder automatischen Reviews benötigen. Er unterstützt das Vorbereiten von Diffs, das Durchsetzen einer gemeinsamen Basislinie und die Verbesserung der Lesbarkeit in großen Codebasen.
Kernlogik & Funktionen: Erforderlich: Eingabe-Go-Quelle parsen und mit dem Go-Standard-Library-Formatter formatieren; formatierten Code und Erfolgsindikator zurückgeben. Optional/fortgeschritten: In-Memory-Multi-Dateiformatierung, Zeilenumbrüche normalisieren und Batch-Verarbeitung für viele Dateien in einem Durchgang; Kommentare bleiben erhalten und Einrückung gemäß Tabs standardisieren.
Eingaben & Ausgaben: Eingaben: Code (String, UTF-8, Beispiel). Ausgaben: formatted_code (String), status (String), parse_error (String, leer bei Erfolg). Validierung stellt sicher, dass der Input gültiger Go-Quellcode ist; andernfalls wird ein Fehler zurückgegeben, ohne den Inhalt zu ändern.
Algorithmen & Berechnungen: Die Implementierung übergibt an die Go-Standardbibliothek go/format, um eine kanonische Formatierung durchzuführen; das Ergebnis ist deterministisch für einen gegebenen Input. Falls der Input nicht als Go geparst werden kann, gibt der Formatter einen parse_error mit Details zurück. Es werden keine semantischen Analysen oder Lint-Regeln angewendet.
Fehler & Randfälle: Leerer Input führt zu leerem formatiertem Output mit Erfolg-Status. Nicht-Go-Inhalte oder ungültige Syntax führen zu einem strukturierten Fehler, ohne Code zu ändern. Sehr große Dateien werden ggf. in streaming-freundlichen Chunken verarbeitet, sonst vom Host eingewickelt. Zeilenenden werden standardmäßig auf LF normalisiert.
Industrie/Region & Lokalisierung: UTF-8-Codierung; Formatierungsregeln sind sprachneutral und konsistent über Regionen hinweg. Standard-Go-Umgebungen werden angenommen.
Annahmen & Ausschlüsse: Annahme, dass der Input Go-Quellcode ist; keine Linting-, semantische Korrekturen oder Übersetzungen von Code; Nicht zur Formatierung von Nicht-Go-Sprachen oder eingebettetem Code außerhalb Go-Quelldateien gedacht.