TOML do JSON

Czym jest konwersja TOML do JSON?

TOML (Tom's Obvious Minimal Language) to format pliku konfiguracyjnego zaprojektowany z myślą o czytelności dla człowieka. Mapuje jednoznacznie na tablicę asocjacyjną, obsługuje zagnieżdżone tabele, typowane wartości i komentarze inline. Wiele narzędzi i frameworków używa TOML jako podstawowego formatu konfiguracji: projekty Rust polegają na Cargo.toml, pakietowanie Python korzysta z pyproject.toml, a statyczne strony Hugo konfiguruje się przez config.toml. Konwersja TOML do JSON online pozwala przekształcać te pliki konfiguracyjne w format, który praktycznie każdy język programowania, API i potok danych obsługuje natywnie.

JSON (JavaScript Object Notation), zdefiniowany przez RFC 8259, jest najszerzej obsługiwanym formatem wymiany danych. Podczas gdy TOML stawia na czytelność dla człowieka dzięki minimalistycznej składni i obsłudze komentarzy, JSON priorytetyzuje interoperacyjność maszynową. Konwerter TOML do JSON wypełnia tę lukę, parsując dane wejściowe TOML zgodnie ze specyfikacją TOML v1.0.0 i emitując strukturalnie równoważny dokument JSON. Konwersja zachowuje wszystkie dane: ciągi, liczby całkowite, liczby zmiennoprzecinkowe, wartości logiczne, tablice i tabele mapują bezpośrednio na swoje odpowiedniki w JSON.

TOML posiada cztery natywne typy daty i godziny, których JSON nie może reprezentować bezpośrednio: daty i godziny z przesunięciem strefy czasowej, lokalne daty i godziny, lokalne daty oraz lokalne godziny. JSON nie ma typu daty, więc podczas konwersji te wartości są serializowane jako ciągi ISO 8601.

Dlaczego warto używać konwertera TOML do JSON?

Pliki konfiguracyjne napisane w TOML często muszą zasilać systemy akceptujące wyłącznie JSON. Zamiast ręcznie przepisywać plik lub instalować lokalnie bibliotekę parsera, konwerter działający w przeglądarce wykonuje transformację w kilka sekund.

Przypadki użycia konwertera TOML do JSON

Tabela mapowania typów TOML na JSON

Każdy typ TOML ma bezpośredni odpowiednik w JSON, z jednym wyjątkiem: wartości daty i godziny. Poniższa tabela pokazuje, jak każdy typ TOML jest konwertowany do JSON. Mapowanie to jest zgodne ze specyfikacją TOML v1.0.0 i odpowiada zachowaniu standardowych parserów, takich jak tomllib (Python), toml-rs (Rust) i @iarna/toml (Node.js).

Liczby całkowite TOML obsługują podkreślenia dla czytelności (np. 1_000_000) oraz literały szesnastkowe (0xDEADBEEF), ósemkowe (0o755) i binarne (0b11010110). Wszystkie te wartości są konwertowane na zwykłe liczby dziesiętne w JSON. TOML obsługuje również wartości zmiennoprzecinkowe nieskończoność i NaN, ale nie mają one reprezentacji w JSON i spowodują błąd konwersji w trybie ścisłym.

Przykłady kodu

Działające przykłady konwersji TOML do JSON w czterech językach. Każdy odczytuje plik TOML, parsuje go i generuje sformatowany 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

Często zadawane pytania