TOML to JSON

Vad är TOML till JSON-konvertering?

TOML (Tom's Obvious Minimal Language) är ett konfigurationsfilformat utformat för människor. Det mappas entydigt till en hashtabell, stöder nästlade tabeller, typade värden och inline-kommentarer. Många verktyg och ramverk använder TOML som sitt primära konfigurationsformat: Rust-projekt förlitar sig på Cargo.toml, Python-pakethantering använder pyproject.toml och Hugo-statiska webbplatser konfigureras via config.toml. Att konvertera TOML till JSON online låter dig omvandla dessa konfigurationsfiler till ett format som i princip alla programmeringsspråk, API:er och datapipelines kan konsumera direkt.

JSON (JavaScript Object Notation), definierat av RFC 8259, är det mest brett stödda datautbytesformatet. Medan TOML prioriterar läsbarhet för människor med sin minimala syntax och kommentarstöd, prioriterar JSON maskinkompatibilitet. En TOML till JSON-konverterare överbryggar detta gap genom att tolka TOML-indata enligt TOML v1.0.0-specifikationen och producera ett strukturellt ekvivalent JSON-dokument. Konverteringen bevarar all data: strängar, heltal, flyttal, booleska värden, arrayer och tabeller mappas direkt till sina JSON-motsvarigheter.

TOML har fyra inbyggda datum- och tidtyper som JSON inte kan representera direkt: datum-tider med offset, lokala datum-tider, lokala datum och lokala tider. JSON har ingen datumtyp, så dessa värden serialiseras som ISO 8601-strängar vid konvertering.

Varför använda en TOML till JSON-konverterare?

Konfigurationsfiler skrivna i TOML behöver ofta matas in i system som bara accepterar JSON. Istället för att skriva om filen för hand eller installera ett parsningsbibliotek lokalt hanterar en webbläsarbaserad konverterare omvandlingen på sekunder.

Användningsfall för TOML till JSON

Referens för typmappning TOML till JSON

Varje TOML-typ har en direkt JSON-motsvarighet, med ett undantag: datum- och tidsvärden. Tabellen nedan visar hur varje TOML-typ konverteras till JSON. Denna mappning följer TOML v1.0.0-specifikationen och matchar beteendet hos standardparsers som tomllib (Python), toml-rs (Rust) och @iarna/toml (Node.js).

TOML-heltal stöder understreck för läsbarhet (t.ex. 1_000_000) samt hexadecimala (0xDEADBEEF), oktala (0o755) och binära (0b11010110) literaler. Alla dessa konverteras till vanliga decimala tal i JSON. TOML stöder också oändlighets- och NaN-flyttalsvärden, men dessa har ingen JSON-representation och ger ett konverteringsfel i strikt läge.

Kodexempel

Fungerande exempel på TOML till JSON-konvertering i fyra språk. Varje exempel läser en TOML-fil, tolkar den och matar ut formaterad JSON.

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

Vanliga frågor