TOML — fichier .toml

stable

Format de configuration texte moderne, pensé pour être à la fois lisible et strictement spécifié.

Le TOML (Tom’s Obvious Minimal Language) a été conçu explicitement pour combler les lacunes de l’INI : là où l’INI n’a jamais eu de spécification formelle unique, le TOML définit précisément sa syntaxe, ses types de données (chaînes, nombres, dates, tableaux) et son comportement, tout en restant lisible sans formation particulière.

Ce format n’a aucune signature binaire : c’est du texte pur, structuré en tables identifiées par des crochets et des paires clé = valeur typées.

Son type MIME officiel application/toml n’a été enregistré à l’IANA qu’en octobre 2024, bien après l’adoption massive du format par l’écosystème des développeurs — notamment comme format de configuration standard de nombreux gestionnaires de paquets modernes (Cargo pour Rust, par exemple).

Contrairement au YAML, dont l’indentation significative et la richesse syntaxique ont été sources récurrentes d’erreurs subtiles, le TOML fait le choix délibéré d’une syntaxe plate et sans ambiguïté, quitte à se montrer plus verbeux pour représenter des structures profondément imbriquées.

Son typage strict des valeurs (une date reste une date, un entier reste un entier, sans conversion implicite ambiguë) évite une classe entière de bogues de configuration qui touchent parfois le YAML, où une valeur comme “no” peut être interprétée à tort comme un booléen selon l’implémentation.

L’écosystème Python a officiellement adopté le TOML pour son fichier de configuration de projet unifié pyproject.toml (normalisé par les PEP 518 et 621), centralisant ce qui était auparavant dispersé entre plusieurs fichiers de configuration aux syntaxes différentes selon l’outil utilisé.

Hugo, un générateur de site statique très utilisé pour les blogs et la documentation technique, accepte le TOML comme l’une des syntaxes possibles pour son fichier de configuration principal, aux côtés du YAML et du JSON, laissant chaque auteur choisir la syntaxe qu’il préfère sans imposer un format unique au reste de l’écosystème.

Signature binaire

Ce format n'a pas de signature binaire fiable : il ne peut pas être identifié de façon certaine par ses seuls premiers octets.

Vérifier qu'un fichier porte bien cette signature →

Questions fréquentes

Comment ouvrir un fichier .toml ?

Visual Studio Code permet d'ouvrir gratuitement un fichier .toml. Voir la liste complète des logiciels compatibles ci-contre.

Quel est le type MIME du format TOML ?

Le type MIME du format TOML est application/toml.

Le format TOML (.toml) est-il encore utilisé aujourd'hui ?

Oui, le format TOML est stable et toujours largement utilisé, sans signe de déclin.

Peut-on ouvrir un fichier .toml sur mobile, sans installer d'application ?

Oui : Visual Studio Code fonctionne directement depuis le navigateur d'un smartphone ou d'une tablette, sans application dédiée à installer.

Pourquoi mon fichier .toml ne s'ouvre-t-il pas ?

Les causes les plus fréquentes sont l'absence de logiciel compatible installé, un téléchargement ou un transfert incomplet, ou une extension qui ne correspond plus au contenu réel du fichier. Voir le guide complet sur les causes possibles, ou vérifier le format réel avec l'identifieur de fichier.

Un fichier ne s'ouvre pas : les causes possibles →

Comment savoir si un fichier est corrompu →

Sources

Dernière mise à jour :