แปลง JSON เป็น TOML

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

การแปลง JSON เป็น TOML คือการเปลี่ยนรูปแบบข้อมูลจาก JavaScript Object Notation ไปเป็น Tom's Obvious Minimal Language JSON ใช้วงเล็บปีกกา วงเล็บเหลี่ยม และ key ที่มีเครื่องหมายคำพูดเพื่อแสดงข้อมูลแบบมีโครงสร้าง ส่วน TOML ใช้ไวยากรณ์แบบ key-value ที่เรียบง่ายพร้อม section header (เรียกว่า table) ซึ่งอ่านคล้ายไฟล์ INI แต่มีการกำหนดประเภทข้อมูลที่เข้มงวด TOML ถูกออกแบบมาเพื่อไฟล์ config โดยเฉพาะ โดยให้ความสำคัญกับความสามารถในการอ่านของมนุษย์มากกว่าการแลกเปลี่ยนข้อมูลระหว่างเครื่อง

TOML ได้กลายเป็นรูปแบบ config มาตรฐานสำหรับ Rust (Cargo.toml), Python packaging (pyproject.toml), Hugo static sites, การตั้งค่า Netlify และเครื่องมือ CLI อีกหลายตัว เมื่อข้อมูลต้นทางอยู่ในรูป JSON — จาก API response, ไฟล์ config ที่ export ออกมา หรือไฟล์ที่สร้างขึ้นโดยอัตโนมัติ — และระบบปลายทางคาดหวัง TOML คุณต้องการตัวแปลงที่แมป JSON object เป็น TOML table, JSON array เป็น TOML array และรักษาประเภทข้อมูลทุกอย่างอย่างถูกต้อง

การแปลง JSON เป็น TOML ออนไลน์เป็นวิธีที่เร็วที่สุดในการสร้าง TOML ที่ถูกต้องจากข้อมูล JSON ที่มีอยู่ การแปลงจัดการการแมปประเภทข้อมูลโดยอัตโนมัติ: string ใน JSON กลายเป็น string ใน TOML, ตัวเลขใน JSON กลายเป็น integer หรือ float ใน TOML, boolean แมปตรงกัน และ object ใน JSON กลายเป็น TOML table ข้อยกเว้นคือ null — TOML ไม่มีประเภท null ดังนั้น null value จะถูกละเว้นหรือแปลงเป็น string ว่างขึ้นอยู่กับตัวแปลงที่ใช้

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

TOML คือสิ่งที่ไฟล์ config ต้องการ ส่วน JSON คือสิ่งที่ API และเครื่องมือต่างๆ สร้างออกมา เครื่องมือนี้เชื่อมช่องว่างระหว่างสองรูปแบบ เพื่อให้คุณย้ายข้อมูลโดยไม่ต้องเขียนใหม่ด้วยมือ

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

การเปรียบเทียบ JSON กับ TOML

JSON และ TOML มีความสามารถที่ทับซ้อนกันแต่แตกต่างกันในด้านไวยากรณ์ การรองรับประเภทข้อมูล และการใช้งานที่ตั้งใจไว้ ตารางนี้แสดงความแตกต่างที่ส่งผลต่อผลลัพธ์การแปลง

ข้อควรระวังในการแปลง TOML

TOML มีกฎที่แตกต่างจาก JSON ในแบบที่ส่งผลต่อผลลัพธ์การแปลง สี่ปัญหาต่อไปนี้เป็นสาเหตุของความสับสนมากที่สุด

ตัวอย่าง Code

การแปลง JSON เป็น TOML ด้วยโปรแกรมต้องใช้ library สำหรับ TOML ในภาษาส่วนใหญ่ library มาตรฐานสามารถ parse JSON ได้ แต่สำหรับ TOML output ต้องใช้ package เฉพาะทาง

import { stringify } from '@iarna/toml'

const json = '{"title":"My App","database":{"host":"localhost","port":5432}}'
const obj = JSON.parse(json)
const toml = stringify(obj)
console.log(toml)
// → title = "My App"
// →
// → [database]
// → host = "localhost"
// → port = 5432

import json
import tomli_w  # pip install tomli_w

json_str = '{"title": "My App", "database": {"host": "localhost", "port": 5432}}'
data = json.loads(json_str)
toml_str = tomli_w.dumps(data)
print(toml_str)
# → title = "My App"
# →
# → [database]
# → host = "localhost"
# → port = 5432

package main

import (
    "encoding/json"
    "fmt"
    "github.com/pelletier/go-toml/v2"
)

func main() {
    jsonStr := `{"title":"My App","database":{"host":"localhost","port":5432}}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    tomlBytes, _ := toml.Marshal(data)
    fmt.Println(string(tomlBytes))
    // → title = 'My App'
    // →
    // → [database]
    // → host = 'localhost'
    // → port = 5432
}

# Using yj (https://github.com/sclevine/yj)
echo '{"title":"My App","port":3000}' | yj -jt
# → title = "My App"
# → port = 3000

# Using remarshal (pip install remarshal)
echo '{"title":"My App","port":3000}' | remarshal -if json -of toml
# → title = "My App"
# → port = 3000

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