Formateur TOML
Formatez les fichiers de configuration TOML tels que Cargo.toml, pyproject.toml et d'autres paramètres d'applications avec le plugin Prettier TOML. Le formateur normalise les espaces autour des signes égal, des tables en ligne et des tableaux, sépare les tables par une ligne vide, conserve tous les commentaires et signale les erreurs de syntaxe avec leur ligne et leur colonne. Les développeurs peuvent ainsi mettre en forme leur configuration en toute sécurité avant de la valider.
Foire aux questions
Quel moteur formate TOML ?
L'outil utilise Prettier 3 avec prettier-plugin-toml 4.1 sur le serveur. Il lit les documents TOML 1.0 et les affiche selon un style cohérent.
Qu'est-ce qui change dans le résultat ?
Les clés et les valeurs sont séparées par un espace de chaque côté du signe égal, et les tables en ligne et les tableaux sont espacés uniformément. Les lignes vides superflues sont supprimées et chaque en-tête de table est séparé de la section précédente par une ligne vide.
Les commentaires sont-ils conservés ?
Oui. Les commentaires sur une ligne et ceux placés à la fin des lignes après les valeurs restent à leur place, ce qui permet de conserver les notes dans les fichiers de configuration annotés.
Les clés ou les tables sont-elles triées ?
Non. Les clés, les tables et les tableaux de tables conservent leur ordre d'origine, ce qui est important pour les fichiers que l'on lit de haut en bas.
Les guillemets des chaînes peuvent-ils changer ?
Les chaînes littérales entre apostrophes simples peuvent être réécrites avec des guillemets doubles si leur valeur ne contient ni barre oblique inversée ni guillemet double, sans que la valeur change. Les chaînes qui nécessitent des guillemets littéraux conservent leurs apostrophes simples.
Comment les tableaux longs sont-ils traités ?
Les tableaux qui tiennent dans la largeur de ligne restent sur une seule ligne. Ceux qui se terminent par une virgule ou dépassent cette largeur sont affichés avec un élément par ligne.
Que se passe-t-il si TOML est invalide ?
Le formatage s'arrête et l'outil affiche le message de l'analyseur avec la ligne et la colonne, par exemple si une valeur manque après un signe égal. Les clés en double et les autres cas de TOML invalide sont signalés de la même manière.
Puis-je modifier l'indentation ?
Oui. Choisissez 2 ou 4 espaces ou des tabulations pour les tableaux imbriqués, ainsi qu'une largeur de ligne de 40 à 200 caractères, avec 80 par défaut.
Quelle peut être la taille du fichier ?
Jusqu'à 1 MB de texte par requête, soit bien plus que la taille habituelle des fichiers de configuration. Le formatage s'arrête au bout de 10 secondes.
Ma configuration est-elle stockée ?
Non. Les fichiers de configuration pouvant contenir des secrets, leur contenu est traité uniquement en mémoire et n'est jamais enregistré ni consigné.