Conversor TOML para JSON

O Que É a Conversão de TOML para JSON?

TOML (Tom's Obvious Minimal Language) é um formato de arquivo de configuração projetado para ser lido por humanos. Ele mapeia de forma não ambígua para uma tabela hash, suporta tabelas aninhadas, valores tipados e comentários inline. Muitas ferramentas e frameworks usam TOML como formato de configuração principal: projetos Rust utilizam o Cargo.toml, o empacotamento Python usa o pyproject.toml, e sites estáticos Hugo são configurados via config.toml. Converter TOML para JSON online permite transformar esses arquivos de configuração em um formato que praticamente toda linguagem de programação, API e pipeline de dados consegue consumir nativamente.

JSON (JavaScript Object Notation), definido pela RFC 8259, é o formato de intercâmbio de dados mais amplamente suportado. Enquanto o TOML prioriza a legibilidade humana com sua sintaxe mínima e suporte a comentários, o JSON prioriza a interoperabilidade entre sistemas. Um conversor de TOML para JSON preenche essa lacuna analisando a entrada TOML conforme a especificação TOML v1.0.0 e emitindo um documento JSON estruturalmente equivalente. A conversão preserva todos os dados: strings, inteiros, floats, booleanos, arrays e tabelas mapeiam diretamente para seus equivalentes em JSON.

O TOML possui quatro tipos nativos de data/hora que o JSON não consegue representar diretamente: datetime com fuso horário, datetime local, data local e hora local. O JSON não possui tipo de data, portanto esses valores são serializados como strings ISO 8601 durante a conversão.

Por Que Usar um Conversor de TOML para JSON?

Arquivos de configuração escritos em TOML frequentemente precisam alimentar sistemas que só aceitam JSON. Em vez de reescrever o arquivo manualmente ou instalar uma biblioteca de parser localmente, um conversor no navegador realiza a transformação em segundos.

Casos de Uso do Conversor TOML para JSON

Referência de Mapeamento de Tipos TOML para JSON

Cada tipo TOML possui um equivalente direto em JSON, com uma exceção: valores de data e hora. A tabela abaixo mostra como cada tipo TOML é convertido para JSON. Esse mapeamento segue a especificação TOML v1.0.0 e corresponde ao comportamento de parsers padrão como tomllib (Python), toml-rs (Rust) e @iarna/toml (Node.js).

Inteiros TOML suportam underscores para legibilidade (por exemplo, 1_000_000) e literais hexadecimais (0xDEADBEEF), octais (0o755) e binários (0b11010110). Todos eles são convertidos para números decimais simples em JSON. O TOML também suporta valores float infinity e NaN, mas estes não possuem representação em JSON e causarão um erro de conversão no modo estrito.

Exemplos de Código

Exemplos práticos de conversão de TOML para JSON em quatro linguagens. Cada um lê um arquivo TOML, faz o parsing e gera JSON formatado.

import { parse } from '@iarna/toml'
import fs from 'fs'

const toml = fs.readFileSync('config.toml', 'utf8')
const json = parse(toml)
console.log(JSON.stringify(json, null, 2))
// Input:  [server]
//         host = "localhost"
//         port = 8080
// Output: { "server": { "host": "localhost", "port": 8080 } }

import tomllib   # Python 3.11+ (standard library)
import json

with open('config.toml', 'rb') as f:
    data = tomllib.load(f)

print(json.dumps(data, indent=2, default=str))
# Dates become strings: "1979-05-27"
# Arrays of tables become JSON arrays of objects

package main

import (
    "encoding/json"
    "fmt"
    "os"

    "github.com/BurntSushi/toml"
)

func main() {
    var data map[string]any
    _, err := toml.DecodeFile("config.toml", &data)
    if err != nil {
        panic(err)
    }
    out, _ := json.MarshalIndent(data, "", "  ")
    fmt.Println(string(out))
}

# Using yj (YAML/JSON/TOML converter)
cat config.toml | yj -tj

# Using dasel
dasel -f config.toml -r toml -w json

# Using Python one-liner (3.11+)
python3 -c "import tomllib, json, sys; print(json.dumps(tomllib.load(sys.stdin.buffer), indent=2, default=str))" < config.toml

Perguntas Frequentes