Convertisseur JSON vers TOML

Qu'est-ce que le TOML et pourquoi convertir depuis JSON ?

// Convert JSON to TOML in Node.js using the smol-toml library
import { stringify } from 'smol-toml';

const data = JSON.parse(`{
  "package": { "name": "my-app", "version": "1.0.0" },
  "dependencies": { "serde": { "version": "1.0" } }
}`);

// The top-level value must be an object; null values on objects are dropped.
const toml = stringify(data);

console.log(toml);
// [package]
// name = "my-app"
// version = "1.0.0"
//
// [dependencies.serde]
// version = "1.0"

Fonctionnalités clés

Exemples

{
  "package": {
    "name": "my-app",
    "version": "1.0.0",
    "edition": "2021"
  },
  "dependencies": {
    "serde": { "version": "1.0", "features": ["derive"] },
    "tokio": { "version": "1", "features": ["full"] }
  }
}

{
  "build-system": {
    "requires": ["hatchling"],
    "build-backend": "hatchling.build"
  },
  "project": {
    "name": "my-package",
    "version": "0.3.1",
    "requires-python": ">=3.10",
    "dependencies": ["requests>=2.31", "pydantic>=2.0"]
  }
}

{
  "title": "My Service",
  "debug": false,
  "port": 8080,
  "database": {
    "host": "localhost",
    "port": 5432,
    "pool_size": 10
  },
  "features": ["auth", "metrics", "tracing"]
}

{
  "servers": [
    { "name": "alpha", "ip": "10.0.0.1", "ports": [8001, 8002] },
    { "name": "beta", "ip": "10.0.0.2", "ports": [9001] }
  ]
}

{
  "build": {
    "command": "npm run build",
    "publish": "dist",
    "environment": { "NODE_VERSION": "20" }
  },
  "redirects": [
    { "from": "/old", "to": "/new", "status": 301, "force": true }
  ]
}

{
  "tool": {
    "ruff": { "line-length": 100, "target-version": "py310" },
    "black": { "line-length": 100 }
  }
}

Comment l'utiliser

1. 1

   Collez votre JSON

   Saisissez ou collez votre JSON dans le champ de saisie ci-dessus. Vous pouvez aussi cliquer sur « Charger un exemple » pour essayer une source Cargo.toml, une source pyproject.toml ou un objet de réglages d'application.

2. 2

   Voyez la sortie TOML en direct

   Le TOML apparaît instantanément dans le panneau de sortie. Si votre JSON a un tableau de premier niveau ou des valeurs null, l'outil explique exactement quoi faire au lieu de produire une sortie invalide.

3. 3

   Copiez ou téléchargez

   Cliquez sur Copier pour placer le TOML dans votre presse-papiers, ou sur Télécharger pour l'enregistrer en fichier .toml prêt pour Cargo, Poetry, Hugo, Netlify ou tout outil qui lit du TOML.

Pièges JSON vers TOML courants

[1, 2, 3]

{ "items": [1, 2, 3] }

{ "name": "a", "nickname": null }

{ "name": "a", "nickname": "" }

{ "ports": [8001, null, 8003] }

{ "ports": [8001, 8003] }

{ 'name': 'a', 'active': true, }

{ "name": "a", "active": true }

{ "ratio": 1.0 }  →  ratio = 1

{ "ratio": 1.5 }  →  ratio = 1.5

{ "server": { "a": 1 }, "server": [1] }

{ "server": { "a": 1 }, "servers": [1] }

Cas d'usage courants

Générer un Cargo.toml

Transformez du JSON structuré — issu d'un outil d'échafaudage, d'une API ou d'un script — en un Cargo.toml de Rust valide, avec des tables [dependencies] imbriquées et des tables en ligne produites automatiquement.

Générer un pyproject.toml

Convertissez des métadonnées de projet JSON en un pyproject.toml PEP 621, y compris les tables pointées [tool.*], pour qu'un outillage qui émet du JSON puisse produire une config d'empaquetage Python.

Config éditable par un humain à partir de JSON

Transformez les réglages JSON d'une application en un fichier de config TOML lisible que les humains peuvent éditer confortablement, avec des commentaires ajoutés ensuite à la main.

Génération de config de déploiement

Produisez netlify.toml, foundry.toml ou des configs de plateforme similaires à partir de JSON, en transformant les objets imbriqués et les tableaux d'objets en les tables et tableaux de tables qu'attendent ces outils.

Migration de format de configuration

Déplacez une configuration d'un système fondé sur JSON vers un système fondé sur TOML, en utilisant ce convertisseur comme pont et les avertissements sur les null et le niveau supérieur pour repérer tout ce qui ne se mappe pas.

Prototypage de structure TOML

Esquissez une config en JSON — un format que la plupart des développeurs tapent avec aisance — puis convertissez en TOML pour voir la disposition idiomatique en tables et tableaux de tables avant de la valider dans un dépôt.

Détails techniques

Analyse JSON RFC 8259

L'entrée JSON est analysée avec le JSON.parse() natif du navigateur, entièrement conforme à la RFC 8259. Avant la sérialisation, l'outil vérifie que la valeur de premier niveau est un objet et recherche les valeurs null pour pouvoir avertir des clés d'objet supprimées ou rejeter un null dans un tableau avec un chemin précis.

Sortie TOML 1.0.0 via smol-toml

Le TOML est généré avec la bibliothèque smol-toml, un sérialiseur sans dépendance et entièrement conforme à TOML 1.0.0. Les objets imbriqués deviennent des tables, les objets profondément imbriqués deviennent des tables pointées, et les tableaux d'objets deviennent des tableaux de tables. Les flottants à partie fractionnaire nulle sont écrits comme des entiers selon les règles TOML, avec un avertissement.

100% dans le navigateur — aucun téléversement, aucun serveur

Tout le traitement se déroule dans le moteur JavaScript de votre navigateur. Aucune donnée n'est transmise à aucun moment. Les entrées de plus de 200 Ko passent du mode direct au mode manuel (un clic explicite sur Convertir) pour garder l'interface réactive.

Bonnes pratiques

Enveloppez les tableaux de premier niveau sous une clé

Si vos données sont naturellement un tableau JSON, enveloppez-les dans un objet avec une clé descriptive ({ "items": [...] }) avant la conversion. Les documents TOML doivent être une table à la racine, et la clé donne à votre tableau un nom clair dans la sortie.

Décidez de ce que doivent signifier les null

Avant la conversion, décidez si un champ null doit disparaître (supprimer la clé) ou porter une valeur. TOML supprimera les null d'objet et rejettera les null de tableau, résoudre ces cas dans votre JSON d'abord donne une sortie prévisible et complète.

Utilisez des objets imbriqués pour regrouper

Regroupez les réglages liés dans des objets imbriqués dans votre JSON — ils deviennent des [tables] propres et des tables pointées en TOML, bien plus lisibles qu'une liste plate de clés, à l'image de l'organisation des configs Cargo et pyproject.

Validez d'abord votre JSON

Si votre JSON est écrit à la main ou provient d'une source peu fiable, validez-le avec notre formateur JSON pour repérer les virgules finales et les erreurs de guillemets avant de convertir en TOML.

Ajoutez des commentaires après la conversion

JSON n'a pas de commentaires, aucun n'est donc reporté. Comme TOML prend en charge les commentaires #, ajoutez de la documentation au TOML généré à la main — l'une des principales raisons de faire passer une config éditée par des humains vers TOML au départ.

Questions fréquentes