Conversor JSON para TOML

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

A conversão de JSON para TOML transforma dados do formato JavaScript Object Notation para o Tom's Obvious Minimal Language. JSON utiliza chaves, colchetes e chaves entre aspas para representar dados estruturados. TOML usa uma sintaxe simples de chave-valor com cabeçalhos de seção (chamados tabelas) que lembra um arquivo INI, mas com tipagem estrita. O TOML foi desenvolvido especificamente para arquivos de configuração onde a legibilidade humana é mais importante do que a troca entre sistemas.

O TOML tornou-se o formato de configuração padrão para Rust (Cargo.toml), empacotamento Python (pyproject.toml), sites estáticos Hugo, configurações de implantação Netlify e diversas ferramentas de linha de comando. Quando seus dados existem em JSON — de uma resposta de API, uma configuração exportada ou um arquivo gerado — e seu sistema de destino espera TOML, você precisa de um conversor que mapeie objetos JSON para tabelas TOML, arrays JSON para arrays TOML e preserve cada tipo de dado com precisão.

Converter JSON para TOML online é a forma mais rápida de gerar TOML válido a partir de dados JSON existentes. A conversão trata o mapeamento de tipos automaticamente: strings JSON tornam-se strings TOML, números JSON tornam-se inteiros ou floats TOML, booleanos JSON mapeiam diretamente, e objetos JSON tornam-se tabelas TOML. A única exceção é null — TOML não possui tipo null, portanto valores nulos são omitidos ou convertidos para strings vazias dependendo do conversor.

Por Que Usar Este Conversor JSON para TOML?

TOML é o que os arquivos de configuração esperam; JSON é o que APIs e ferramentas produzem. Este conversor preenche essa lacuna para que você possa mover dados entre os dois formatos sem reescrita manual.

Casos de Uso de JSON para TOML

Comparação JSON vs TOML

JSON e TOML se sobrepõem em capacidade, mas diferem em sintaxe, suporte a tipos e uso pretendido. Esta tabela mostra as diferenças que afetam a conversão.

Armadilhas na Conversão para TOML

TOML possui regras que diferem do JSON de maneiras que afetam a saída da conversão. Esses quatro problemas causam a maior confusão.

Exemplos de Código

Converter JSON para TOML programaticamente requer uma biblioteca de serialização TOML na maioria das linguagens. Bibliotecas padrão fazem o parsing de JSON; a saída TOML precisa de um pacote dedicado.

import { stringify } from '@iarna/toml'

const json = '{"title":"My App","database":{"host":"localhost","port":5432}}'
const obj = JSON.parse(json)
const toml = stringify(obj)
console.log(toml)
// → title = "My App"
// →
// → [database]
// → host = "localhost"
// → port = 5432

import json
import tomli_w  # pip install tomli_w

json_str = '{"title": "My App", "database": {"host": "localhost", "port": 5432}}'
data = json.loads(json_str)
toml_str = tomli_w.dumps(data)
print(toml_str)
# → title = "My App"
# →
# → [database]
# → host = "localhost"
# → port = 5432

package main

import (
    "encoding/json"
    "fmt"
    "github.com/pelletier/go-toml/v2"
)

func main() {
    jsonStr := `{"title":"My App","database":{"host":"localhost","port":5432}}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    tomlBytes, _ := toml.Marshal(data)
    fmt.Println(string(tomlBytes))
    // → title = 'My App'
    // →
    // → [database]
    // → host = 'localhost'
    // → port = 5432
}

# Using yj (https://github.com/sclevine/yj)
echo '{"title":"My App","port":3000}' | yj -jt
# → title = "My App"
# → port = 3000

# Using remarshal (pip install remarshal)
echo '{"title":"My App","port":3000}' | remarshal -if json -of toml
# → title = "My App"
# → port = 3000

Perguntas Frequentes