ตัวแปลง YAML เป็น JSON

YAML แมปเป็น JSON อย่างไร

JSON เป็นสับเซตของ YAML 1.2 ดังนั้น mapping ของ YAML ทุกตัวจะกลายเป็น JSON object ทุก sequence กลายเป็น array และ scalar กลายเป็นสตริง ตัวเลข boolean หรือ null ฟีเจอร์ที่มีเฉพาะใน YAML จะถูกแปลงระหว่างการแปลง:

• คอมเมนต์ (# …) ถูกตัดออก เพราะ JSON ไม่มีคอมเมนต์
• Anchor และ alias (&base, *base, <<: *base) ถูกขยายเป็นสำเนาเต็ม
• Timestamp เช่น 2024-01-02 กลายเป็นสตริง ISO 8601
• สตริงหลายบรรทัด (บล็อก literal | และบล็อก folded >) กลายเป็นสตริงธรรมดาที่มี escape \n

YAML หลายเอกสาร

ไฟล์เดียวมีเอกสาร YAML ได้หลายชุดคั่นด้วย --- ซึ่งพบบ่อยใน Kubernetes manifest JSON ไม่มีสิ่งเทียบเท่า ตัวแปลงจึงส่งคืน JSON array ที่มีหนึ่งสมาชิกต่อหนึ่งเอกสาร และแจ้งในแถบสถานะ --- ตัวเดียวที่อยู่ท้ายไฟล์จะถูกข้าม

ข้อควรระวังระหว่าง YAML 1.1 กับ 1.2

ตัวแปลงนี้ทำตาม YAML 1.2 ซึ่งเป็นสเปกปัจจุบัน เครื่องมือเก่าหลายตัว (PyYAML, Psych ของ Ruby, Kubernetes และ Ansible บางเวอร์ชัน) ยังอ่านแบบ YAML 1.1 ซึ่งมีกฎต่างกัน:

• ปัญหานอร์เวย์: ใน YAML 1.1 country: no หมายถึง false รหัสประเทศของนอร์เวย์ NO จึงหายไป เช่นเดียวกับ yes, on, off, y และ n ส่วน YAML 1.2 ถือว่าเฉพาะ true และ false เป็น boolean
• เลขฐานแปด: 0755 เป็นเลขฐานแปดใน 1.1 แต่เป็นเลขฐานสิบธรรมดาใน 1.2 ซึ่งใช้ 0o755 ควรใส่อัญประกาศให้ file mode เพื่อความปลอดภัย
• เลขฐานหกสิบ: ใน 1.1 22:30 อาจถูกพาร์สเป็นตัวเลข 1350 ควรใส่อัญประกาศให้เวลาและการแมป port เช่น "8080:80"

ทิศทาง JSON → YAML จะใส่อัญประกาศให้สตริงที่กำกวม ('no', 'on', 'y') อัตโนมัติ YAML ที่สร้างขึ้นจึงอ่านได้เหมือนกันทั้งสองเวอร์ชัน