Go fmt Formatter

Scopo e intento dell'utente: Go fmt Formatter analizza il codice Go e lo formatta secondo lo stile standard gofmt. Utenti principali: sviluppatori Go, manutenzione del codice, editor e pipeline CI che richiedono una formattazione deterministica prima dei commit o delle revisioni automatizzate. Supporta la preparazione dei diff, l'applicazione di una baseline comune e il miglioramento della leggibilità in grandi codebase.
Logica principale e funzioni: Obbligatorio: analizzare l'input Go e applicare la formattazione con il formatter della libreria standard Go, restituendo il codice formattato e un indicatore di successo. Opzionale/avanzato: formattazione multi-file in memoria, normalizzazione delle interruzioni di riga e elaborazione a batch per gestire molti file in una singola esecuzione; i commenti sono preservati e l'indentazione è normalizzata secondo le tabulazioni.
Ingressi e uscite: Ingressi: codice (stringa, UTF-8, esempio fornito). Uscite: formatted_code (stringa), status (stringa), parse_error (stringa, vuoto in caso di successo). La validazione garantisce che l'input sia Go-source valido prima della formattazione; in caso contrario viene restituito un errore senza modificare il contenuto.
Algoritmi e calcoli: l'implementazione delega la formattazione a go/format della libreria standard Go per eseguire una formattazione canonica; il risultato è deterministico per un input dato. Se l'input non può essere analizzato come Go, il formatter restituisce parse_error con dettagli. Nessuna analisi semantica o regole di linting vengono applicate.
Errori e casi limite: Input vuoto produce output formattato vuoto con stato di successo. Contenuti non-Go o sintassi non valida producono un errore strutturato senza modificare il codice. File molto grandi possono essere elaborati a blocchi in streaming se supportato, altrimenti avvolti dall'host. Terminatori di linea normalizzati a LF di default.
Industria/regione e localizzazione: Codifica UTF-8; le regole di formattazione sono indipendenti dalla lingua e coerenti tra regioni. Ambienti Go standard sono presunti.
Assunzioni ed esclusioni: Si presume che l'input sia codice sorgente Go; no linting, correzioni semantiche o traduzioni del codice; non progettato per formattare lingue non-Go o codice incorporato al di fuori di file sorgente Go.