TOML به JSON

تبدیل TOML به JSON چیست؟

TOML (زبان حداقلی آشکار تام) یک فرمت فایل پیکربندی است که برای انسان‌ها طراحی شده. این فرمت به‌صورت یک‌به‌یک به جدول هش نگاشت می‌شود، از جداول تودرتو، مقادیر تایپ‌شده و توضیحات درون‌خطی پشتیبانی می‌کند. بسیاری از ابزارها و فریمورک‌ها از TOML به‌عنوان فرمت پیکربندی اصلی استفاده می‌کنند: پروژه‌های Rust به Cargo.toml متکی هستند، بسته‌بندی Python از pyproject.toml استفاده می‌کند و سایت‌های استاتیک Hugo از طریق config.toml پیکربندی می‌شوند. تبدیل آنلاین TOML به JSON به شما امکان می‌دهد این فایل‌های پیکربندی را به فرمتی تبدیل کنید که تقریباً هر زبان برنامه‌نویسی، API و خط لوله داده می‌تواند به‌صورت بومی مصرف کند.

JSON (نشانه‌گذاری شیء جاوااسکریپت) که توسط RFC 8259 تعریف شده، پرکاربردترین فرمت تبادل داده است. در حالی که TOML با نحو حداقلی و پشتیبانی از توضیحات، خوانایی انسانی را در اولویت قرار می‌دهد، JSON قابلیت پردازش توسط ماشین را اولویت می‌دهد. یک مبدل TOML به JSON این شکاف را با تجزیه ورودی TOML طبق مشخصات TOML v1.0.0 و تولید یک سند JSON معادل ساختاری پر می‌کند. تبدیل تمام داده‌ها را حفظ می‌کند: رشته‌ها، اعداد صحیح، اعداد اعشاری، مقادیر بولی، آرایه‌ها و جداول مستقیماً به معادل‌های JSON خود نگاشت می‌شوند.

TOML چهار نوع تاریخ/زمان بومی دارد که JSON نمی‌تواند مستقیماً آن‌ها را نمایش دهد: تاریخ-زمان با آفست، تاریخ-زمان محلی، تاریخ محلی و زمان محلی. JSON نوع تاریخ ندارد، بنابراین این مقادیر در طول تبدیل به‌عنوان رشته‌های ISO 8601 سریال‌سازی می‌شوند.

چرا از مبدل TOML به JSON استفاده کنیم؟

فایل‌های پیکربندی نوشته‌شده در TOML اغلب باید به سیستم‌هایی تغذیه شوند که فقط JSON می‌پذیرند. به‌جای بازنویسی دستی فایل یا نصب کتابخانه تجزیه‌کننده به‌صورت محلی، یک مبدل مبتنی بر مرورگر این تبدیل را در چند ثانیه انجام می‌دهد.

موارد استفاده از تبدیل TOML به JSON

مرجع نگاشت نوع TOML به JSON

هر نوع TOML معادل مستقیمی در JSON دارد، با یک استثنا: مقادیر تاریخ و زمان. جدول زیر نشان می‌دهد که هر نوع TOML چگونه به JSON تبدیل می‌شود. این نگاشت از مشخصات TOML v1.0.0 پیروی می‌کند و با رفتار تجزیه‌کننده‌های استاندارد مانند tomllib (Python)، toml-rs (Rust) و @iarna/toml (Node.js) مطابقت دارد.

اعداد صحیح TOML از زیرخط برای خوانایی پشتیبانی می‌کنند (مثلاً 1_000_000) و لیترال‌های هگزادسیمال (0xDEADBEEF)، اکتال (0o755) و باینری (0b11010110). همه این‌ها به اعداد اعشاری ساده در JSON تبدیل می‌شوند. TOML همچنین از مقادیر float بی‌نهایت و NaN پشتیبانی می‌کند، اما این‌ها هیچ نمایشی در JSON ندارند و در حالت strict باعث خطای تبدیل می‌شوند.

مثال‌های کد

مثال‌های کاربردی تبدیل TOML به JSON در چهار زبان. هر کدام یک فایل TOML را می‌خواند، تجزیه می‌کند و 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

سوالات متداول