JSON naar TOML Converter

Wat is TOML en waarom omzetten vanuit 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"

Belangrijkste functies

Voorbeelden

{
  "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 }
  }
}

Hoe te gebruiken

1. 1

   Plak je JSON

   Voer je JSON in of plak het in het invoerveld hierboven. Je kunt ook op 'Voorbeeld laden' klikken om een Cargo.toml-bron, pyproject.toml-bron of object met app-instellingen te proberen.

2. 2

   Bekijk live TOML-uitvoer

   TOML verschijnt direct in het uitvoerpaneel. Als je JSON een array op het hoogste niveau of null-waarden heeft, legt de tool precies uit wat je moet doen in plaats van gebroken uitvoer te produceren.

3. 3

   Kopiëren of downloaden

   Klik op Kopiëren om de TOML naar je klembord te halen, of op Downloaden om het als .toml-bestand op te slaan, klaar voor Cargo, Poetry, Hugo, Netlify of elke tool die TOML leest.

Veelvoorkomende JSON-naar-TOML-valkuilen

[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] }

Veelvoorkomende toepassingen

Cargo.toml genereren

Verander gestructureerde JSON — van een scaffolding-tool, een API of een script — in een geldige Rust Cargo.toml, met automatisch geproduceerde geneste [dependencies]-tabellen en inline-tabellen.

pyproject.toml genereren

Zet JSON-projectmetadata om naar een PEP 621 pyproject.toml, inclusief [tool.*]-tabellen met puntnotatie, zodat tooling die JSON uitgeeft Python-packaging-configuratie kan produceren.

Door mensen bewerkbare config uit JSON

Transformeer de JSON-instellingen van een applicatie in een leesbaar TOML-configuratiebestand dat mensen comfortabel kunnen bewerken, met naderhand met de hand toegevoegd commentaar.

Deployment-config genereren

Produceer netlify.toml, foundry.toml of vergelijkbare platformconfiguraties uit JSON, en verander geneste objecten en arrays van objecten in de tabellen en arrays van tabellen die die tools verwachten.

Migratie van configuratieformaat

Verplaats configuratie van een JSON-gebaseerd systeem naar een TOML-gebaseerd systeem, met deze converter als brug en de null- en hoogste-niveau-waarschuwingen om alles op te vangen wat niet zal mappen.

TOML-structuur prototypen

Schets een config als JSON — een formaat dat de meeste ontwikkelaars vloeiend typen — en zet het vervolgens om naar TOML om de idiomatische opmaak van tabellen en arrays van tabellen te zien voordat je het in een repo vastlegt.

Technische details

RFC 8259 JSON-parsing

JSON-invoer wordt geparseerd met de native JSON.parse() van de browser, die volledig RFC 8259-conform is. Vóór de serialisatie controleert de tool dat de waarde op het hoogste niveau een object is en scant op null-waarden om te waarschuwen voor verwijderde objectsleutels of een null binnen een array met een precies pad af te wijzen.

TOML 1.0.0-uitvoer via smol-toml

TOML wordt gegenereerd met de smol-toml-bibliotheek, een dependency-vrije, volledig TOML 1.0.0-conforme serializer. Geneste objecten worden tabellen, diep geneste objecten worden tabellen met puntnotatie, en arrays van objecten worden arrays van tabellen. Floats met een fractioneel deel van nul worden volgens de TOML-regels als gehele getallen geschreven, met een waarschuwing.

100% browsergebaseerd — geen upload, geen server

Alle verwerking gebeurt in de JavaScript-engine van je browser. Er worden op geen enkel moment gegevens verzonden. Invoer groter dan 200 KB schakelt over van live naar handmatige modus (een expliciete klik op Converteren) om de interface responsief te houden.

Best practices

Wikkel arrays op het hoogste niveau onder een sleutel

Als je gegevens van nature een JSON-array zijn, wikkel ze dan in een object met een beschrijvende sleutel ({ "items": [...] }) vóór het converteren. TOML-documenten moeten aan de basis een tabel zijn, en de sleutel geeft je array een duidelijke naam in de uitvoer.

Beslis wat nulls moeten betekenen

Beslis vóór het converteren of een null-veld moet verdwijnen (de sleutel verwijderen) of een waarde moet dragen. TOML verwijdert object-nulls en wijst array-nulls af, dus ze eerst in je JSON oplossen geeft voorspelbare, complete uitvoer.

Gebruik geneste objecten voor groepering

Groepeer gerelateerde instellingen in geneste objecten in je JSON — ze worden schone [tables] en tabellen met puntnotatie in TOML, wat veel leesbaarder is dan een platte lijst met sleutels, passend bij hoe Cargo- en pyproject-configuraties zijn georganiseerd.

Valideer eerst je JSON

Als je JSON handgeschreven is of uit een onbetrouwbare bron komt, valideer het dan met onze JSON Formatter om afsluitende komma's en aanhalingsfouten op te vangen voordat je naar TOML converteert.

Voeg commentaar toe na het converteren

JSON heeft geen commentaar, dus niets gaat over. Aangezien TOML #-commentaar ondersteunt, voeg je documentatie met de hand toe aan de gegenereerde TOML — een van de belangrijkste redenen om door mensen bewerkte configuratie in de eerste plaats naar TOML te verplaatsen.

Veelgestelde vragen