Formatter di codice

Scopo & Intento utente: Un formatter di codice sensibile al linguaggio che riformatta il codice sorgente in più linguaggi per imporre uno stile coerente, ridurre i diff e migliorare la leggibilità. Gli utenti target sono sviluppatori, revisori di codice e ingegneri CI che lavorano su basi di codice condivise e necessitano di una formattazione deterministica prima di commit o pull request. Quando è necessario standardizzare spaziatura, indentazione, virgolette o lunghezza delle righe in un progetto, questo strumento formatta l’input di conseguenza.
Logica di base & Funzionalità: Capacità di parsing basata sul linguaggio e ristampa basata su AST. Funzionalità richieste: input linguaggio (esplicito o dedotto), costruzione AST robusta, conservazione di commenti e letterali di stringa, formattazione configurabile (indentazione, lunghezza di riga, virgole finali, stile di virgolette, uso del punto e virgola). Funzionalità opzionali/ avanzate: più preset di stile (es. Google, simile a PEP8 per Python, Spring/Google per Java), configurazioni utente personalizzate, minificazione per linguaggi supportati, formattazione in/out-of-place e output diff opzionale. Output: formatted_code e diagnostica opzionale.
Algoritmi & Calcoli: Lo strumento analizza il codice in AST specifici per linguaggio, applica regole di formattazione e stampa di nuovo il codice mantenendo la semantica. Impone terminazioni di riga e spaziatura, limita la lunghezza delle righe quando possibile, e rispetta le preferenze dell’utente. Se l’analisi fallisce per un linguaggio, può ricorrere a una reformatta sicura o restituire diagnostica senza modificare la semantica.
Errori & Casi limite: Input mancanti producono errori; linguaggi non supportati generano diagnostiche chiare; input molto grandi viene suddiviso; errori di sintassi gestiti con modifiche minime; dati esterni non devono essere recuperati. Industria/Regione & Localizzazione: Supporta fine di linea LF/CRLF e gestione di identificatori locali ove applicabile; nessuna modifica a codici regionali a meno che non facciano parte della sintassi del linguaggio. Assunzioni & Esclusioni: L’input è codice in un linguaggio supportato e viene formattato solo; non esegue linting, compilazione o esecuzione del codice; non è un editor e non ha comportamento UI.