TOML-validaattori
Validoi TOML-tiedostot, kuten Cargo.toml, pyproject.toml tai Hugo- ja Netlify-asetukset, ennen kuin virhe pysäyttää koonnin. Validaattori jäsentää syötteen TOML-spesifikaation mukaan ja ilmoittaa ensimmäisen virheen sekä sen rivin, sarakkeen ja jäsentimen selityksen. Virheitä voivat olla esimerkiksi päällekkäiset avaimet, uudelleen määritellyt taulut ja mahdottomat päivämäärät. Kelvollisista tiedostoista näytetään taulujen ja avainten määrä sekä ylimmän tason avaimet, jotta voit tarkistaa rakenteen yhdellä silmäyksellä.
Usein kysytyt kysymykset
Mitä TOML-validaattori tarkistaa?
Se jäsentää avaimet, merkkijonot, luvut, totuusarvot, päivämäärät ja ajat, taulukot, sisäiset taulut, taulut sekä taulujen taulukot täsmälleen TOML-spesifikaation määrittämällä tavalla. Poikkeamat, kuten puuttuva arvo, lainaamaton merkkijono tai virheellinen poistomerkintä, ilmoitetaan virheinä. Kelvollisista tiedostoista näytetään lyhyt yhteenveto niiden rakenteesta.
Mitä tietoja virhe sisältää?
Kussakin virheessä näkyvät rivi ja sarake, johon jäsentäminen pysähtyi, sekä jäsentimen lisätietorivi, jossa voi lukea esimerkiksi virheellisestä päivämäärästä tai jo määritellyn taulun tai arvon uudelleenmäärittämisestä. Rivien ja sarakkeiden numerointi alkaa arvosta 1. Näytössä on vain ensimmäinen virhe, koska myöhemmät virheet johtuvat usein siitä.
Miksi avain tai taulu ilmoitetaan uudelleen määritellyksi?
TOML ei salli saman avaimen esiintymistä taulussa kahdesti, ja tauluotsake, kuten [server], voi esiintyä vain kerran. Myös pisteavaimen, kuten server.port, määrittely [server]-taulun jälkeen lasketaan uudelleenmäärittelyksi, jos taulussa on jo asetettu port. Korjaa tämä yhdistämällä merkinnät samaan paikkaan.
Miten taulut ja avaimet lasketaan?
Taulut laskee kaikki juuren alapuolella olevat taulut, mukaan lukien sisäiset taulut ja jokaisen taulujen taulukon alkion. Avaimet laskee kaikki avaimet, joiden arvona ei ole taulu tai taulujen taulukko. Siksi merkkijonoluettelo lasketaan yhdeksi avaimeksi. Ylimmän tason avaimet näyttää juuren avainten nimet, enintään 50 nimeä.
Tarkistetaanko päivämäärät ja ajat?
Kyllä. Aikavyöhykkeen sisältävät päivämäärä-ajat, paikalliset päivämäärä-ajat, paikalliset päivämäärät ja paikalliset ajat validoidaan. Tarkistuksessa havaitaan myös mahdottomat arvot, kuten kuukausi 13 tai tunti 25. Muussa muodossa kirjoitettu päivämäärä, esimerkiksi 05/27/1979, ei ole kelvollinen TOML-päivämäärä, joten se on lainattava merkkijonoksi.
Millaiset merkkijonot ja poistomerkinnät ovat sallittuja?
Kaksinkertaisilla lainausmerkeillä rajatuissa perusmerkkijonoissa voi käyttää poistomerkintöjä, kuten \n, \t, \" ja \uXXXX. Yksinkertaisilla lainausmerkeillä rajatuissa kirjaimellisissa merkkijonoissa jokainen merkki tulkitaan sellaisenaan. Molemmista on myös kolmen lainausmerkin moniriviset muodot. Tuntemattomasta poistomerkinnästä tai päättämättömästä merkkijonosta ilmoitetaan sen sijainti.
Hyväksytäänkö erittäin suuret kokonaisluvut?
Kyllä. Enintään TOML-spesifikaation 64-bittisen rajan suuruiset kokonaisluvut, kuten 9223372036854775807, hyväksytään. Tätä suuremmat kokonaisluvut, etunollat ja alaviivat, jotka eivät ole numeroiden välissä, ovat virheitä.
Aiheuttaako tavujärjestysmerkki tai Windows-rivinvaihto ongelmia?
Ei. Alussa oleva UTF-8-tavujärjestysmerkki ohitetaan, ja sekä LF- että CRLF-rivinvaihdot hyväksytään. Merkkijonojen sisällä olevat ohjausmerkit, joita ei ole suojattu poistomerkinnällä, ilmoitetaan virheinä.
Tarkistaako se avainten merkityksen, kuten Cargo tai Poetry?
Ei. Validaattori tarkistaa vain TOML-syntaksin ja rakenteen. Tiedosto voi olla kelvollista TOML-muotoa ja silti sisältää avaimen, jota Cargo tai Pythonin koontitaustaosa ei ymmärrä. Käytä työkalua syntaksivirheiden poissulkemiseen ennen työkalukohtaisten asetusten tutkimista.
Kuinka suuri syöte voi olla, ja voinko muuntaa sen?
Syötteen koko voi olla enintään 5 MiB, ja sisäkkäisten taulukoiden ja upotettujen taulukoiden syvyys enintään 64 tasoa. Jos haluat muuntaa kelvollisen TOML-tiedoston muotoon JSON, YAML tai johonkin muuhun muotoon, käytä Data Format Converteria.