Μετατροπέας JSON σε YAML

Πώς να χρησιμοποιήσετε τον μετατροπέα JSON σε YAML

1. Επιλέξτε την κατεύθυνση: JSON → YAML ή YAML → JSON.
2. Επικολλήστε τα δεδομένα σας ή πατήστε Άνοιγμα αρχείου για να φορτώσετε ένα αρχείο .json, .yaml ή .yml (έως 10 MB).
3. Επιλέξτε την Εσοχή (2 ή 4 κενά) και, αν θέλετε, την Ταξινόμηση κλειδιών αλφαβητικά.
4. Πατήστε Μετατροπή ή απλώς συνεχίστε να πληκτρολογείτε: το αποτέλεσμα ενημερώνεται αυτόματα. Αν η είσοδος δεν είναι έγκυρη, το μήνυμα σφάλματος δίνει τη γραμμή και τη στήλη του προβλήματος.
5. Αντιγράψτε ή κατεβάστε το αποτέλεσμα. Το Αντιστροφή κατεύθυνσης στέλνει την έξοδο πίσω στην είσοδο για να τη μετατρέψετε προς την άλλη κατεύθυνση.

JSON και YAML: ίδια δεδομένα, διαφορετική σύνταξη

Το YAML είναι στην πράξη υπερσύνολο του JSON: κάθε έγγραφο JSON περιγράφει δεδομένα που το YAML μπορεί να εκφράσει, και το YAML προσθέτει μια ελαφρύτερη σύνταξη που είναι ευκολότερη για τον άνθρωπο στην ανάγνωση και την επεξεργασία. Γι’ αυτό τα μανιφέστα του Kubernetes, τα αρχεία Docker Compose, οι ροές GitHub Actions και GitLab CI, τα playbooks του Ansible και οι προδιαγραφές OpenAPI γράφονται συνήθως σε YAML, ενώ τα API και τα προγράμματα ανταλλάσσουν JSON.

Τα ίδια δεδομένα και στις δύο μορφές:

{"name": "web", "ports": [80, 443], "env": {"DEBUG": false}}

name: web
ports:
  - 80
  - 443
env:
  DEBUG: false

JSON → YAML

Ο μετατροπέας γράφει YAML τύπου μπλοκ: ένα κλειδί ανά γραμμή, λίστες με παύλες και εμφωλευμένα αντικείμενα με εσοχές. Οι μεγάλες συμβολοσειρές δεν διπλώνονται ποτέ και οι συμβολοσειρές πολλών γραμμών χρησιμοποιούν το κυριολεκτικό στυλ | ώστε οι αλλαγές γραμμής να διατηρούνται ακριβώς. Οι συμβολοσειρές που το YAML θα διάβαζε αλλιώς ως άλλον τύπο μπαίνουν σε εισαγωγικά: τα "yes", "1.0" ή "null" μένουν συμβολοσειρές μετά από αμφίδρομη μετατροπή. Η Ταξινόμηση κλειδιών ταξινομεί αλφαβητικά τα κλειδιά κάθε αντικειμένου, κάτι που κάνει πιο εύκολη τη σύγκριση δύο αρχείων ρυθμίσεων.

YAML → JSON

Το YAML διαβάζεται με το βασικό σχήμα του YAML 1.2, τους ίδιους κανόνες που χρησιμοποιούν τα περισσότερα σύγχρονα εργαλεία:

• Τα true/false, οι αριθμοί και το null (ή ~) γίνονται τιμές JSON· τα yes, no, on και off μένουν συμβολοσειρές, όπως απαιτεί η προδιαγραφή YAML 1.2.
• Τα anchors και aliases (&base, *base) αναπτύσσονται και τα merge keys (<<: *base), συνηθισμένα σε αρχεία CI, υποστηρίζονται.
• Ένα αρχείο με πολλά έγγραφα χωρισμένα με --- γίνεται πίνακας JSON με ένα στοιχείο ανά έγγραφο και ένα μήνυμα σας λέει πόσα συνδυάστηκαν.
• Τα σχόλια απορρίπτονται, αφού το JSON δεν έχει σχόλια.
• Τα .inf και .nan δεν έχουν ισοδύναμο στο JSON· γράφονται ως οι συμβολοσειρές "Infinity" και "NaN".

Για να προστατευτεί το πρόγραμμα περιήγησής σας από αρχεία «billion laughs», όπου λίγα aliases επεκτείνονται σε δισεκατομμύρια τιμές, ένα έγγραφο που επεκτείνεται σε περισσότερες από ένα εκατομμύριο τιμές απορρίπτεται.

Συνηθισμένα λάθη στο YAML

• Tab για εσοχή: το YAML επιτρέπει μόνο κενά.
• Ασυνεπείς εσοχές: τα στοιχεία της ίδιας λίστας ή του ίδιου αντικειμένου πρέπει να ξεκινούν στην ίδια στήλη.
• Έλλειψη κενού μετά την άνω και κάτω τελεία: το key:value είναι μία μόνο συμβολοσειρά, ενώ το key: value είναι ζεύγος κλειδιού-τιμής.
• Ειδικοί χαρακτήρες χωρίς εισαγωγικά: μια τιμή που ξεκινά με @, backtick, *, & ή !, ή που περιέχει : ή #, πρέπει να μπαίνει σε εισαγωγικά.