Loading…

À propos Formateur TOML en ligne

Des configurations `pyproject.toml`, `Cargo.toml` ou `poetry` désordonnées ? Collez votre TOML ou déposez un fichier et notre formateur normalisera les espaces, arrangera les tableaux et les tables en ligne, et maintiendra vos sections uniformément espacées. Idéal pour Python, Rust, Go, les générateurs de sites statiques et tout projet qui repose sur TOML pour la configuration.

Fonctionnalités principales du formateur TOML

  • **Embellisseur en un clic** pour les fichiers et extraits de configuration TOML
  • **Taille d'indentation configurable** de 1 à 8 espaces via le curseur *Taille d'indentation*
  • **Basculement du style d'indentation** – choisissez entre espaces ou tabulations pour l'indentation
  • **Contrôle du retour à la ligne / longueur de ligne** pour maintenir les tableaux longs et les tables en ligne dans une largeur de colonne choisie
  • Prend en charge les fichiers `.toml` tels que `pyproject.toml`, `Cargo.toml`, `Pipfile.toml`, `poetry.toml` et plus
  • Analyseur TOML basé sur Prettier qui comprend les dates, tableaux, tables imbriquées et tables en ligne
  • Formatage stable et idempotent – le réexécuter sur le même fichier ne causera pas de dérive de formatage
  • Copie en un clic de la sortie formatée, prête pour votre éditeur ou commit

🛠️ Comment formater les fichiers TOML en ligne for toml-formatter

1

1. Collez ou téléchargez votre TOML

📥 Collez le TOML dans l'éditeur ou glissez-déposez un fichier `.toml` tel que `pyproject.toml` ou `Cargo.toml`. L'outil analyse le contenu en tant que TOML, pas en tant qu'INI/JSON générique.

2

2. Choisissez l'indentation et les paramètres de retour à la ligne

⚙️ Utilisez le curseur **Taille d'indentation** pour choisir le nombre d'espaces par niveau d'indentation, et basculez le **Style d'indentation** vers les tabulations si votre projet les préfère. Ajustez **Retour à la ligne / Longueur de ligne** pour contrôler quand les tableaux longs ou tables en ligne doivent revenir à la ligne (ou définissez-le sur `0` pour désactiver efficacement le retour à la ligne).

3

3. Cliquez sur « Formater »

🚀 Appuyez sur le bouton **Formater**. Le formateur réorganisera les tableaux, nettoiera l'espacement autour des `=` et des virgules, normalisera l'espacement des tables et appliquera des sauts de ligne cohérents tout en préservant vos données.

4

4. Vérifiez, copiez ou enregistrez

🔍 Comparez le TOML original et formaté. Lorsque vous êtes satisfait, copiez le résultat dans votre éditeur ou enregistrez-le en tant que nouveau fichier `.toml` dans votre projet.

Spécifications techniques

Fonctionnalités TOML prises en charge

Le formateur est conçu pour les configurations de projet réelles et comprend les constructions TOML modernes.

FonctionnalitéPrise en chargeExemples / Notes
Tables et sous-tables✅ Complète[tool.poetry], [project], [database.replica]
Tableaux✅ ComplèteTableaux en ligne et tableaux de tables
Tables en ligne✅ Completserveurs = { alpha = "10.0.0.1", beta = "10.0.0.2" }
Dates et heures✅ Complet2025-09-23T10:20:30Z et formats de date locaux
Commentaires✅ Préservés# les commentaires restent près des paramètres qu'ils décrivent
Chaînes multilignes✅ CompletChaînes TOML entre triples guillemets pour les blocs de texte longs

Options de Formatage (Liées aux Contrôles de l'Outil)

Ces options sont exposées directement dans l'interface utilisateur et connectées au plugin Prettier TOML sous-jacent :

OptionContrôle UIPlage / ValeursPar défaut
Taille de l'indentationCurseur Taille d'indentation1–8 espaces2 espaces
Style d'indentationSélecteur Style d'indentationEspaces / TabulationsEspaces
Longueur de ligneRetour à la ligne / Longueur de ligne0–120 colonnes (0 = pas de retour effectif)80 colonnes
Fin de ligneFin de ligne (en interne)LF / CRLFLF en sortie navigateur

Entrée & Limites

L'outil est optimisé pour les fichiers TOML de petite à moyenne taille couramment trouvés dans les dépôts d'applications.

ParamètreValeur / ComportementNotes
Extensions de fichier.tomlTout fichier de configuration basé sur TOML
Types MIMEapplication/toml, text/x-tomlUtilisé pour la détection de fichiers dans la zone de dépôt
Taille maximale du fichier~5 MoLes fichiers plus volumineux peuvent être plus lents et sont mieux gérés en CI
Nombre maximal de caractères≈ 2 000 000Limite stricte dans l'exécution du formateur pour éviter le blocage du navigateur

Validation & Gestion des Erreurs

Si votre fichier n'est pas un TOML valide (par exemple, `=` manquant ou guillemets non correspondants), le formateur retournera généralement une erreur lisible au lieu d'une sortie formatée. Corrigez la ligne indiquée et relancez le formateur.

Alternatives en Ligne de Commande pour le Formatage TOML

Vous aimez le résultat et souhaitez le même style en CI ou dans les hooks pre-commit ? Voici des options adaptées à la CLI :

Multiplateforme (Node.js / Prettier)

Installer Prettier et le plugin TOML

npm install --save-dev prettier prettier-plugin-toml

Ajoute Prettier et l'analyseur TOML à votre projet.

Formater un fichier TOML avec Prettier

npx prettier --parser toml --write pyproject.toml

Réécrit `pyproject.toml` en place en utilisant les règles TOML de Prettier.

Linux / macOS / Windows (Taplo CLI)

Formater TOML avec Taplo

taplo fmt pyproject.toml

Un autre formateur CLI populaire pour les fichiers TOML.

Vérifier le formatage en CI

taplo fmt --check .

Fait échouer la build si les fichiers TOML ne sont pas correctement formatés.

Utilisez cet outil en ligne pour des modifications et expériences rapides, puis appliquez le même style avec Prettier ou Taplo dans vos pipelines CI.

Cas d'Utilisation Courants du Formateur TOML

Empaquetage Python (`pyproject.toml`)

Gardez les métadonnées du projet Python et la configuration des outils propres et faciles à réviser.

  • Aligner les sections `[project]`, `[tool.poetry]` et `[tool.black]`.
  • Normaliser les tableaux de dépendances et les spécificateurs de version.
  • Rendre les différences de configuration plus faciles à lire dans les pull requests.
[project]
name = "my-app"
version = "0.1.0"

[tool.black]
line-length = 88
include = "\.(py|pyi)$"

Projets Rust (`Cargo.toml`)

Ordonnez les manifestes de paquets Rust dans les espaces de travail et microservices.

  • Gardez `[dependencies]` et `[dev-dependencies]` triés et espacés de manière cohérente.
  • Normalisez les tables en ligne utilisées pour les drapeaux de fonctionnalités complexes.
  • Standardisez le formatage sur plusieurs crates dans un espace de travail.
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

Sites statiques & outils (Hugo, Zola, etc.)

Nettoyez le TOML utilisé pour les générateurs de sites statiques et l'outillage divers.

  • Formatez `config.toml` pour Hugo ou d'autres générateurs de sites statiques.
  • Gardez les blocs de configuration multilingues lisibles.
  • Normalisez les longues listes telles que les entrées de menu et les taxonomies.

❓ Frequently Asked Questions

❓Qu'est-ce qu'un formateur TOML ?

Un formateur TOML restructure automatiquement vos fichiers TOML pour qu'ils suivent un style cohérent : il corrige l'indentation, aligne les tableaux et les tables en ligne, normalise les espaces autour des `=` et des virgules, et préserve les données tout en les rendant plus faciles à lire et à réviser.

📏Comment choisir la taille et le style d'indentation ?

Si votre équipe n'a pas de préférence, **2 espaces** est un bon choix par défaut. Respectez le style déjà utilisé dans votre dépôt : si les fichiers sont principalement indentés avec des espaces, continuez à utiliser des espaces ; si les tabulations sont la norme de l'équipe, changez le **Style d'indentation** en Tabulations pour que les nouveaux changements s'alignent avec le code existant.

🧪Le formateur valide-t-il la syntaxe TOML ?

L'analyseur sous-jacent rejettera le TOML invalide (par exemple, un `=` manquant ou des guillemets non correspondants). Dans ce cas, l'outil affiche un message d'erreur au lieu d'une sortie formatée, afin que vous puissiez corriger le problème et réessayer.

🔁L'exécution du formateur peut-elle changer le comportement de ma configuration ?

Le formateur est conçu pour **préserver la sémantique** : il ne modifie que les espaces et la mise en page, pas les clés, les valeurs ou la structure des tables. Tant que le fichier original est un TOML valide, la signification de votre configuration devrait rester la même.

🔒Est-il sûr de formater des fichiers de configuration sensibles ?

Comme pour tout outil en ligne, évitez de coller du matériel extrêmement sensible comme des secrets de production. Pour les configurations hautement confidentielles, utilisez un formateur TOML local (comme Prettier ou Taplo) dans votre environnement de développement privé.

Pro Tips

Best Practice

Gardez un `pyproject.toml` ou `Cargo.toml` bien formaté dans votre branche principale, puis imposez le même style en CI avec Prettier ou Taplo.

Best Practice

Formatez le TOML avant de valider de gros changements de dépendances ou de configuration pour que vos diffs Git se concentrent sur les **changements réels**, pas sur le bruit des espaces.

Best Practice

Lors du refactoring des configurations, formatez d'abord le fichier, validez, puis changez les valeurs. Cela facilite la revue de ce qui a vraiment changé.

Best Practice

Utilisez la même **taille d'indentation** et **longueur de retour à la ligne** dans tous vos fichiers TOML pour une navigation et des revues de code cohérentes entre les projets.

Additional Resources

Spécification TOML v1.0.0
Documentation
Plugin Prettier TOML
Documentation
Taplo – Boîte à outils TOML
Documentation

Other Tools