O que é o formato TOML?

TOML (Tom's Obvious, Minimal Language) é um formato de arquivo de configuração projetado para ser fácil de ler e escrever devido à sua semântica óbvia. Criado por Tom Preston‑Werner (co‑fundador do GitHub), o TOML mapeia de forma inequívoca para uma tabela hash e é comumente usado em arquivos de configuração em projetos Rust (Cargo.toml), ferramentas Python e muitas outras aplicações. Ele utiliza uma sintaxe clara e mínima, com seções denotadas por colchetes e pares chave‑valor semelhantes a arquivos INI, porém com tipos de dados mais ricos, incluindo arrays, tabelas aninhadas, datas e tratamento adequado de tipos.

Descrição da Ferramenta

Este conversor transforma dados entre os formatos TOML e TOON de forma bidirecional. Converta arquivos de configuração TOML para o formato TOON eficiente em tokens para processamento por LLMs, ou transforme dados TOON de volta para o TOML padrão. A ferramenta usa as bibliotecas oficiais @toon-format/toon e smol-toml para garantir conversões precisas. Isso é particularmente útil ao trabalhar com LLMs em tarefas de gerenciamento de configuração, cenários de infraestrutura‑como‑código ou qualquer situação em que seja necessário processar dados TOML de forma eficiente dentro de restrições de tokens.

Exemplos

Entrada TOML:

[database]
server = "192.168.1.1"
ports = [8000, 8001, 8002]
enabled = true

[[servers]]
name = "alpha"
ip = "10.0.0.1"
role = "frontend"

[[servers]]
name = "beta"
ip = "10.0.0.2"
role = "backend"

Saída TOON:

database:
  server: 192.168.1.1
  ports: [8000,8001,8002]
  enabled: true
servers[2]{name,ip,role}:
  alpha,10.0.0.1,frontend
  beta,10.0.0.2,backend

Exemplo de Arquivo de Configuração:

Configuração TOML com estruturas aninhadas:

[app]
name = "MyApp"
version = "1.0.0"

[app.settings]
debug = false
timeout = 30

[[app.features]]
id = 1
name = "feature-a"
enabled = true

[[app.features]]
id = 2
name = "feature-b"
enabled = false

Torna-se TOON compacto:

app:
  name: MyApp
  version: 1.0.0
  settings:
    debug: false
    timeout: 30
  features[2]{id,name,enabled}:
    1,feature-a,true
    2,feature-b,false

Recursos

  • Conversão bidirecional entre os formatos TOML e TOON com fidelidade total
  • Redução de tokens para processamento por LLMs (30‑50% menos tokens para configurações estruturadas)
  • Preserva a semântica do TOML incluindo tabelas, arrays de tabelas e estruturas aninhadas
  • Conversão segura de tipos mantendo inteiros, floats, booleanos, strings e arrays
  • Conversão em tempo real com resultados instantâneos enquanto você digita

Casos de Uso

  1. Análise de Configuração com LLMs – Converta arquivos de configuração TOML para o formato TOON antes de enviá‑los aos LLMs para análise, sugestões ou geração de documentação com custos de token reduzidos
  2. Processamento de Infraestrutura como Código – Transforme configurações baseadas em TOML, como Terraform, Cargo, ou outras, para revisões e modificações de infraestrutura eficientes baseadas em LLMs
  3. Gerenciamento de Configurações CI/CD – Processar arquivos de configuração de build através de LLMs para otimização ou migração, minimizando custos de API
  4. Migração de Configurações – Converta as configurações de aplicativos entre formatos ao integrar com ferramentas de gerenciamento de configuração alimentadas por LLMs
  5. Geração de Documentação – Prepare configurações TOML para geradores de documentação baseados em LLM usando codificação eficiente em tokens

Detalhes da Conversão

O conversor lida adequadamente com recursos específicos do TOML:

  • Tabelas ([section]) são convertidas em objetos aninhados no TOON com indentação
  • Arrays de tabelas ([[array]]) são convertidos para o formato tabular do TOON quando uniformes
  • Tabelas inline ({key = value}) preservam a estrutura por meio de aninhamento adequado
  • Tipos de dados (strings, inteiros, floats, booleanos, datas) mantêm a segurança de tipos
  • Arrays são convertidos para a notação de array do TOON com formatação adequada
  • Chaves pontuadas (a.b.c = value) são expandidas para estrutura aninhada

Eficiência de Tokens

Converter TOML para TOON antes do processamento por LLMs oferece economias significativas:

Exemplo de Comparação de Tokens (50 configurações de servidor):

  • TOML (formatado): ≈ 12.500 tokens
  • TOON: ≈ 7.200 tokens (redução de 42%)
  • Benefício do TOON: Mais dados dentro da janela de contexto, custos de API menores

A economia é mais pronunciada com:

  • Estruturas de tabela repetidas (como [[servers]], [[databases]])
  • Arrays de objetos de configuração semelhantes
  • Arquivos de configuração grandes com seções uniformes
  • Configurações multi‑ambiente com estrutura semelhante

Compatibilidade de Formato

Recursos do TOML Suportados:

  • Pares chave‑valor básicos
  • Tabelas e tabelas aninhadas
  • Arrays de tabelas
  • Tabelas inline e arrays
  • Todos os tipos de dados do TOML (string, integer, float, boolean, datetime, array, table)
  • Comentários (preservados na estrutura, embora não na representação TOON)

Fidelidade de Ida e Volta:
A conversão TOML → TOON → TOML mantém a integridade dos dados, embora a formatação e os comentários possam ser normalizados. O significado semântico e todos os valores são preservados.

Quando Usar Este Conversor

Use TOML → TOON quando:

  • Enviar arquivos de configuração para LLMs para análise ou modificação
  • Processar grandes configurações TOML dentro dos limites de tokens
  • Processamento em lote de múltiplos arquivos de configuração através de APIs de LLM
  • Gerar documentação a partir de configurações TOML

Use TOON → TOML quando:

  • Converter configurações geradas por LLM de volta ao formato padrão
  • Integrar a saída de LLM em cadeias de ferramentas baseadas em TOML
  • Criar arquivos de configuração editáveis por humanos a partir de dados compactos
  • Preparar saída para aplicações nativas em TOML