Διαμόρφωση TOML (.toml)

TOML Τυπικό

Η μορφή Tom's Obvious Minimal Language (TOML) είναι μια σαφής, ανθρωποκεντρική μορφή ρυθμίσεων που δημιουργήθηκε από τον συνιδryτή του GitHub, Tom Preston-Werner, και έχει υιοθετηθεί ευρέως στα σύγχρονα οικοσυστήματα προγραμματισμού, συμπεριλαμβανομένων των Rust (Cargo) και Python (pyproject.toml).

Εφευρέτης: Tom Preston-Werner (GitHub co-founder)Έτος: 2013MIME: application/toml

Μετατροπή TOML σε JSON

Δωρεάν μετατροπέας από TOML σε JSON εντός του προγράμματος περιήγησης. Μετατρέψτε αρχεία άμεσα στη συσκευή σας.

Μετατροπέας από TOML σε JSON →

Επιθεώρηση & Μεταδεδομένα

Τα λειτουργικά συστήματα και τα εργαλεία ανάλυσης αρχείων αναγνωρίζουν τα αρχεία TOML ελέγχοντας την αρχική δυαδική ακολουθία byte:

Επιλέξτε ή αποθέστε αρχεία εδώ

100% ιδιωτική μετατροπή εντός προγράμματος περιήγησης - τα αρχεία δεν φεύγουν ποτέ από τη συσκευή σας

ή επικόλληση Ctrl+V

Εγγύηση Απορρήτου Μηδενικής Μετάδοσης Δικτύου: 0 byte μεταφορτώθηκαν σε εξωτερικούς διακομιστές. Όλη η επεξεργασία πραγματοποιήθηκε τοπικά στο sandbox του προγράμματος περιήγησής σας.

Υπογραφή κεφαλίδας σε επίπεδο byte (Magic Bytes)

ΔΕΚΑΕΞΑΔΙΚΗ ΥΠΟΓΡΑΦΗ (OFFSET 0):

5B ... 5D

ΑΝΑΠΑΡΑΣΤΑΣΗ ASCII: [...]

Τυποποίηση: TOML v1.0.0 Specification

Τεχνικές Προδιαγραφές

Αρχιτεκτονική Περιέκτη	Human-readable configuration file mapping unequivocally to a hash table, structured with [tables] and key = value pairs
Συμπίεση	Uncompressed text stream
Endianness Byte	UTF-8 text stream
Χρωματικοί Χώροι	N/A (Configuration File)
Κανάλια & Δομή	Tables, arrays of tables, inline tables, strings, integers, floats, booleans, and RFC 3339 datetimes
Μέγιστες Διαστάσεις	Unbounded text length
Διαφάνεια	None
Streaming & Προοδευτική Φόρτωση	Sequential line-by-line configuration parsing

Τεχνικός Πίνακας Σύγκρισης: TOML έναντι Ανταγωνιστών

Τεχνικό χαρακτηριστικό	TOML (Τρέχον)	YAML	JSON	INI
Κίνδυνος Αμφισημίας	Μηδενικός (αυστηρά σαφής προδιαγραφή)	Υψηλός (σφάλματα booleans λόγω του 'προβλήματος της Νορβηγίας' στην YAML)	Μηδενικός (αυστηροί τύποι δεδομένων)	Μέτριος (χωρίς επίσημο πρότυπο)
Εγγενείς Τύποι Ημερομηνίας/Ώρας	Εγγενής υποστήριξη ημερομηνίας & ώρας RFC 3339	Ανάλυση ως συμβολοσειρά / ημερομηνία	Κανένας (μόνο συμβολοσειρές)	Κανένας (μόνο συμβολοσειρές)
Υποστήριξη Σχολίων	Εγγενής (σχόλια #)	Εγγενής (σχόλια #)	Δεν επιτρέπονται σχόλια	Εγγενής (σχόλια ; και #)
Κύριο Οικοσύστημα	Rust (Cargo), Python (PEP 518), Go	Kubernetes, Ansible, αγωγοί CI/CD	Web APIs, επικοινωνία προγράμματος περιήγησης	Παλαιά Windows, ρυθμίσεις Git

Συνηθισμένοι Τρόποι Διαφθοράς & Οδηγός Ανάκτησης Hex

Σφάλμα ανάλυσης (Parser error): 'Duplicate key in table' ή 'Invalid table header'.

Βασική Αιτία: Προσπάθεια επαναπροσδιορισμού ενός υπάρχοντος κλειδιού ή χώρου ονομάτων πίνακα εντός του εγγράφου.

Ανάκτηση: Επικυρώστε και μορφοποιήστε εκ νέου τη σύνταξη TOML χρησιμοποιώντας το File2File TOML Formatter.

Ανάλυση Ασφάλειας & Διανύσματα Επίθεσης Parser

Οι αναλυτές TOML πρέπει να προστατεύονται από τη μόλυνση πρωτοτύπων (prototype pollution) και την εξάντληση της CPU από παθολογική ένθεση πινάκων.

Γνωστά διανύσματα επίθεσης

Μόλυνση πρωτοτύπων σε αναλυτές TOML της JavaScript που εισάγουν ιδιότητες στο Object.prototype.
Άρνηση εξυπηρέτησης (DoS) μέσω βαθιά ένθετων δηλώσεων πινάκων.
Απεριορισμένη κατανομή μνήμης κατά την ανάλυση τεράστιων ενσωματωμένων πινάκων (inline arrays).

Βέλτιστες αμυντικές πρακτικές:

Ιστορική Αναδρομή & Ορόσημα

2021Κυκλοφορεί επίσημα το TOML v1.0.0, παγώνοντας την προδιαγραφή της βασικής σύνταξης.

2018Η Python καθιερώνει το 'pyproject.toml' (PEP 518) ως το σύγχρονο πρότυπο διαμόρφωσης δόμησης.

2013Ο Tom Preston-Werner δημοσιεύει το TOML για να προσφέρει μια καθαρή μορφή ρυθμίσεων χωρίς την πολυπλοκότητα της YAML.

Κύρια Πλεονεκτήματα

Εντελώς αlingότepη και σαφής: αντιστοιχίζεται καθαρά και προβλέψιμα σε πίνακα κατακερματισμού (hash table) χωρίς εκπλήξεις στη μετατροπή τύπων.
Πρώτης τάξεως εγγενής υποστήριξη ημερομηνίας-ώρας (χρονικές σημάνσεις RFC 3339, ημερομηνίες, ώρες) χωρίς διαφυγή χαρακτήρων (escaping).
Υιοθετήθηκε ως η επίσημη τυπική μορφή ρυθμίσεων για σύγχρονα εργαλεία γλωσσών (Rust Cargo.toml, Python pyproject.toml).

Τεχνικοί Περιορισμοί & Μειονεκτήματα

Τα βαθιά ένθετα δέντρα αντικειμένων πολλαπλών επιπέδων μπορούν να γίνουν πολυσέλιδα και περίπλοκα σε σύγκριση με την YAML.
Η σύνταξη για πίνακες πινάκων ([[table.array]]) μπορεί να μην είναι διαισθητική για αρχάριους.
Λιγότερο συμπαγές από την JSON για ανταλλαγή δεδομένων API υψηλής απόδοσης μεταξύ μηχανών.

Ενδιαφέροντα Τεχνικά Στοιχεία

Το TOML δημιουργήθηκε από τον Tom Preston-Werner, ο οποίος επίσης συνίδρυσε το GitHub και δημιούργησε τα Gravatar και SemVer (Semantic Versioning).
Το αρχείο 'Cargo.toml' σε κάθε έργο Rust καθορίζει όλες τις εξαρτήσεις πακέτων και τις σημαίες μεταγλωttιστή σε μορφή TOML.
Σε αντίθεση με την JSON, το TOML υποστηρίζει εγγενώς σχόλια (χρησιμοποιώντας τον χαρακτήρα '#') και συμβολοσειρές πολλαπλών γραμμών.

Συχνές Τεχνικές Ερωτήσεις

Σε τι χρησιμεύει το TOML;

Το TOML χρησιμοποιείται για τη διαμόρφωση λογισμικού, κυρίως στο Cargo.toml της Rust, στο pyproject.toml της Python, στις ρυθμίσεις του Go Hugo και σε εργαλεία container.

Γιατί το TOML προτιμάται έναντι του YAML για τη διαμόρφωση;

Το TOML αποφεύγει τα διαβόητα σφάλματα ανάλυσης οριακών περιπτώσεων του YAML (όπως το 'NO' χωρίς εισαγωγικά να μετατρέπεται σε boolean false), παραμένοντας φιλικό προς τον άνθρωπο με σχόλια και σαφείς πίνακες.

Πώς μπορώ να μετατρέψω TOML σε JSON ή YAML;

Μπορείτε να μετατρέψετε αρχεία TOML σε JSON ή YAML στιγμιαία χρησιμοποιώντας το File2File.app απευθείας στον web browser σας.

Σχετικά ζεύγη μετατροπής TOML

TOML σε JSON

Η μετατροπή αρχείων διαμόρφωσης TOML σε μορφή JSON μεταφράζει φιλικές προς τον άνθρωπο ρυθμίσεις ιδιοτήτων σε ένα αυστηρό αντικείμενο δεδομένων που οι διαδικτυακές εφαρμογές μπορούν να αναλύσουν άμεσα.

JSON σε TOML

Η μετατροπή αρχείων διαμόρφωσης JSON σε μορφή TOML απλοποιεί την ανθρώπινη επεξεργασία διατηρώντας παράλληλα όλες τις δομημένες ιεραρχίες δεδομένων κEιδίου-τιμής.