ממיר YAML ו-JSON

מה זה YAML?

YAML (YAML Ain't Markup Language) הוא פורמט סריאליזציה של נתונים שתוכנן להיות קריא לבני אדם. הוא משמש בעיקר לקבצי קונפיגורציה — Kubernetes, Docker Compose, GitHub Actions, Ansible ועוד. במקום סוגריים וסימני פיסוק (כמו ב-JSON) YAML משתמש בהזחות כדי לייצג היררכיה.

מתי להמיר בין הפורמטים?

• YAML נוח לבני אדם לכתוב, JSON נוח ל-APIs לקרוא
• בדיבוג: אם קובץ YAML לא עובד, המרה ל-JSON מראה מהר מה הפרסר באמת מבין
• שליחה ל-API שמקבל JSON בלבד (רוב ה-APIs) מתוך קונפיג YAML קיים
• לימוד: רואים מיד איך אותו מבנה נראה בשני הפורמטים

הבדלים עיקריים

הערות

YAML תומך ב-# comments. JSON לא תומך בהערות. אם יש הערות ב-YAML המקורי, הן יאבדו בהמרה ל-JSON.

מפתחות כמחרוזות

ב-JSON כל מפתח חייב מרכאות: "name": "value". ב-YAML: name: value. היתרון ב-JSON: חד-משמעות. היתרון ב-YAML: קריאות.

Multi-document

YAML תומך בקובץ אחד עם מספר מסמכים, מופרדים ב----. JSON לא. הכלי מטפל רק במסמך הראשון.

מלכודות נפוצות ב-YAML

• טאבים לעומת רווחים — YAML אוסר טאבים להזחה. חייבים רווחים. זו השגיאה הנפוצה ביותר.
• הערך "no" — no (וגם yes, on, off) מתפרש כ-boolean. לכתוב מחרוזת? להשתמש במרכאות: "no".
• מפתחות עם נקודותיים — אם המפתח מכיל :, עוטפים במרכאות.
• נעילת גרסה בעיתית — version: 3.9 מתפרש כמספר. אם רוצים מחרוזת (כמו בגרסת Docker Compose): version: "3.9".

פרטיות

ההמרה מתבצעת בדפדפן עם ספריית js-yaml. הקובץ שלך לא נשלח לשום שרת ולא נשמר. מתאים גם ל-Kubernetes secrets ומידע רגיש אחר.