המרת TOML ל-JSON
המרת קובצי הגדרות בפורמט TOML לפורמט JSON מתרגמת הגדרות מאפיינים ידידותיות למשתמש לאובייקט נתונים קפדני שיישומי אינטרנט יכולים לנתח באופן מיידי.
השוואת פורמטים ומפרטים טכניים
| מפרט | TOML | JSON |
|---|---|---|
| סוג MIME | application/ | application/ |
| סוג | קובץ תצורה מינימלי | אובייקט נתונים מובנה |
| דחיסה | ללא (טקסט UTF-8) | ללא (זרם טקסט) |
| מפרט תקני | TOML v1.0.0 Specification | IETF RFC 8259 / ECMA-404 |
| כותרת ביתים קסומים (Magic Bytes) | [section] key = "value" | 7B (\{) or 5B (\[) JSON root delimiter |
סקירת פורמטים ושימושים
TOML ו-JSON משמשים שניהם לאחסון הגדרות, אך הם משרתים חלקים שונים של פרויקט תוכנה. מפתחים כותבים לעיתים קרובות קובצי הגדרות ב-TOML מפני שהוא תומך בהערות ומרגיש טבעי להקשה ידנית. עם זאת, דפדפני אינטרנט וספריות תכנות רבות מעדיפים JSON מכיוון שהוא משמש כסטנדרט אוניברסלי להחלפת נתונים. כאשר כלי בנייה או צינור פריסה צריך לקרוא הגדרות מקומיות, המרת TOML ל-JSON מגשרת על הפער. לדוגמה, מחוללי אתרים סטטיים מודרניים מקבלים לעיתים קרובות קלטים מסוג TOML להעדפות משתמש, אך דורשים פלטים מסוג JSON כדי להזין נתונים לממשקי JavaScript קדמיים. שינוי מבנה הקובץ מאפשר לסקריפטים אוטומטיים לצרוך ערכי הגדרות ללא צורך במנתח TOML ייעודי.
מפרטים טכניים וסקירת מקודדים
השם TOML ראשי תיבות של Tom's Obvious, Minimal Language, והוא מזוהה על ידי טיפוס ה-MIME application/toml. הוא משתמש בטקסט UTF-8 פשוט עם צמדי מפתח-ערך, מקטעים וסוגי תאריכים מקומיים. השם JSON ראשי תיבות של JavaScript Object Notation, והוא מזוהה על ידי טיפוס ה-MIME application/json. אף פורמט אינו משתמש בדחיסה כברירת מחדל, כלומר שניהם זרמי טקסט גולמיים. לא TOML ולא JSON מסתמכים על כותרות בייטים קסומים. במקום זאת, הם תלויים בסמנים מבניים, כגון סוגריים מסולסלים ב-JSON או כותרות מוקפות בסוגריים מרובעים ב-TOML, כדי לסמן את הפורמט שלהם למנתחים. תהליך התרגום קורא את היררכיית המפתח-ערך של TOML וממפה אותה ישירות לאובייקטים ומערכים תקניים של JSON.
תאימות למערכות הפעלה ודפדפנים
TOML ו-JSON הם פורמטים של טקסט, אך התמיכה משתנה. דפדפנים מנתחים JSON באמצעות JavaScript, ו-TOML דורש מנתח.
מידע שימושי
זכור ש-TOML תומך בהערות באמצעות סולם הסולמית (#), בעוד ש-JSON הסטנדרטי אינו תומך בהערות כלל. כל הערה שנמצאת בקובץ המקור מסוג TOML תוסר במהלך ההמרה ל-JSON.
שאלות נפוצות
כיצד להמיר הגדרות TOML להגדרות JSON מבלי לאבד איכות?
המרה זו היא ללא אובדן נתונים עבור מפתחות וערכים מפני ששני הפורמטים מייצגים נתוני הגדרות מבוססי טקסט. לא מתבצעת דחיסת נתונים, כך שכל המפתחות, המחרוזות, המספרים והערכים הבוליאניים עוברים ישירות למבנה החדש מבלי לצמצם את הדיוק.
מה ההבדל בין הגדרות TOML להגדרות JSON?
TOML מיועד לקריאה אנושית וכולל תכונות כמו תמיכה בהערות וטיפוסי תאריכים מקומיים. JSON מיועד לניתוח מכונה ותעבורת אינטרנט, תוך שימוש במבנה קפדני של סוגריים מסולסלים מקוננים ומפתחות המוקפים במרכאות כפולות מבלי לאפשר הוספת הערות.