JSON to TOML

Vad är JSON till TOML-konvertering?

JSON till TOML-konvertering omvandlar data från JavaScript Object Notation till Tom's Obvious Minimal Language. JSON använder klammerparenteser, hakparenteser och citerade nycklar för att representera strukturerad data. TOML använder en platt nyckel-värde-syntax med sektionsrubriker (kallade tabeller) som läses som en INI-fil men med strikt typning. TOML designades specifikt för konfigurationsfiler där läsbarhet för människor är viktigare än maskinkommunikation.

TOML har blivit standardkonfigurationsformat för Rust (Cargo.toml), Python-paketering (pyproject.toml), Hugo-statiska webbplatser, Netlify-distributionsinställningar och många CLI-verktyg. När dina källdata finns som JSON — från ett API-svar, en exporterad konfiguration eller en genererad fil — och målsystemet förväntar sig TOML behöver du en konverterare som mappar JSON-objekt till TOML-tabeller, JSON-arrayer till TOML-arrayer och bevarar varje datatyp korrekt.

Att konvertera JSON till TOML online är det snabbaste sättet att generera giltig TOML från befintlig JSON-data. Konverteringen hanterar typmappning automatiskt: JSON-strängar blir TOML-strängar, JSON-tal blir TOML-heltal eller flyttal, JSON-booleska värden mappas direkt, och JSON-objekt blir TOML-tabeller. Det enda undantaget är null — TOML har ingen null-typ, så null-värden utelämnas eller konverteras till tomma strängar beroende på konverteraren.

Varför använda den här JSON till TOML-konverteraren?

TOML är vad konfigurationsfiler förväntar sig; JSON är vad API:er och verktyg producerar. Den här konverteraren överbryggar gapet så att du kan flytta data mellan de två formaten utan manuell omskrivning.

Användningsfall för JSON till TOML

Jämförelse: JSON vs TOML

JSON och TOML överlappar i förmåga men skiljer sig i syntax, typstöd och avsedd användning. Den här tabellen visar skillnaderna som påverkar konverteringen.

Fallgropar vid TOML-konvertering

TOML har regler som skiljer sig från JSON på sätt som påverkar konverteringsutdata. Dessa fyra problem orsakar mest förvirring.

Kodexempel

Att konvertera JSON till TOML programmatiskt kräver ett TOML-serialiseringsbibliotek i de flesta språk. Standardbibliotek tolkar JSON; TOML-utdata behöver ett dedikerat paket.

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

Vanliga frågor