Loading…

Sobre Formatador TOML Online

Configurações de `pyproject.toml`, `Cargo.toml` ou `poetry` bagunçadas? Cole seu TOML ou solte um arquivo e nosso formatador normalizará espaços em branco, organizará arrays e tabelas inline, e manterá suas seções consistentemente espaçadas. Ideal para Python, Rust, Go, geradores de sites estáticos e qualquer projeto que use TOML para configuração.

Principais Características do Formatador TOML

  • **Embelezador de um clique** para arquivos e trechos de configuração TOML
  • **Tamanho de indentação configurável** de 1 a 8 espaços através do controle deslizante *Tamanho da Indentação*
  • **Alternância de estilo de indentação** – escolha entre espaços ou tabulações para indentação
  • **Controle de quebra / comprimento de linha** para manter arrays longos e tabelas inline dentro de uma largura de coluna escolhida
  • Suporta arquivos `.toml` como `pyproject.toml`, `Cargo.toml`, `Pipfile.toml`, `poetry.toml` e mais
  • Analisador TOML baseado no Prettier que compreende datas, arrays, tabelas aninhadas e tabelas inline
  • Formatação estável e idempotente – executá-la novamente no mesmo arquivo não causará desvio de formatação
  • Cópia com um clique da saída formatada, pronta para seu editor ou commit

🛠️ Como Formatador Arquivos TOML Online for toml-formatter

1

1. Cole ou Carregue Seu TOML

📥 Cole TOML no editor ou arraste e solte um arquivo `.toml` como `pyproject.toml` ou `Cargo.toml`. A ferramenta analisa o conteúdo como TOML, não como INI/JSON genérico.

2

2. Escolha Indentação e Configurações de Quebra

⚙️ Use o controle deslizante **Tamanho da Indentação** para escolher quantos espaços por nível de indentação e alterne o **Estilo de Indentação** para tabulações se seu projeto as preferir. Ajuste **Quebra / Comprimento da Linha** para controlar quando arrays longos ou tabelas inline devem quebrar (ou defina como `0` para efetivamente desativar a quebra).

3

3. Clique em “Formatar”

🚀 Pressione o botão **Formatar**. O formatador reorganizará arrays, limpará espaçamento ao redor de `=` e vírgulas, normalizará o espaçamento de tabelas e aplicará quebras de linha consistentes, preservando seus dados.

4

4. Revise, Copie ou Salve

🔍 Compare o TOML original e o formatado. Quando estiver satisfeito, copie o resultado de volta para seu editor ou salve-o como um novo arquivo `.toml` em seu projeto.

Especificações Técnicas

Recursos TOML Suportados

O formatador é construído para configurações de projetos do mundo real e compreende construções TOML modernas.

RecursoSuporteExemplos / Notas
Tabelas e subtabelas✅ Completo[tool.poetry], [project], [database.replica]
Arrays✅ CompletoArrays inline e arrays de tabelas
Tabelas inline✅ Completoservers = { alpha = "10.0.0.1", beta = "10.0.0.2" }
Datas e horários✅ Completo2025-09-23T10:20:30Z e formatos de data local
Comentários✅ Preservados# comentários permanecem próximos às configurações que descrevem
Strings multilinha✅ CompletoStrings TOML entre aspas triplas para blocos de texto longos

Opções de Formatação (Mapeadas para Controles da Ferramenta)

Estas opções são expostas diretamente na interface e conectadas ao plugin Prettier TOML subjacente:

OpçãoControle da InterfaceIntervalo / ValoresPadrão
Tamanho do recuoControle deslizante de Tamanho do Recuo1–8 espaços2 espaços
Estilo do recuoSeleção de Estilo do RecuoEspaços / TabsEspaços
Comprimento da linhaQuebra / Comprimento da Linha0–120 colunas (0 = efetivamente sem quebra)80 colunas
Final de linhaFinal de linha (internamente)LF / CRLFLF na saída do navegador

Entrada e Limites

A ferramenta é otimizada para arquivos TOML pequenos a médios comumente encontrados em repositórios de aplicações.

ParâmetroValor / ComportamentoNotas
Extensões de arquivo.tomlQualquer arquivo de configuração baseado em TOML
Tipos MIMEapplication/toml, text/x-tomlUsado para detecção de arquivos na zona de soltar
Tamanho máximo do arquivo~5 MBArquivos maiores podem ser mais lentos e são melhor tratados em CI
Máximo de caracteres≈ 2.000.000Limite rígido no tempo de execução do formatador para evitar travamentos do navegador

Validação e Tratamento de Erros

Se o seu arquivo não for TOML válido (por exemplo, falta `=` ou aspas não correspondentes), o formatador normalmente retornará um erro legível em vez de uma saída formatada. Corrija a linha indicada e execute o formatador novamente.

Alternativas de Linha de Comando para Formatação TOML

Gostou do resultado e quer o mesmo estilo em CI ou ganchos de pré-commit? Aqui estão opções amigáveis à CLI:

Multiplataforma (Node.js / Prettier)

Instalar Prettier e o plugin TOML

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

Adiciona Prettier e o analisador TOML ao seu projeto.

Formatar um arquivo TOML com Prettier

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

Reescreve `pyproject.toml` no local usando as regras TOML do Prettier.

Linux / macOS / Windows (Taplo CLI)

Formatar TOML usando Taplo

taplo fmt pyproject.toml

Outro formatador CLI popular para arquivos TOML.

Verificar formatação em CI

taplo fmt --check .

Falha a compilação se os arquivos TOML não estiverem devidamente formatados.

Use esta ferramenta online para edições rápidas e experimentos, depois imponha o mesmo estilo com Prettier ou Taplo em seus pipelines de CI.

Casos de Uso Comuns do Formatador TOML

Empacotamento Python (`pyproject.toml`)

Mantenha os metadados do projeto Python e a configuração de ferramentas limpos e fáceis de revisar.

  • Alinhe as seções `[project]`, `[tool.poetry]` e `[tool.black]`.
  • Normalize arrays de dependência e especificadores de versão.
  • Torne os diffs de configuração mais fáceis de ler em pull requests.
[project]
name = "my-app"
version = "0.1.0"

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

Projetos Rust (`Cargo.toml`)

Organize manifestos de pacotes Rust em workspaces e microsserviços.

  • Mantenha `[dependencies]` e `[dev-dependencies]` ordenados e com espaçamento consistente.
  • Normalize tabelas inline usadas para flags de recurso complexos.
  • Padronize a formatação em múltiplas crates em um workspace.
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

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

Sites Estáticos & Ferramentas (Hugo, Zola, etc.)

Limpe TOML usado para geradores de sites estáticos e ferramentas diversas.

  • Formate `config.toml` para Hugo ou outros geradores de sites estáticos.
  • Mantenha blocos de configuração multilíngue legíveis.
  • Normalize listas longas como entradas de menu e taxonomias.

❓ Frequently Asked Questions

❓O que é um formatador TOML?

Um formatador TOML reestrutura automaticamente seus arquivos TOML para que sigam um estilo consistente: corrige indentação, alinha arrays e tabelas inline, normaliza espaços ao redor de `=` e vírgulas, e preserva os dados enquanto os torna mais fáceis de ler e revisar.

📏Como devo escolher o tamanho e estilo de indentação?

Se sua equipe não tem preferência, **2 espaços** é um bom padrão. Combine com o estilo já usado no seu repositório: se os arquivos são principalmente indentados com espaços, continue usando espaços; se tabs são o padrão da equipe, mude o **Estilo de Indentação** para Tabs para que novas alterações se alinhem com o código existente.

🧪O formatador valida a sintaxe TOML?

O parser subjacente rejeitará TOML inválido (por exemplo, `=` ausente ou aspas inconsistentes). Nesse caso, a ferramenta mostra uma mensagem de erro em vez da saída formatada, para que você possa corrigir o problema e tentar novamente.

🔁Executar o formatador pode alterar o comportamento da minha configuração?

O formatador é projetado para ser **preservador de semântica**: ele apenas altera espaços em branco e layout, não chaves, valores ou estrutura de tabela. Desde que o arquivo original seja TOML válido, o significado da sua configuração deve permanecer o mesmo.

🔒É seguro formatar arquivos de configuração sensíveis?

Como com qualquer ferramenta online, evite colar material extremamente sensível como segredos de produção. Para configurações altamente confidenciais, use um formatador TOML local (como Prettier ou Taplo) dentro do seu ambiente de desenvolvimento privado.

Pro Tips

Best Practice

Mantenha um `pyproject.toml` ou `Cargo.toml` bem formatado no seu branch principal, então imponha o mesmo estilo no CI usando Prettier ou Taplo.

Best Practice

Formate TOML antes de commitar grandes mudanças de dependência ou configuração para que seus diffs Git foquem em **mudanças reais**, não em ruído de espaços em branco.

Best Practice

Ao refatorar configurações, formate o arquivo primeiro, commite, então altere os valores. Isso facilita revisar o que realmente mudou.

Best Practice

Use o mesmo **tamanho de indentação** e **comprimento de quebra** em todos os seus arquivos TOML para tornar a navegação entre projetos e as revisões de código consistentes.

Additional Resources

Especificação TOML v1.0.0
Documentation
Plugin Prettier TOML
Documentation
Taplo – Kit de Ferramentas TOML
Documentation

Other Tools