TOML vers JSON

Qu'est-ce que la conversion TOML vers JSON ?

TOML (Tom's Obvious Minimal Language) est un format de fichier de configuration conçu pour être lisible par les humains. Il se mappe sans ambiguïté vers une table de hachage, prend en charge les tables imbriquées, les valeurs typées et les commentaires en ligne. De nombreux outils et frameworks utilisent TOML comme format de configuration principal : les projets Rust s'appuient sur Cargo.toml, le packaging Python utilise pyproject.toml, et les sites statiques Hugo se configurent via config.toml. Convertir TOML en JSON en ligne vous permet de transformer ces fichiers de configuration dans un format que pratiquement tous les langages de programmation, API et pipelines de données peuvent consommer nativement.

JSON (JavaScript Object Notation), défini par la RFC 8259, est le format d'échange de données le plus largement supporté. Alors que TOML privilégie la lisibilité humaine avec sa syntaxe minimale et la prise en charge des commentaires, JSON favorise l'interopérabilité entre machines. Un convertisseur TOML vers JSON comble cet écart en analysant l'entrée TOML selon la spécification TOML v1.0.0 et en produisant un document JSON structurellement équivalent. La conversion préserve toutes les données : les chaînes, entiers, flottants, booléens, tableaux et tables sont directement mappés vers leurs équivalents JSON.

TOML possède quatre types natifs de date/heure que JSON ne peut pas représenter directement : les date-heures avec décalage, les date-heures locales, les dates locales et les heures locales. JSON n'ayant pas de type date, ces valeurs sont sérialisées sous forme de chaînes ISO 8601 lors de la conversion.

Pourquoi utiliser un convertisseur TOML vers JSON ?

Les fichiers de configuration écrits en TOML doivent souvent alimenter des systèmes qui n'acceptent que le JSON. Plutôt que de réécrire le fichier à la main ou d'installer une bibliothèque d'analyse en local, un convertisseur basé sur le navigateur effectue la transformation en quelques secondes.

Cas d'utilisation de TOML vers JSON

Référence de correspondance des types TOML vers JSON

Chaque type TOML a un équivalent JSON direct, à une exception près : les valeurs de date et d'heure. Le tableau ci-dessous montre comment chaque type TOML se convertit en JSON. Ce mappage suit la spécification TOML v1.0.0 et correspond au comportement des parseurs standard comme tomllib (Python), toml-rs (Rust) et @iarna/toml (Node.js).

Les entiers TOML prennent en charge les tirets bas pour la lisibilité (ex. : 1_000_000) ainsi que les littéraux hexadécimaux (0xDEADBEEF), octaux (0o755) et binaires (0b11010110). Tous se convertissent en nombres décimaux ordinaires en JSON. TOML prend également en charge les valeurs flottantes infinity et NaN, mais celles-ci n'ont pas de représentation JSON et provoqueront une erreur de conversion en mode strict.

Exemples de code

Exemples fonctionnels de conversion TOML vers JSON dans quatre langages. Chacun lit un fichier TOML, l'analyse et produit un JSON formaté.

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

Questions fréquentes