Format Atlas

Comparer

YAML vs TOML

YAML et TOML sont des formats texte utilisés pour les configurations éditées par des personnes. YAML accepte des hiérarchies souples ; TOML privilégie des réglages explicites et lisibles avec clés et tables. Choisissez selon l’outil et la structure.

Quel format choisir ?

Utilisez YAML si l’outil l’exige ou si la configuration comporte un fort niveau d’imbrication. Envisagez TOML pour des réglages applicatifs simples à tables et types clairs.

Adapté pour YAML

Fichiers de configuration et données structurées

  • Paramètres maintenus par des personnes

Adapté pour TOML

Configuration d’applications et d’outils

  • Réglages lisibles avec des valeurs structurées

Informations générales

ÉlémentYAMLTOML
Extension.yaml, .yml.toml
Type MIMEapplication/yamlapplication/toml
Usages courantsFichiers de configuration et données structuréesConfiguration d’applications et d’outils
Comment ouvrirOuvrez-le dans un éditeur de texte ou outil YAML et préservez l'indentation par espaces.Ouvrez-le dans un éditeur de texte ou compatible avec les configurations. Consultez la documentation de l’application pour les fonctions TOML prises en charge.
Exporter ou convertirSi le destinataire demande JSON, convertissez-le et vérifiez les types et l'encodage.Lors d’une conversion depuis JSON ou YAML, vérifiez après l’analyse l’imbrication, les tableaux, les guillemets, les dates et les types de valeurs.

Choisir selon l’usage

Paramètres maintenus par des personnes

Fichiers de configuration et données structurées

YAML

Réglages lisibles avec des valeurs structurées

Configuration d’applications et d’outils

TOML

Point clé 1

YAML permet des structures hiérarchiques riches, mais demande de la rigueur sur l’indentation et les types implicites.

En savoir plus sur les différences

Point clé 2

TOML utilise une syntaxe explicite de clés, valeurs et tables pensée pour la lisibilité de configuration.

En savoir plus sur les différences

En savoir plus sur les différences

Suivez le format et la version pris en charge par l’outil cible. Validez avec le vrai parseur et le schéma, notamment dates, nombres, données imbriquées et syntaxe sensible aux espaces.

  • YAML est courant dans les outils d’infrastructure et d’automatisation qui l’imposent.
  • TOML peut clarifier les réglages d’une application, mais tous les outils basés sur YAML ne l’acceptent pas.
  • Les deux formats peuvent être interprétés différemment selon les options du parseur et les règles de types.

Questions fréquentes

TOML est-il plus simple que YAML ?

Il peut l’être pour nombre de configurations simples, mais les exigences de l’outil et la structure priment. Utilisez le format pris en charge de façon fiable.

En savoir plus

Usages et vérifications associés

Choisir un format de configuration

Références et spécifications