Loading…

Informazioni Formattatore TOML Online

Configurazioni `pyproject.toml`, `Cargo.toml` o `poetry` disordinate? Incolla il tuo TOML o rilascia un file e il nostro formattatore normalizzerà gli spazi bianchi, ordinerà array e tabelle inline e manterrà le sezioni uniformemente spaziate. Ideale per Python, Rust, Go, generatori di siti statici e qualsiasi progetto che si affida a TOML per la configurazione.

Caratteristiche Principali del Formattatore TOML

  • **Abbellitore con un clic** per file di configurazione e frammenti TOML
  • **Dimensione indentazione configurabile** da 1 a 8 spazi tramite il cursore *Dimensione Indentazione*
  • **Alternativa stile indentazione** – scegli tra spazi o tabulazioni per l'indentazione
  • **Controllo A capo / Lunghezza Riga** per mantenere array lunghi e tabelle inline entro una larghezza di colonna scelta
  • Supporta file `.toml` come `pyproject.toml`, `Cargo.toml`, `Pipfile.toml`, `poetry.toml` e altri
  • Parser TOML basato su Prettier che comprende date, array, tabelle nidificate e tabelle inline
  • Formattazione stabile e idempotente – rieseguirla sullo stesso file non causerà deriva di formattazione
  • Copia con un clic dell'output formattato, pronto per il tuo editor o commit

🛠️ Come Formattare File TOML Online for toml-formatter

1

1. Incolla o Carica il Tuo TOML

📥 Incolla TOML nell'editor o trascina e rilascia un file `.toml` come `pyproject.toml` o `Cargo.toml`. Lo strumento analizza il contenuto come TOML, non come INI/JSON generico.

2

2. Scegli Impostazioni Indentazione e A capo

⚙️ Usa il cursore **Dimensione Indentazione** per scegliere quanti spazi per livello di indentazione, e cambia **Stile Indentazione** in tabulazioni se il tuo progetto le preferisce. Regola **A capo / Lunghezza Riga** per controllare quando array lunghi o tabelle inline dovrebbero andare a capo (o impostalo a `0` per disabilitare efficacemente l'a capo).

3

3. Clicca "Formatta"

🚀 Premi il pulsante **Formatta**. Il formattatore riorganizzerà gli array, pulirà gli spazi attorno a `=` e virgole, normalizzerà gli spazi delle tabelle e imporrà interruzioni di riga consistenti preservando i tuoi dati.

4

4. Rivedi, Copia o Salva

🔍 Confronta il TOML originale e formattato. Quando sei soddisfatto, copia il risultato nel tuo editor o salvalo come nuovo file `.toml` nel tuo progetto.

Specifiche Tecniche

Funzionalità TOML Supportate

Il formattatore è costruito per configurazioni di progetto reali e comprende costrutti TOML moderni.

FunzionalitàSupportoEsempi / Note
Tabelle e sottotabelle✅ Completo[tool.poetry], [project], [database.replica]
Array✅ CompletoArray inline e array di tabelle
Tabelle inline✅ Completoservers = { alpha = "10.0.0.1", beta = "10.0.0.2" }
Date e orari✅ Completo2025-09-23T10:20:30Z e formati di data locali
Commenti✅ Conservati# i commenti rimangono vicini alle impostazioni che descrivono
Stringhe multilinea✅ CompletoStringhe TOML tra triple virgolette per blocchi di testo lunghi

Opzioni di Formattazione (Mappate sui Controlli dello Strumento)

Queste opzioni sono esposte direttamente nell'interfaccia utente e collegate al plugin Prettier TOML sottostante:

OpzioneControllo UIIntervallo / ValoriPredefinito
Dimensione indentazioneCursore Dimensione Indentazione1–8 spazi2 spazi
Stile indentazioneSelezione Stile IndentazioneSpazi / TabulazioniSpazi
Lunghezza rigaA capo / Lunghezza Riga0–120 colonne (0 = effettivamente nessun a capo)80 colonne
Fine rigaFine riga (internamente)LF / CRLFLF nell'output del browser

Input e Limiti

Lo strumento è ottimizzato per file TOML piccoli e medi comunemente presenti nei repository delle applicazioni.

ParametroValore / ComportamentoNote
Estensioni file.tomlQualsiasi file di configurazione basato su TOML
Tipi MIMEapplication/toml, text/x-tomlUtilizzato per il rilevamento dei file nell'area di rilascio
Dimensione massima del file~5 MBFile più grandi potrebbero essere più lenti ed è meglio gestirli in CI
Numero massimo di caratteri≈ 2.000.000Limite rigido nel runtime del formattatore per evitare blocchi del browser

Validazione e Gestione degli Errori

Se il tuo file non è TOML valido (ad esempio, manca `=` o virgolette non corrispondenti), il formattatore restituirà tipicamente un errore leggibile invece dell'output formattato. Correggi la riga indicata ed esegui nuovamente il formattatore.

Alternative da Rig di Comando per la Formattazione TOML

Ti piace il risultato e vuoi lo stesso stile in CI o hook pre-commit? Ecco le opzioni compatibili con CLI:

Cross-platform (Node.js / Prettier)

Installa Prettier e il plugin TOML

npm install --save-dev prettier prettier-plugin-toml

Aggiunge Prettier e il parser TOML al tuo progetto.

Formatta un file TOML con Prettier

npx prettier --parser toml --write pyproject.toml

Riscrive `pyproject.toml` sul posto utilizzando le regole TOML di Prettier.

Linux / macOS / Windows (Taplo CLI)

Formatta TOML utilizzando Taplo

taplo fmt pyproject.toml

Un altro popolare formattatore CLI per file TOML.

Controlla la formattazione in CI

taplo fmt --check .

Fa fallire la build se i file TOML non sono formattati correttamente.

Usa questo strumento online per modifiche rapide e sperimentazioni, poi applica lo stesso stile con Prettier o Taplo nelle tue pipeline CI.

Casi d'Uso Comuni del Formattatore TOML

Packaging Python (`pyproject.toml`)

Mantieni i metadati del progetto Python e la configurazione degli strumenti puliti e facili da revisionare.

  • Allinea le sezioni `[project]`, `[tool.poetry]` e `[tool.black]`.
  • Normalizza gli array delle dipendenze e i selettori di versione.
  • Rendi le differenze di configurazione più facili da leggere nelle pull request.
[project]
name = "my-app"
version = "0.1.0"

[tool.black]
line-length = 88
include = "\.(py|pyi)$"

Progetti Rust (`Cargo.toml`)

Ripulisci i manifesti dei pacchetti Rust attraverso workspace e microservizi.

  • Mantieni `[dependencies]` e `[dev-dependencies]` ordinati e con spaziatura uniforme.
  • Normalizza le tabelle inline utilizzate per flag di funzionalità complesse.
  • Standardizza la formattazione tra più crate in un workspace.
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

Siti Statici & Strumenti (Hugo, Zola, ecc.)

Pulisci TOML utilizzato per generatori di siti statici e strumenti vari.

  • Formatta `config.toml` per Hugo o altri generatori di siti statici.
  • Mantieni i blocchi di configurazione multilingue leggibili.
  • Normalizza liste lunghe come voci di menu e tassonomie.

❓ Frequently Asked Questions

❓Cos'è un formattatore TOML?

Un formattatore TOML riorganizza automaticamente i tuoi file TOML in modo che seguano uno stile coerente: corregge l'indentazione, allinea array e tabelle inline, normalizza gli spazi attorno a `=` e virgole, e preserva i dati rendendoli più facili da leggere e revisionare.

📏Come dovrei scegliere dimensione e stile dell'indentazione?

Se il tuo team non ha preferenze, **2 spazi** è un buon default. Abbina lo stile già usato nel tuo repository: se i file sono principalmente indentati con spazi, continua a usarli; se i tab sono lo standard del team, imposta **Stile Indentazione** su Tab in modo che le nuove modifiche si allineino al codice esistente.

🧪Il formattatore valida la sintassi TOML?

Il parser sottostante rifiuterà TOML non valido (ad esempio, `=` mancante o virgolette non corrispondenti). In tal caso, lo strumento mostra un messaggio di errore invece dell'output formattato, così puoi correggere il problema e riprovare.

🔁L'esecuzione del formattatore può cambiare il comportamento della mia configurazione?

Il formattatore è progettato per essere **semanticamente conservativo**: cambia solo spazi bianchi e layout, non chiavi, valori o struttura delle tabelle. Finché il file originale è TOML valido, il significato della tua configurazione dovrebbe rimanere lo stesso.

🔒È sicuro formattare file di configurazione sensibili?

Come con qualsiasi strumento online, evita di incollare materiale estremamente sensibile come segreti di produzione. Per configurazioni altamente riservate, usa un formattatore TOML locale (come Prettier o Taplo) all'interno del tuo ambiente di sviluppo privato.

Pro Tips

Best Practice

Mantieni un `pyproject.toml` o `Cargo.toml` ben formattato nel tuo branch principale, poi applica lo stesso stile in CI usando Prettier o Taplo.

Best Practice

Formatta TOML prima di commitare grandi modifiche a dipendenze o configurazioni, così i tuoi diff Git si concentrano sui **cambiamenti effettivi**, non sul rumore degli spazi bianchi.

Best Practice

Quando rifattorizzi le configurazioni, formatta prima il file, committa, poi cambia i valori. Questo rende più facile revisionare cosa è realmente cambiato.

Best Practice

Usa la stessa **dimensione di indentazione** e **lunghezza di riga** in tutti i tuoi file TOML per rendere la navigazione tra progetti e le revisioni del codice coerenti.

Additional Resources

Specifica TOML v1.0.0
Documentation
Plugin Prettier TOML
Documentation
Taplo – Toolkit TOML
Documentation

Other Tools