รูปแบบ TOML — คู่มือไฟล์ตั้งค่า

TOML เป็นรูปแบบไฟล์ตั้งค่าที่ออกแบบเพื่อความชัดเจนและเรียบง่าย แมปกับตารางแฮชอย่างชัดเจนและง่ายต่อการอ่านและเขียนสำหรับมนุษย์ TOML เป็นรูปแบบมาตรฐานสำหรับ Cargo.toml ของ Rust และ pyproject.toml ของ Python

ประเภท MIME

application/toml

ประเภท

ข้อความ

การบีบอัด

ไม่สูญเสียคุณภาพ

ข้อดี

+ Unambiguous — no implicit type coercion unlike YAML
+ Native datetime support without quoting
+ Simple, flat structure that maps directly to hash tables
+ Standard in Rust and Python ecosystems

ข้อเสีย

− Deeply nested data structures become verbose
− Less widespread tool support compared to JSON and YAML
− No standard way to represent null values

เมื่อใดควรใช้ .TOML

ใช้ TOML สำหรับไฟล์ตั้งค่า โดยเฉพาะในระบบนิเวศ Rust (Cargo.toml) และ Python (pyproject.toml) เหมาะเมื่อต้องการการแยกวิเคราะห์ที่ชัดเจน

รายละเอียดทางเทคนิค

TOML ใช้คู่คีย์-ค่า ตาราง (ส่วนในวงเล็บ) อาร์เรย์ของตาราง (วงเล็บคู่) และค่าที่มีชนิดพื้นฐาน ได้แก่ datetime จำนวนเต็ม จำนวนทศนิยม boolean และสตริง การย่อหน้าไม่มีความหมาย

ประวัติ

Tom Preston-Werner (ผู้ร่วมก่อตั้ง GitHub) สร้าง TOML ในปี 2013 เป็นทางเลือกที่เรียบง่ายแทน YAML และ JSON สำหรับไฟล์ตั้งค่า TOML 1.0 เปิดตัวในเดือนมกราคม 2021 หลังจากได้รับข้อเสนอแนะจากชุมชนอย่างกว้างขวาง