Go fmt Formatter

Syfte och användarintent: Go fmt Formatter analyserar Go-källkod och formaterar den enligt det standard Gofmt-snittet. Huvudanvändare är Go-utvecklare, kodunderhåll, redaktörer och CI-pipelines som kräver deterministisk formattering före commits eller automatiska granskningar. Den stödjer förberedelse av diffs, genomdrivande av en gemensam bas och förbättrad läsbarhet i stora kodbaser.
Kärnlogik & Funktioner: Krävs: tolka inmatad Go-källa och tillämpa formatering med Go:s standardbibliotekets formatter, returnera den formaterade koden och ett statusindikator. Avancerat: in-memory multi-file formattering, radslut-normalisering och batch-behandling för många filer i en körning; kommentarer bevaras och indentering standardiseras enligt tabbar.
In- och utdata: Indata: kod (sträng, UTF-8, exempel tillhandahållet). Utdata: formatted_code (sträng), status (sträng), parse_error (sträng, tom vid framgång). Validering säkerställer att inmatningen är giltig Go-källa innan formatering; annars returneras ett fel utan att ändra innehållet.
Algoritmer & Beräkningar: Implementeringen delegerar formatering till Go:s standardbibliotek go/format för att utföra kanonisk formatering; resultatet är deterministiskt för given inmatning. Om inmatningen inte kan parseas som Go returneras parse_error med detaljer. Ingen semantisk analys eller lint-regler tillämpas.
Felhantering & Kantfall: Tom inmatning ger tom utdata och framgångsstatus. Icke-Go-innehåll eller ogiltig syntax ger ett strukturerat fel utan att ändra kod. Väldigt stora filer kan behandlas i streamingvänliga chunkar vid behov, annars avhostad. Radslut konverteras till LF som standard.
Industri/Region & Lokalisering: UTF-8-kodning; formateringsreglerna är språkneutrala och konsekventa över regioner. Antagna Go-miljöer standard.
Antaganden & Begränsningar: Förutsätter att inmatningen är Go-källkod; ingen lintning, semantiska korrigeringar eller översättning av kod; är inte avsedd för att formatera icke-Go-språk eller inbäddad kod utanför Go-källfiler.