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

ตัวอย่าง

ข้อมูลที่ป้อนเข้ามา:

{
  "project": { "name": "hyperion", "version": "1.0.0" },
  "dependencies": { "django": "4.2", "redis": "^5.0" },
  "servers": [
    { "host": "h1.example.com", "port": 443 },
    { "host": "h2.example.com", "port": 443 }
  ]
}

ผลลัพธ์:

[project]
name = "hyperion"
version = "1.0.0"

[dependencies]
django = "4.2"
redis = "^5.0"

[[servers]]
host = "h1.example.com"
port = 443

[[servers]]
host = "h2.example.com"
port = 443

การจับคู่รูปแบบ

ข้อกำหนดเฉพาะสำหรับ TOML

• ตารางต้องไม่ขัดแย้งกัน: คีย์ไม่สามารถเป็นทั้งค่าและหัวตารางในเอกสารเดียวกันได้
• ชุดตารางใช้วงเล็บคู่: [[servers]] หมายถึง “เริ่มต้นองค์ประกอบใหม่ของชุดข้อมูล servers”
• คีย์แบบจุด ช่วยให้คุณเขียน project.author.name = "..." ได้โดยไม่ต้องสร้างหัวตาราง
• ความคิดเห็นจะเริ่มต้นด้วย # และประกอบด้วยเพียงบรรทัดเท่านั้น

การจัดการข้อมูลที่เป็นศูนย์

TOML ไม่มี null ตัวเลือก:

• ไม่ระบุคีย์, เป็นวิธีที่ตรงกับความหมายมากที่สุด โดยที่ “ไม่มีค่า” มีความหมายเท่ากับ “null”
• แทนที่ด้วยสตริงว่าง, เหมาะสม หากสตริงว่างไม่ใช่ค่าที่ถูกต้องเลย
• ใช้ค่าตัวชี้วัด (sentinel value) เช่น "__null__" หรือค่าที่คล้ายกัน โดยให้โค้ดของคุณเป็นผู้ตีความ

ตัวแปลงจะกำหนดค่าโดยอัตโนมัติให้ไม่รวมคีย์ที่เป็น null และจะแจ้งเตือนเมื่อมีการดำเนินการดังกล่าว

ข้อผิดพลาดที่พบบ่อย

• อาร์เรย์ JSON ระดับสูงสุด: [1, 2, 3] ที่อยู่ที่รากของ JSON จะไม่สามารถแปลงเป็นเอกสาร TOML ที่ถูกต้องได้ ควรห่อข้อมูลนี้ไว้ในออบเจกต์ เช่น { "items": [1, 2, 3] }
• การผสมหัวข้อในตารางโดยใช้การกำหนดค่าแบบอินไลน์ เมื่อคุณเขียนค่า [project] แล้ว คีย์ทุกตัวถัดไปในส่วนนั้นจะถูกจัดอยู่ภายใต้ project จนกระทั่งพบหัวข้อถัดไป
• คีย์ที่มีตัวอักษรพิเศษ: "api-key" ถือว่าถูกต้อง (เมื่อใช้เครื่องหมายอัญประกาศ) แต่ api-key หากไม่มีเครื่องหมายอัญประกาศ จะถือเป็นข้อผิดพลาดในการวิเคราะห์โค้ด TOML
• โดยสมมติว่าลำดับข้อมูลยังคงถูกรักษาไว้ โปรแกรมแปลง TOML โดยทั่วไปสามารถรักษาลำดับของส่วนหัว (header) ภายในตารางได้ แต่ลำดับของคีย์ภายในตารางไม่ได้รับการรับประกันในทุกการนำไปใช้งาน