TOML tikrintuvas
Prieš surinkimo klaidą patikrinkite TOML failus, pavyzdžiui, Cargo.toml, pyproject.toml arba Hugo ir Netlify nustatymus. Validatorius analizuoja įvestį pagal TOML specifikaciją ir pateikia pirmąją klaidą kartu su eilute, stulpeliu ir analizatoriaus paaiškinimu, įskaitant pasikartojančius raktus, iš naujo apibrėžtas lenteles ir negaliojančias datas. Galiojančiuose failuose rodomas lentelių ir raktų skaičius bei aukščiausio lygio raktai, kad galėtumėte iškart peržvelgti struktūrą.
Dažnai užduodami klausimai
Ką tikrina TOML tikrintuvas?
Jis analizuoja raktus, eilutes, skaičius, logines reikšmes, datas ir laiką, masyvus, įterptines lenteles, lenteles ir lentelių masyvus tiksliai taip, kaip apibrėžta TOML specifikacijoje. Bet koks nukrypimas, pavyzdžiui, trūkstama reikšmė, eilutė be kabučių ar netinkama kaitos seka, nurodomas kaip klaida. Galiojantiems failams pateikiama trumpa jų struktūros santrauka.
Kokios informacijos pateikiama apie klaidą?
Prie kiekvienos klaidos nurodoma eilutė ir stulpelis, kuriuose analizė sustojo, taip pat analizatoriaus pateikta išsami informacija, pavyzdžiui, netinkama data arba bandymas iš naujo apibrėžti jau apibrėžtą lentelę ar reikšmę. Eilutės ir stulpeliai pradedami skaičiuoti nuo 1. Rodoma tik pirmoji klaida, nes vėlesnės dažnai kyla dėl jos.
Kodėl nurodoma, kad raktas arba lentelė apibrėžti pakartotinai?
TOML neleidžia toje pačioje lentelėje du kartus naudoti to paties rakto, o tokia lentelės antraštė kaip [server] gali būti pateikta tik vieną kartą. Taip pat laikoma pakartotiniu apibrėžimu, jei taškinis raktas, pavyzdžiui, server.port, apibrėžiamas po [server] lentele, kurioje jau nustatytas port. Norėdami tai ištaisyti, sujunkite įrašus vienoje vietoje.
Kaip skaičiuojamos lentelės ir raktai?
Lentelių skaičius apima kiekvieną lentelę po šaknine, įskaitant įterptines lenteles ir kiekvieną lentelių masyvo įrašą. Raktų skaičius apima kiekvieną raktą, kurio reikšmė nėra lentelė arba lentelių masyvas, todėl eilučių sąrašas laikomas vienu raktu. Aukščiausio lygio raktų sąraše pateikiami šaknyje esantys pavadinimai – iki 50.
Ar tikrinamos datos ir laikas?
Taip. Tikrinamos datos ir laikai su laiko juostos poslinkiu, vietinės datos ir laikai bei vietinės datos ir vietinis laikas, įskaitant neįmanomas reikšmes, tokias kaip 13 mėnuo arba 25 valanda. Kitu formatu, pavyzdžiui, 05/27/1979, įrašyta data nėra TOML data, todėl ją reikia pateikti kabutėse kaip eilutę.
Kokios eilutės ir kaitos sekos leidžiamos?
Paprastose eilutėse su dvigubomis kabutėmis leidžiamos kaitos sekos, tokios kaip \n, \t, \" ir \uXXXX, o pažodinėse eilutėse su viengubomis kabutėmis visi simboliai laikomi tokie, kokie įrašyti. Abiejų tipų eilutės gali būti kelių eilučių ir apibrėžtos trimis kabutėmis. Nežinoma kaitos seka arba neužbaigta eilutė nurodoma kartu su jos vieta.
Ar priimami labai dideli sveikieji skaičiai?
Taip. Priimami sveikieji skaičiai iki TOML specifikacijos 64 bitų ribos, pavyzdžiui, 9223372036854775807. Už šios ribos esantys skaičiai, nuliai pradžioje ir pabraukimo ženklai, esantys ne tarp skaitmenų, laikomi klaidomis.
Ar problemų kelia baitų tvarkos žymė arba Windows eilučių pabaigos?
Ne. Pradžioje esanti UTF-8 baitų tvarkos žymė ignoruojama, o LF ir CRLF eilučių pabaigos priimamos. Neekranuoti valdymo simboliai eilutėse nurodomi kaip klaidos.
Ar tikrinama raktų reikšmė taip, kaip tai darytų Cargo arba Poetry?
Ne, validatorius tikrina tik TOML sintaksę ir struktūrą. Failas gali būti galiojantis TOML, bet jame vis tiek gali būti raktas, kurio nesupranta Cargo arba Python surinkimo posistemė. Naudokite įrankį sintaksės problemoms atmesti prieš tikrindami konkrečių įrankių nustatymus.
Kokio dydžio gali būti įvestis ir ar galiu ją konvertuoti?
Įvesties duomenys gali būti iki 5 MiB, o įdėtiniai masyvai ir tiesioginės lentelės – iki 64 lygių gylio. Norėdami galiojantį TOML paversti į JSON, YAML ar kitą formatą, naudokite duomenų formato keitiklį.