JSON to TOML

Co je převod JSON na TOML?

Převod JSON na TOML transformuje data z formátu JavaScript Object Notation do formátu Tom's Obvious Minimal Language. JSON používá složené závorky, hranaté závorky a klíče v uvozovkách k reprezentaci strukturovaných dat. TOML používá plochý zápis klíč-hodnota s hlavičkami sekcí (tzv. tabulkami), který připomíná INI soubor, ale se striktním typováním. TOML byl navržen specificky pro konfigurační soubory, kde je důležitější čitelnost pro člověka než výměna dat mezi systémy.

TOML se stal výchozím konfiguračním formátem pro Rust (Cargo.toml), Python balíčky (pyproject.toml), statické weby Hugo, nastavení nasazení Netlify a mnoho CLI nástrojů. Pokud vaše zdrojová data existují jako JSON — z API odpovědi, exportované konfigurace nebo vygenerovaného souboru — a váš cílový systém očekává TOML, potřebujete převodník, který mapuje JSON objekty na TOML tabulky, JSON pole na TOML pole a přesně zachovává každý datový typ.

Převod JSON na TOML online je nejrychlejší způsob, jak vygenerovat platný TOML z existujících JSON dat. Převod zpracovává mapování typů automaticky: JSON řetězce se stávají TOML řetězci, JSON čísla se stávají TOML celými čísly nebo desetinnými čísly, JSON logické hodnoty se mapují přímo a JSON objekty se stávají TOML tabulkami. Jedinou výjimkou je null — TOML nemá typ null, takže hodnoty null jsou buď vynechány, nebo převedeny na prázdné řetězce v závislosti na převodníku.

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

TOML je formát, který konfigurační soubory vyžadují; JSON je to, co produkují API a nástroje. Tento převodník překlenuje mezeru, abyste mohli přesouvat data mezi oběma formáty bez ručního přepisování.

Případy použití JSON na TOML

Srovnání JSON a TOML

JSON a TOML se překrývají ve schopnostech, ale liší se syntaxí, podporou typů a zamýšleným použitím. Tato tabulka ukazuje rozdíly, které ovlivňují převod.

Záludnosti při převodu na TOML

TOML má pravidla, která se od JSON liší způsoby ovlivňujícími výstup převodu. Tyto čtyři problémy způsobují nejvíce nejasností.

Příklady kódu

Programový převod JSON na TOML vyžaduje ve většině jazyků knihovnu pro serializaci TOML. Standardní knihovny parsují JSON; pro výstup TOML je potřeba specializovaný balíček.

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

Časté dotazy