Convertisseur JSON vers TOML

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

La conversion JSON vers TOML transforme des données du format JavaScript Object Notation vers Tom's Obvious Minimal Language. JSON utilise des accolades, des crochets et des clés entre guillemets pour représenter des données structurées. TOML utilise une syntaxe clé-valeur plate avec des en-têtes de section (appelés tables) qui se lit comme un fichier INI, mais avec un typage strict. TOML a été conçu spécifiquement pour les fichiers de configuration où la lisibilité humaine prime sur l'échange machine.

TOML est devenu le format de configuration par défaut pour Rust (Cargo.toml), le packaging Python (pyproject.toml), les sites statiques Hugo, les paramètres de déploiement Netlify et de nombreux outils CLI. Lorsque vos données source existent en JSON — depuis une réponse d'API, une configuration exportée ou un fichier généré — et que votre système cible attend du TOML, vous avez besoin d'un convertisseur qui mappe les objets JSON en tables TOML, les tableaux JSON en tableaux TOML, et préserve chaque type de données avec précision.

Convertir JSON vers TOML en ligne est le moyen le plus rapide de générer du TOML valide à partir de données JSON existantes. La conversion gère automatiquement la correspondance des types : les chaînes JSON deviennent des chaînes TOML, les nombres JSON deviennent des entiers ou des flottants TOML, les booléens JSON correspondent directement, et les objets JSON deviennent des tables TOML. La seule exception est null — TOML n'a pas de type null, donc les valeurs null sont soit omises soit converties en chaînes vides selon le convertisseur.

Pourquoi utiliser ce convertisseur JSON vers TOML ?

TOML est ce qu'attendent les fichiers de configuration ; JSON est ce que produisent les API et les outils. Ce convertisseur comble l'écart pour que vous puissiez déplacer des données entre les deux formats sans réécriture manuelle.

Cas d'utilisation JSON vers TOML

Comparaison JSON vs TOML

JSON et TOML se recoupent en termes de capacités, mais diffèrent par leur syntaxe, leur support des types et leur usage prévu. Ce tableau montre les différences qui affectent la conversion.

Pièges de la conversion TOML

TOML a des règles qui diffèrent de JSON de façon à affecter le résultat de la conversion. Ces quatre problèmes causent le plus de confusion.

Exemples de code

Convertir JSON vers TOML par programme nécessite une bibliothèque de sérialisation TOML dans la plupart des langages. Les bibliothèques standard analysent JSON ; la sortie TOML requiert un paquet dédié.

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

Questions fréquentes