YAML-validator
Controleer YAML op syntaxisfouten, dubbele sleutels en andere problemen. Bij elk probleem worden de regel en kolom vermeld. Werkt in je browser.
Invoer
Uitvoer
Readme
Wat controleert de YAML-validator?
YAML is het formaat van veel configuratiebestanden: Docker Compose-bestanden, Kubernetes-manifesten, workflows voor GitHub Actions en GitLab CI, Ansible-playbooks, OpenAPI-specificaties en de instellingen van talloze apps. Omdat inspringing in YAML betekenis heeft, kan een ontbrekende spatie, een verdwaalde tab of een herhaalde sleutel een bestand op manieren beschadigen die moeilijk op te merken zijn. De validator leest je YAML zoals een parser dat doet en vermeldt elk probleem met het regel- en kolomnummer.
Zo gebruik je de validator
- Plak of typ YAML in de editor.
- Het resultaat verschijnt terwijl je typt: de YAML is geldig, met het aantal documenten dat erin staat, of elk probleem wordt vermeld in de volgorde waarin het in de tekst voorkomt.
- Elk probleem wordt gemarkeerd in de editor: fouten in rood en waarschuwingen in geel. Klik op een probleem om de editor ernaartoe te laten scrollen, of klik op een markering om het probleem in de lijst te vinden.
Wat de validator vindt
- Syntaxisfouten: niet-afgesloten aanhalingstekens en haakjes, items die te weinig of te ver zijn ingesprongen, een sleutel en een lijstitem die op hetzelfde niveau door elkaar staan, mappings die op één regel zijn genest, zoals
a: b: c. - Herhaalde sleutels: dezelfde sleutel twee keer in één mapping. De meeste parsers behouden dan stilzwijgend slechts één van de waarden, waardoor de andere instelling verloren gaat.
- Tabs gebruikt voor inspringing: YAML staat alleen spaties toe voor inspringing.
- Aliassen zonder ankers: een alias
*nameheeft eerder in hetzelfde document een anker&namenodig. - Waarschuwingen voor zaken die wel worden geparseerd, maar mogelijk niet werken zoals bedoeld, zoals een tag die de parser niet kent of een niet-ondersteunde
%YAML-versie.
Dezelfde sleutel in verschillende mappings is geen probleem. Ook een bestand met meerdere documenten, gescheiden door ---, is toegestaan: de regels worden over het hele bestand geteld.
Wat de validator niet controleert
De validator controleert of de tekst geldige YAML is, niet of een bepaald programma de tekst accepteert. Een Docker Compose-bestand kan geldige YAML bevatten en toch een instelling bevatten die Docker Compose niet kent. De meldingen komen uit de yaml-bibliotheek en zijn in het Engels.
Werking
De tool parseert de tekst met de yaml-bibliotheek, die de YAML 1.2-specificatie volgt en vereist dat sleutels uniek zijn. Alles wordt uitgevoerd in je browser: je bestanden worden nooit geüpload.
Functies
- Syntaxisfouten met regel- en kolomnummer
- Herhaalde sleutels, tabs voor inspringing en aliassen zonder ankers
- Fouten en waarschuwingen gemarkeerd in de editor, met de mogelijkheid om ernaartoe te scrollen door erop te klikken
- Bestanden met meerdere documenten
- Werkt in je browser