TOML-ellenőrző
Ellenőrizze a TOML-fájlokat, például a Cargo.toml-t, a pyproject.toml-t, a Hugo- vagy a Netlify-beállításokat, mielőtt ezek miatt meghiúsulna a build. Az ellenőrző a bemenetet a TOML specifikációja szerint dolgozza fel, és az első hibát annak sor- és oszlopszámával, valamint a feldolgozó magyarázatával együtt jelzi. Ilyen hiba lehet például a duplikált kulcs, az újradefiniált tábla vagy a lehetetlen dátum. Az érvényes fájloknál megjelenik a táblák és kulcsok száma, valamint a legfelső szintű kulcsok listája, így egy pillantással ellenőrizheti a struktúrát.
Gyakran ismételt kérdések
Mit ellenőriz a TOML-ellenőrző?
Pontosan a TOML specifikációjában meghatározott módon dolgozza fel a kulcsokat, karakterláncokat, számokat, logikai értékeket, dátumokat és időpontokat, tömböket, beágyazott táblákat, táblákat és táblák tömbjeit. Minden eltérést, például a hiányzó értéket, az idézőjelek közé nem tett karakterláncot vagy a hibás escape-szekvenciát hibaként jelez. Az érvényes fájlok rövid összefoglalót kapnak a struktúrájukról.
Milyen információkat tartalmaz egy hiba?
Minden hiba megmutatja azt a sort és oszlopot, ahol a feldolgozás megállt, valamint a feldolgozó részletes üzenetét, például érvénytelen dátumot vagy már definiált tábla, illetve érték újbóli definiálásának kísérletét. A sorok és oszlopok számozása 1-től kezdődik. Csak az első hiba jelenik meg, mivel a későbbi hibák gyakran ebből következnek.
Miért jelzi újradefiniáltnak a kulcsot vagy a táblát?
A TOML nem engedi ugyanazt a kulcsot kétszer egy táblában, és egy táblafejléc, például a [server], csak egyszer szerepelhet. A pontozott kulcs, például a server.port definiálása azután is újradefiniálásnak számít, ha egy [server] tábla már beállította a port értékét. A javításhoz vonja össze a bejegyzéseket egy helyen.
Hogyan számolja a táblákat és a kulcsokat?
A táblák száma a gyökérelem alatti összes táblát tartalmazza, a beágyazott táblákat és a táblák tömbjeinek minden egyes elemét is. A kulcsok száma minden olyan kulcsot tartalmaz, amelynek értéke nem tábla vagy táblák tömbje; így egy karakterláncokat tartalmazó lista egy kulcsnak számít. A legfelső szintű kulcsok legfeljebb 50 nevét sorolja fel.
Ellenőrzi a dátumokat és időpontokat?
Igen. Ellenőrzi az eltolást tartalmazó dátum-idő értékeket, a helyi dátum-idő értékeket, a helyi dátumokat és a helyi időpontokat is, beleértve az olyan lehetetlen értékeket, mint a 13. hónap vagy a 25. óra. A más formátumban megadott dátum — például 05/27/1979 — nem TOML-dátum, ezért karakterláncként kell idézőjelek közé tenni.
Milyen karakterláncok és escape-szekvenciák engedélyezettek?
A dupla idézőjelek közé tett alapkarakterláncokban használhatók az olyan escape-szekvenciák, mint a \n, \t, \" és \uXXXX, az egyszeres idézőjelek közé tett szó szerinti karakterláncok pedig minden karaktert úgy vesznek át, ahogy le van írva. Mindkettőnek van három idézőjelet használó többsoros formája. Az ismeretlen escape-szekvenciát vagy a le nem zárt karakterláncot a rendszer a pozíciójával együtt jelzi.
Elfogadja a nagyon nagy egész számokat?
Igen. A TOML specifikációjának 64 bites határáig terjedő egész számokat, például a 9223372036854775807-t, elfogadja. Az ezen a tartományon kívüli egész számok, a kezdő nullák és a számjegyek közé nem kerülő aláhúzásjelek hibát jelentenek.
Gondot okoz a bájtsorrendjel vagy a Windows-s soremelés?
Nem. A bemenet elején álló UTF-8 bájtsorrendjelet a rendszer figyelmen kívül hagyja, és az LF, valamint a CRLF soremelést is elfogadja. A karakterláncokban szereplő, escape-szekvenciával nem helyettesített vezérlőkaraktereket hibaként jelzi.
Ellenőrzi a kulcsok jelentését, ahogyan a Cargo vagy a Poetry tenné?
Nem, az ellenőrző csak a TOML szintaxisát és struktúráját ellenőrzi. Egy fájl lehet érvényes TOML, miközben olyan kulcsot tartalmaz, amelyet a Cargo vagy egy Python build-háttérprogram nem értelmez. Ezzel az eszközzel kizárhatja a szintaktikai hibákat, mielőtt a konkrét eszközök beállításait vizsgálná.
Mekkora lehet a bemenet, és átalakíthatom?
A bemenet legfeljebb 5 MiB lehet, a beágyazott tömbök és inline táblák pedig legfeljebb 64 szint mélyek lehetnek. Az érvényes TOML JSON, YAML vagy más formátummá alakításához használja az Adatformátum-konvertert.