Conversor de JSON para TOML

O que é TOML e porquê converter a partir de JSON?

// Convert JSON to TOML in Node.js using the smol-toml library
import { stringify } from 'smol-toml';

const data = JSON.parse(`{
  "package": { "name": "my-app", "version": "1.0.0" },
  "dependencies": { "serde": { "version": "1.0" } }
}`);

// The top-level value must be an object; null values on objects are dropped.
const toml = stringify(data);

console.log(toml);
// [package]
// name = "my-app"
// version = "1.0.0"
//
// [dependencies.serde]
// version = "1.0"

Funcionalidades principais

Exemplos

{
  "package": {
    "name": "my-app",
    "version": "1.0.0",
    "edition": "2021"
  },
  "dependencies": {
    "serde": { "version": "1.0", "features": ["derive"] },
    "tokio": { "version": "1", "features": ["full"] }
  }
}

{
  "build-system": {
    "requires": ["hatchling"],
    "build-backend": "hatchling.build"
  },
  "project": {
    "name": "my-package",
    "version": "0.3.1",
    "requires-python": ">=3.10",
    "dependencies": ["requests>=2.31", "pydantic>=2.0"]
  }
}

{
  "title": "My Service",
  "debug": false,
  "port": 8080,
  "database": {
    "host": "localhost",
    "port": 5432,
    "pool_size": 10
  },
  "features": ["auth", "metrics", "tracing"]
}

{
  "servers": [
    { "name": "alpha", "ip": "10.0.0.1", "ports": [8001, 8002] },
    { "name": "beta", "ip": "10.0.0.2", "ports": [9001] }
  ]
}

{
  "build": {
    "command": "npm run build",
    "publish": "dist",
    "environment": { "NODE_VERSION": "20" }
  },
  "redirects": [
    { "from": "/old", "to": "/new", "status": 301, "force": true }
  ]
}

{
  "tool": {
    "ruff": { "line-length": 100, "target-version": "py310" },
    "black": { "line-length": 100 }
  }
}

Como usar

1. 1

   Cole o seu JSON

   Introduza ou cole o seu JSON no campo de entrada acima. Também pode clicar em 'Carregar exemplo' para experimentar uma fonte Cargo.toml, uma fonte pyproject.toml ou um objeto de definições de app.

2. 2

   Veja a saída TOML ao vivo

   O TOML aparece instantaneamente no painel de saída. Se o seu JSON tiver um array de nível superior ou valores null, a ferramenta explica exatamente o que fazer em vez de produzir uma saída quebrada.

3. 3

   Copie ou Baixe

   Clique em Copiar para levar o TOML para a área de transferência, ou em Baixar para o guardar como ficheiro .toml pronto para o Cargo, Poetry, Hugo, Netlify ou qualquer ferramenta que leia TOML.

Armadilhas comuns de JSON para TOML

[1, 2, 3]

{ "items": [1, 2, 3] }

{ "name": "a", "nickname": null }

{ "name": "a", "nickname": "" }

{ "ports": [8001, null, 8003] }

{ "ports": [8001, 8003] }

{ 'name': 'a', 'active': true, }

{ "name": "a", "active": true }

{ "ratio": 1.0 }  →  ratio = 1

{ "ratio": 1.5 }  →  ratio = 1.5

{ "server": { "a": 1 }, "server": [1] }

{ "server": { "a": 1 }, "servers": [1] }

Casos de uso comuns

Gerar Cargo.toml

Transforme JSON estruturado — de uma ferramenta de scaffolding, de uma API ou de um script — num Cargo.toml do Rust válido, com tabelas [dependencies] aninhadas e tabelas inline produzidas automaticamente.

Gerar pyproject.toml

Converta metadados de projeto em JSON num pyproject.toml no formato PEP 621, incluindo tabelas pontilhadas [tool.*], para que ferramentas que emitem JSON possam produzir configuração de packaging Python.

Config editável por humanos a partir de JSON

Transforme as definições JSON de uma aplicação num ficheiro de configuração TOML legível que os humanos possam editar confortavelmente, com comentários adicionados depois à mão.

Geração de config de deployment

Produza netlify.toml, foundry.toml ou configurações de plataforma semelhantes a partir de JSON, transformando objetos aninhados e arrays de objetos nas tabelas e arrays de tabelas que essas ferramentas esperam.

Migração de formato de configuração

Mova configuração de um sistema baseado em JSON para um baseado em TOML, usando este conversor como ponte e os avisos de null e de nível superior para apanhar tudo o que não mapear.

Prototipagem de estrutura TOML

Esboce uma configuração como JSON — um formato que a maioria dos programadores digita com fluência — e depois converta para TOML para ver o layout idiomático de tabelas e arrays de tabelas antes de a colocar num repositório.

Detalhes técnicos

Análise de JSON RFC 8259

A entrada JSON é analisada com o JSON.parse() nativo do navegador, que é totalmente compatível com o RFC 8259. Antes da serialização, a ferramenta verifica que o valor de nível superior é um objeto e procura valores null para poder avisar sobre chaves de objeto descartadas ou rejeitar um null dentro de um array com um caminho preciso.

Saída TOML 1.0.0 via smol-toml

O TOML é gerado com a biblioteca smol-toml, um serializador sem dependências e totalmente compatível com TOML 1.0.0. Os objetos aninhados tornam-se tabelas, os objetos profundamente aninhados tornam-se tabelas pontilhadas e os arrays de objetos tornam-se arrays de tabelas. Os floats com parte fracionária zero são escritos como inteiros conforme as regras do TOML, com um aviso.

100% no navegador — Sem carregamento, sem servidor

Todo o processamento acontece no motor JavaScript do seu navegador. Nenhum dado é transmitido em momento algum. As entradas maiores que 200KB mudam do modo ao vivo para o manual (um clique explícito em Converter) para manter a interface responsiva.

Boas práticas

Envolva arrays de nível superior sob uma chave

Se os seus dados forem naturalmente um array JSON, envolva-os num objeto com uma chave descritiva ({ "items": [...] }) antes de converter. Os documentos TOML têm de ser uma tabela na raiz, e a chave dá ao seu array um nome claro na saída.

Decida o que os nulls devem significar

Antes de converter, decida se um campo null deve desaparecer (descartar a chave) ou levar um valor. O TOML descarta os nulls de objeto e rejeita os nulls de array, por isso resolvê-los primeiro no seu JSON dá uma saída previsível e completa.

Use objetos aninhados para agrupar

Agrupe definições relacionadas em objetos aninhados no seu JSON — tornam-se [tabelas] e tabelas pontilhadas limpas em TOML, o que é muito mais legível do que uma lista plana de chaves, correspondendo à forma como as configs do Cargo e do pyproject estão organizadas.

Valide o seu JSON primeiro

Se o seu JSON for escrito à mão ou vier de uma fonte pouco fiável, valide-o com o nosso Formatador JSON para apanhar vírgulas finais e erros de aspas antes de converter para TOML.

Adicione comentários depois de converter

O JSON não tem comentários, por isso nenhum é transposto. Como o TOML suporta comentários #, adicione documentação ao TOML gerado à mão — uma das principais razões para mover a config editada por humanos para TOML, desde logo.

Perguntas frequentes