בלוג

המרת YAML ל־JSON ובדיקת הרחבת ההגדרות המשותפות

המירו בדפדפן YAML עם זמן המתנה ומספר ניסיונות משותפים ל־JSON, בדקו ערכים שהתקבלו בירושה ונדרסו, ואז ערכו JSON והחזירו אותו ל־YAML. כולל הטיפול בהערות ובעוגנים.

הממשק האנגלי של ממיר YAML ⇄ JSON מציג YAML המפנה להגדרות משותפות לצד JSON עם הערכים לאחר הרחבה

נגדיר זמן המתנה משותף של 30 שניות ושני ניסיונות חוזרים, אבל בסביבת התצוגה המקדימה נגדיר אפס ניסיונות. YAML מאפשר להפנות להגדרות משותפות, אך ככל שהתצורה מתארכת קשה יותר לעקוב אחר המקור של כל ערך. ממיר YAML ⇄ JSON מאפשר להמיר ל־JSON ולבדוק את התוצאה לאחר הרחבת ההפניות.

הרחבת הגדרות YAML משותפות בתוך JSON

הדביקו את הדוגמה הבאה בשדה „YAML” משמאל. לשימוש בקובץ, בחרו באפשרות טעינת קובץ YAML, הנקראת „Load YAML file” בממשק האנגלי. &defaults נותן שם להגדרות המשותפות, ו־<<: *defaults ממזג אותן לתוך preview.

# Shared request settings
defaults: &defaults
  timeoutSeconds: 30
  retries: 2
preview:
  <<: *defaults
  retries: 0

לחצו על „YAML → JSON”. התוצאה תופיע בשדה „JSON” מימין. preview.timeoutSeconds יורש את הערך 30 מההגדרות המשותפות, ואילו ההגדרה המפורשת של preview.retries מקבלת עדיפות ולכן ערכו 0. defaults.retries נשאר 2.

ב־YAML משמאל preview מפנה להגדרות משותפות; ב־JSON מימין מופיעים בתוך preview הערכים המורחבים timeoutSeconds 30 ו־retries 0
דוגמה מהממשק האנגלי. אפשר לבדוק את הערכים הסופיים של preview בצד ימין.

עריכת JSON והמרה חזרה ל־YAML

  1. בשדה JSON מימין, שנו בתוך preview את "timeoutSeconds": 30 ל־"timeoutSeconds": 10. השאירו את הערך ב־defaults כ־30.
  2. לחצו על כפתור האימות מימין, שבממשק האנגלי נקרא „Validate: JSON → YAML → JSON”. YAML חדש יופיע משמאל ותוצאת האימות תוצג מתחת לשדות. ודאו ש־preview.timeoutSeconds משמאל הוא 10.
  3. כדי לשמור את תוצאת ההמרה בקובץ, העתיקו את תוכן השדה הדרוש לעורך טקסט ושמרו אותו.
JSON שבו זמן ההמתנה של preview שונה ל־10 שניות, ה־YAML שהתקבל והודעת אימות מוצלח
אימות שמתחיל ב־JSON קורא שוב את ה־YAML שהתקבל ומשווה מבני נתונים וערכים, בלי להתחשב בסדר המפתחות.

כאשר צריך לשמור על הערות או טיפוסי נתונים

JSON אינו מכיל את ההערות או את שמות העוגנים של ה־YAML המקורי. בכלי זה, לחיצה על „JSON → YAML” באותו עמוד עשויה להחזיר את הטקסט המקורי שנשמר, אם נתוני ה־JSON שקולים ל־YAML המקורי. כאשר עורכים ערך כמו בדוגמה זו, נוצר YAML חדש מהנתונים המורחבים. כדי לשנות רק את זמן ההמתנה ולהשאיר את ההערות וההפניות המשותפות, הוסיפו timeoutSeconds: 10 אל preview ב־YAML המקורי.

האימות שמתחיל ב־YAML, „Validate: YAML → JSON → YAML”, מפיק JSON ושומר את טקסט ה־YAML המקורי. לדוגמה, גם אם אימות limit: .nan מדווח על הצלחה, ב־JSON מתקבל "limit": null. בעת העברת הגדרות שבהן טיפוסי הנתונים חשובים, בדקו גם את הערכים שהומרו באופן ישיר.