TOML เป็น JSON

การแปลง TOML เป็น JSON คืออะไร?

TOML (Tom's Obvious Minimal Language) คือรูปแบบไฟล์ config ที่ออกแบบมาสำหรับมนุษย์ มันแมปอย่างชัดเจนกับ hash table รองรับ table ซ้อนกัน value ที่มีประเภทกำกับ และ comment แบบ inline เครื่องมือและ framework หลายตัวใช้ TOML เป็นรูปแบบ config หลัก: โปรเจกต์ Rust ใช้ Cargo.toml, Python packaging ใช้ pyproject.toml และ static site Hugo ตั้งค่าผ่าน config.toml การแปลง TOML เป็น JSON ออนไลน์ช่วยให้คุณแปลงไฟล์ config เหล่านี้เป็นรูปแบบที่แทบทุกภาษาโปรแกรมมิ่ง API และ data pipeline สามารถอ่านได้โดยตรง

JSON (JavaScript Object Notation) ซึ่งกำหนดโดย RFC 8259 คือรูปแบบการแลกเปลี่ยนข้อมูลที่ได้รับการรองรับอย่างแพร่หลายที่สุด แม้ TOML จะให้ความสำคัญกับความสามารถในการอ่านของมนุษย์ด้วยไวยากรณ์ที่กระชับและการรองรับ comment แต่ JSON ให้ความสำคัญกับความสามารถในการทำงานร่วมกับเครื่อง เครื่องมือแปลง TOML เป็น JSON เชื่อมช่องว่างนี้โดย parse ข้อมูล TOML ตาม TOML v1.0.0 specification และสร้าง JSON document ที่มีโครงสร้างเทียบเท่า การแปลงรักษาข้อมูลทั้งหมด: string, integer, float, boolean, array และ table แมปตรงกับ JSON counterpart

TOML มีประเภทวันที่และเวลาในตัวสี่ประเภทที่ JSON ไม่สามารถแสดงได้โดยตรง: offset date-time, local date-time, local date และ local time JSON ไม่มีประเภทวันที่ ดังนั้น value เหล่านี้จะถูก serialize เป็น ISO 8601 string ระหว่างการแปลง

ทำไมต้องใช้เครื่องมือแปลง TOML เป็น JSON?

ไฟล์ config ที่เขียนด้วย TOML มักต้องส่งข้อมูลไปยังระบบที่รับเฉพาะ JSON แทนที่จะเขียนไฟล์ใหม่ด้วยมือหรือติดตั้ง parser library ในเครื่อง เครื่องมือบนเบราว์เซอร์จัดการการแปลงนี้ได้ภายในไม่กี่วินาที

กรณีการใช้งาน TOML เป็น JSON

ตารางอ้างอิงการแมปประเภทข้อมูล TOML เป็น JSON

ทุกประเภทใน TOML มี JSON ที่เทียบเท่าโดยตรง ยกเว้นหนึ่งประเภท: value วันที่และเวลา ตารางด้านล่างแสดงวิธีที่ประเภท TOML แต่ละประเภทแปลงเป็น JSON การแมปนี้เป็นไปตาม TOML v1.0.0 specification และตรงกับพฤติกรรมของ parser มาตรฐาน เช่น tomllib (Python), toml-rs (Rust) และ @iarna/toml (Node.js)

TOML integer รองรับ underscore เพื่อความอ่านง่าย (เช่น 1_000_000) และตัวเลขฐาน hexadecimal (0xDEADBEEF), octal (0o755) และ binary (0b11010110) ทั้งหมดนี้แปลงเป็นตัวเลขฐานสิบธรรมดาใน JSON TOML ยังรองรับ infinity และ NaN สำหรับ float แต่ไม่มีการแสดงใน JSON และจะทำให้เกิดข้อผิดพลาดในการแปลงเมื่อใช้ strict mode

ตัวอย่าง Code

ตัวอย่างการทำงานของการแปลง TOML เป็น JSON ในสี่ภาษา แต่ละตัวอย่างอ่านไฟล์ TOML, parse และแสดงผล JSON ที่จัดรูปแบบแล้ว

import { parse } from '@iarna/toml'
import fs from 'fs'

const toml = fs.readFileSync('config.toml', 'utf8')
const json = parse(toml)
console.log(JSON.stringify(json, null, 2))
// Input:  [server]
//         host = "localhost"
//         port = 8080
// Output: { "server": { "host": "localhost", "port": 8080 } }

import tomllib   # Python 3.11+ (standard library)
import json

with open('config.toml', 'rb') as f:
    data = tomllib.load(f)

print(json.dumps(data, indent=2, default=str))
# Dates become strings: "1979-05-27"
# Arrays of tables become JSON arrays of objects

package main

import (
    "encoding/json"
    "fmt"
    "os"

    "github.com/BurntSushi/toml"
)

func main() {
    var data map[string]any
    _, err := toml.DecodeFile("config.toml", &data)
    if err != nil {
        panic(err)
    }
    out, _ := json.MarshalIndent(data, "", "  ")
    fmt.Println(string(out))
}

# Using yj (YAML/JSON/TOML converter)
cat config.toml | yj -tj

# Using dasel
dasel -f config.toml -r toml -w json

# Using Python one-liner (3.11+)
python3 -c "import tomllib, json, sys; print(json.dumps(tomllib.load(sys.stdin.buffer), indent=2, default=str))" < config.toml

คำถามที่พบบ่อย