Hva kontrollerer YAML-validatoren?

YAML er formatet for mange konfigurasjonsfiler: Docker Compose-filer, Kubernetes-manifester, arbeidsflyter i GitHub Actions og GitLab CI, Ansible-spillebøker, OpenAPI-spesifikasjoner og innstillinger for utallige apper. Fordi innrykk har betydning i YAML, kan et manglende mellomrom, en løs tabulator eller en gjentatt nøkkel ødelegge en fil på måter som er vanskelige å oppdage. Validatoren leser YAML-koden din slik en parser gjør, og viser alle problemene med linje- og kolonnenummer.

Slik bruker du den

  1. Lim inn eller skriv YAML i redigeringsfeltet.
  2. Resultatet vises mens du skriver: enten er YAML-koden gyldig, med antall dokumenter den inneholder, eller så vises alle problemene i den rekkefølgen de forekommer i teksten.
  3. Hvert problem markeres i redigeringsfeltet: feil i rødt og advarsler i gult. Klikk på et problem for å bla til det i redigeringsfeltet, eller klikk på en markering for å finne det i listen.

Dette finner den

  • Syntaksfeil: anførselstegn og hakeparenteser som ikke er lukket, elementer med for lite eller for mye innrykk, en nøkkel og et listeelement blandet på samme nivå, tilordninger nøstet på én linje, for eksempel a: b: c.
  • Gjentatte nøkler: samme nøkkel to ganger i én tilordning. De fleste parsere beholder bare én av verdiene uten å varsle, slik at den andre innstillingen går tapt.
  • Tabulatorer brukt som innrykk: YAML tillater bare mellomrom som innrykk.
  • Aliaser uten ankere: Et *name-alias trenger et &name-anker tidligere i det samme dokumentet.
  • Advarsler om ting som kan parses, men kanskje ikke fungerer som ønsket, for eksempel en tagg parseren ikke kjenner igjen, eller en %YAML-versjon som ikke støttes.

Samme nøkkel i ulike tilordninger er helt greit, og det samme gjelder filer med flere dokumenter atskilt med ---: Linjene telles i hele filen.

Dette kontrollerer den ikke

Validatoren kontrollerer at teksten er gyldig YAML, ikke at et bestemt program godtar den. En Docker Compose-fil kan være gyldig YAML og likevel inneholde en innstilling Docker Compose ikke kjenner igjen. Meldingene kommer fra yaml-biblioteket og er på engelsk.

Slik fungerer den

Verktøyet parser teksten med yaml-biblioteket, som følger YAML 1.2-spesifikasjonen og krever at nøkler er unike. Alt kjøres i nettleseren din: Filene dine lastes aldri opp.

Funksjoner

  • Syntaksfeil med linje- og kolonnenummer
  • Gjentatte nøkler, tabulatorer brukt som innrykk og aliaser uten ankere
  • Feil og advarsler markert i redigeringsfeltet, med klikk for å bla til dem
  • Filer med flere dokumenter
  • Kjører i nettleseren din