YAML ถึง JSON

ตัวอย่างการแปลง

YAML:

defaults: &defaults
  timeout: 30
  retries: 3

production:
  <<: *defaults
  host: prod.example.com
  debug: false

staging:
  <<: *defaults
  host: staging.example.com
  debug: true

JSON (แองเคอร์ถูกแก้ไขแล้ว):

{
  "defaults": {
    "timeout": 30,
    "retries": 3
  },
  "production": {
    "timeout": 30,
    "retries": 3,
    "host": "prod.example.com",
    "debug": false
  },
  "staging": {
    "timeout": 30,
    "retries": 3,
    "host": "staging.example.com",
    "debug": true
  }
}

การจับคู่ประเภท

สิ่งต่าง ๆ ที่เฉพาะสำหรับ YAML ซึ่ง JSON ไม่สามารถแสดงได้

• คำอธิบาย: JSON ไม่มีรูปแบบการเขียนคำอธิบายที่เป็นมาตรฐาน ดังนั้นคำอธิบายจะถูกละเว้นไป
• ลำดับข้อมูลหลายเอกสาร (ใช้เครื่องหมายแบ่ง ---) โดยในรูปแบบ JSON จะมีเอกสารหนึ่งฉบับต่อไฟล์ แต่เมื่อมีหลายเอกสาร โปรแกรมแปลงจะสร้างอาร์เรย์ของเอกสารเหล่านั้นขึ้นมา
• แองเคอร์และชื่อสมมติ ได้รับการแก้ไขและทำซ้ำภายในบรรทัดเดียวกัน
• กุญแจแบบซับซ้อน (กุญแจที่ไม่ใช่สตริง): กุญแจใน JSON ต้องเป็นสตริง ส่วนกุญแจแบบซับซ้อนจะถูกแปลงให้เป็นสตริง

ข้อบกพร่องระหว่างเวอร์ชัน 1.1 กับ 1.2

• YAML 1.1 จะวิเคราะห์ข้อมูลในรูปแบบ yes, no, on, off, y และ n เป็นค่าบูลีน ส่วน NO จะถูกแปลงเป็นรหัสประเทศโดยอัตโนมัติเป็น false โดยไม่มีการแจ้งเตือนใดๆ
• YAML 1.2 จำกัดการใช้ข้อมูลประเภท boolean เฉพาะในรูปแบบ true และ false เท่านั้น ซึ่งปลอดภัยกว่า แต่ parser หลายตัว (รวมถึง PyYAML โดยค่าเริ่มต้น) ยังคงใช้มาตรฐาน YAML 1.1 อยู่

ตัวแปลงจะใช้ความหมายแบบ 1.2 เป็นค่าเริ่มต้น และจะแจ้งเตือนเมื่อการใช้ความหมายแบบ 1.1 จะทำให้ผลลัพธ์เปลี่ยนไป

การแปลงไป-กลับจาก JSON กลับเป็น YAML

การแปลงข้อมูลจาก JSON เป็น YAML มักเป็นการแปลงแบบไม่สูญเสียข้อมูล (เนื่องจาก JSON เป็นส่วนหนึ่งของไวยากรณ์ YAML เวอร์ชัน 1.2) ในขณะที่การแปลงจาก YAML เป็น JSON จะมีการสูญเสียข้อมูลบางส่วน เช่น คำอธิบายและโครงสร้างของ merge-key หากคุณวางแผนจะดำเนินการแปลงข้อมูลไป-กลับ ควรเก็บไฟล์ YAML เดิมไว้ในระบบควบคุมเวอร์ชัน