TOML sang JSON

Chuyển đổi TOML sang JSON là gì?

TOML (Tom's Obvious Minimal Language) là định dạng tệp cấu hình được thiết kế cho con người. Nó ánh xạ rõ ràng sang bảng băm, hỗ trợ bảng lồng nhau, giá trị có kiểu dữ liệu và chú thích nội tuyến. Nhiều công cụ và framework sử dụng TOML làm định dạng cấu hình chính: các dự án Rust dựa vào Cargo.toml, Python packaging dùng pyproject.toml, và các trang tĩnh Hugo cấu hình qua config.toml. Chuyển đổi TOML sang JSON trực tuyến cho phép bạn biến đổi các tệp cấu hình này sang định dạng mà hầu hết mọi ngôn ngữ lập trình, API và data pipeline đều có thể xử lý trực tiếp.

JSON (JavaScript Object Notation), được định nghĩa bởi RFC 8259, là định dạng trao đổi dữ liệu được hỗ trợ rộng rãi nhất. Trong khi TOML ưu tiên khả năng đọc của con người với cú pháp tối giản và hỗ trợ chú thích, JSON ưu tiên khả năng tương tác giữa các máy. Công cụ chuyển đổi TOML sang JSON thu hẹp khoảng cách này bằng cách phân tích cú pháp đầu vào TOML theo đặc tả TOML v1.0.0 và tạo ra tài liệu JSON tương đương về mặt cấu trúc. Quá trình chuyển đổi giữ nguyên toàn bộ dữ liệu: chuỗi, số nguyên, số thực, boolean, mảng và bảng đều ánh xạ trực tiếp sang các kiểu tương ứng trong JSON.

TOML có bốn kiểu ngày/giờ gốc mà JSON không thể biểu diễn trực tiếp: offset date-time, local date-time, local date và local time. JSON không có kiểu ngày, vì vậy các giá trị này được tuần tự hóa thành chuỗi ISO 8601 trong quá trình chuyển đổi.

Tại sao nên dùng công cụ chuyển đổi TOML sang JSON?

Các tệp cấu hình viết bằng TOML thường cần được đưa vào các hệ thống chỉ chấp nhận JSON. Thay vì viết lại tệp thủ công hoặc cài đặt thư viện parser cục bộ, công cụ chuyển đổi trên trình duyệt xử lý việc này chỉ trong vài giây.

Các trường hợp sử dụng TOML sang JSON

Tham chiếu ánh xạ kiểu dữ liệu TOML sang JSON

Mỗi kiểu TOML đều có một kiểu JSON tương đương trực tiếp, với một ngoại lệ: giá trị ngày và giờ. Bảng dưới đây cho thấy cách mỗi kiểu TOML chuyển đổi sang JSON. Ánh xạ này tuân theo đặc tả TOML v1.0.0 và khớp với hành vi của các parser tiêu chuẩn như tomllib (Python), toml-rs (Rust) và @iarna/toml (Node.js).

Số nguyên TOML hỗ trợ dấu gạch dưới để dễ đọc (ví dụ: 1_000_000) và các ký tự hexadecimal (0xDEADBEEF), octal (0o755) và binary (0b11010110). Tất cả những giá trị này được chuyển đổi thành số thập phân thông thường trong JSON. TOML cũng hỗ trợ giá trị float infinity và NaN, nhưng những giá trị này không có biểu diễn trong JSON và sẽ gây ra lỗi chuyển đổi ở chế độ strict.

Ví dụ mã nguồn

Các ví dụ thực tế về chuyển đổi TOML sang JSON bằng bốn ngôn ngữ. Mỗi ví dụ đọc tệp TOML, phân tích cú pháp và xuất JSON được định dạng.

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

Câu hỏi thường gặp