TOML to JSON

Co je převod TOML do JSON?

TOML (Tom's Obvious Minimal Language) je formát konfiguračních souborů navržený pro lidi. Jednoznačně se mapuje na hashovací tabulku, podporuje vnořené tabulky, typované hodnoty a inline komentáře. Mnoho nástrojů a frameworků používá TOML jako primární formát konfigurace: projekty v Rustu se spoléhají na Cargo.toml, Python packaging využívá pyproject.toml a statické weby Hugo se konfigurují přes config.toml. Převod TOML do JSON online umožňuje transformovat tyto konfigurační soubory do formátu, který dokáže nativně konzumovat prakticky každý programovací jazyk, API a datový pipeline.

JSON (JavaScript Object Notation), definovaný normou RFC 8259, je nejrozšířenější formát pro výměnu dat. Zatímco TOML upřednostňuje čitelnost pro lidi díky minimální syntaxi a podpoře komentářů, JSON upřednostňuje vzájemnou interoperabilitu strojů. Převodník TOML na JSON překlenuje tuto mezeru tak, že parsuje vstup TOML podle specifikace TOML v1.0.0 a produkuje strukturálně ekvivalentní JSON dokument. Převod zachovává veškerá data: řetězce, celá čísla, čísla s plovoucí desetinnou čárkou, booleany, pole a tabulky se přímo mapují na jejich protějšky v JSON.

TOML má čtyři nativní typy datum/čas, které JSON nedokáže přímo reprezentovat: datum a čas s časovým pásmem, lokální datum a čas, lokální datum a lokální čas. JSON nemá typ pro datum, proto se tyto hodnoty při převodu serializují jako řetězce ISO 8601.

Proč používat převodník TOML na JSON?

Konfigurační soubory napsané v TOML často potřebují vstupovat do systémů, které přijímají pouze JSON. Místo ručního přepisování souboru nebo lokální instalace knihovny pro parsování zvládne převod za několik sekund nástroj přímo v prohlížeči.

Případy použití TOML na JSON

Referenční tabulka mapování typů TOML na JSON

Každý typ TOML má přímý ekvivalent v JSON s jednou výjimkou: hodnoty datum a čas. Níže uvedená tabulka ukazuje, jak se každý typ TOML převádí do JSON. Toto mapování odpovídá specifikaci TOML v1.0.0 a chování standardních parserů jako tomllib (Python), toml-rs (Rust) a @iarna/toml (Node.js).

Celá čísla TOML podporují pro přehlednost podtržítka (např. 1_000_000) a literály v šestnáctkové (0xDEADBEEF), osmičkové (0o755) a binární (0b11010110) soustavě. Všechny se převedou na desetinná čísla v JSON. TOML také podporuje hodnoty infinity a NaN pro čísla s plovoucí desetinnou čárkou, ale ty nemají v JSON reprezentaci a způsobí chybu převodu v přísném režimu.

Příklady kódu

Funkční příklady převodu TOML na JSON ve čtyřech jazycích. Každý přečte soubor TOML, parsuje jej a vypíše formátovaný 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

Nejčastější dotazy