Formateur et Validateur YAML

Le YAML utilise l'indentation (espaces) pour définir la structure du document et le nesting — il n'y a pas d'accolades ou de balises de fermeture comme dans JSON ou XML. Le niveau d'indentation d'un élément détermine s'il est enfant de l'élément supérieur ou s'il est un élément frère. Un espace en trop ou en moins peut changer complètement le sens : une clé qui devrait être une sous-propriété d'une définition de service pourrait devenir une clé de premier niveau à la place, souvent sans aucun message d'erreur de la part du parseur YAML. C'est pourquoi les erreurs YAML sont notoirement difficiles à déboguer — le symptôme (mauvaise configuration) peut être très éloigné de la cause (un espace erratique sur la ligne 47).

Non. La spécification YAML interdit explicitement les caractères de tabulation pour l'indentation. Les tabulations sont autorisées à l'intérieur des chaînes de caractères entre guillemets, mais jamais comme indentation. Si votre éditeur est configuré pour insérer des tabulations lorsque vous appuyez sur Tab, basculez-le pour insérer des espaces pour les fichiers YAML. De nombreux bugs liés au YAML sont causés par des tabulations invisibles dans des fichiers qui semblent correctement indentés. Ce formateur détecte et normalise l'indentation par tabulation en espaces.

Le formateur gère l'ensemble complet des fonctionnalités de YAML 1.2 : types scalaires (chaînes, entiers, nombres à virgule flottante, booléens, null), bloc mappings (clé: valeur), séquences de blocs (- élément), style flow (inline {} et []), chaînes multilignes (bloc littéral | et bloc replié >), commentaires (#), ancres (&anchor) et alias (*alias), documents multiples (séparateur ---) et tags de type explicites (!!str, !!int, etc.). Les structures imbriquées complexes comme les pods Kubernetes avec volumes, tableaux env et limites de ressources sont formatées correctement.

Les commentaires sont reconnus lors de la validation et du parsing. Pendant le formatage, l'outil resérialise la structure de données analysée — parce que la plupart des parseurs YAML n'attachent pas les commentaires au modèle de données, les commentaires peuvent ne pas être entièrement préservés dans la sortie formatée. À des fins de validation (vérification de la structure), les commentaires sont traités correctement. Si la préservation exacte des commentaires est critique, copiez la version formatée dans votre éditeur et rajoutez les commentaires manuellement.

Les erreurs les plus fréquentes : (1) Indentation incohérente — mélange d'indentation de 2 espaces et 4 espaces, ou de tabulations mélangées avec des espaces. (2) Clés en double dans le même mapping. (3) Chaînes non citées que YAML interprète comme des valeurs spéciales — "yes", "no", "true", "false", "null", "on", "off" sont toutes interprétées comme des booléens ou null en YAML 1.1 (courant dans les anciennes configurations Kubernetes). (4) Deux-points sans espaces dans les clés non citées. (5) Espace manquant après les deux-points dans les paires clé: valeur. (6) Chaînes non citées contenant des caractères spéciaux YAML (: { } [ ] # &).

YAML est un superset de JSON — un JSON valide est également un YAML valide. Le YAML ajoute des fonctionnalités conviviales pour l'humain que JSON n'a pas : commentaires, chaînes multilignes, ancres/alias pour réutiliser des valeurs et moins de ponctuation (pas de virgules entre les éléments d'un tableau, pas de guillemets nécessaires pour les valeurs de chaînes simples). JSON présente des avantages pour les données générées par machine : il n'est pas sensible à l'indentation, est supporté nativement par tous les langages et est sans ambiguïté. Pour les fichiers de configuration édités à la main, le YAML est généralement préféré. Pour les réponses API et le stockage de données, JSON est le choix dominant.

Non. Tout le formatage et la validation s'exécutent dans votre navigateur en utilisant un parseur YAML JavaScript. Vos fichiers de configuration, qui peuvent contenir des variables d'environnement, des identifiants et des détails d'infrastructure, ne quittent jamais votre appareil.