تبدیل JSON به TOML

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

تبدیل JSON به TOML، داده‌ها را از فرمت JavaScript Object Notation به زبان Tom's Obvious Minimal Language منتقل می‌کند. JSON از آکولاد، براکت و کلیدهای نقل‌قول‌دار برای نمایش داده‌های ساختاریافته استفاده می‌کند. TOML از نحو ساده کلید-مقدار با سرفصل‌های بخش (به نام جدول) استفاده می‌کند که شبیه فایل INI است اما با تعیین نوع دقیق. TOML به‌طور خاص برای فایل‌های پیکربندی طراحی شده که خوانایی انسانی در آن‌ها از تبادل ماشینی مهم‌تر است.

TOML به فرمت پیکربندی پیش‌فرض برای Rust (Cargo.toml)، بسته‌بندی Python (pyproject.toml)، سایت‌های استاتیک Hugo، تنظیمات استقرار Netlify و بسیاری از ابزارهای CLI تبدیل شده است. وقتی داده منبع شما به شکل JSON وجود دارد — از یک پاسخ API، یک پیکربندی صادرشده، یا یک فایل تولیدشده — و سیستم مقصد TOML انتظار دارد، به مبدلی نیاز دارید که آبجکت‌های JSON را به جداول TOML، آرایه‌های JSON را به آرایه‌های TOML تبدیل کند و هر نوع داده را با دقت حفظ کند.

تبدیل آنلاین JSON به TOML سریع‌ترین راه برای تولید TOML معتبر از داده‌های موجود JSON است. تبدیل نوع داده به‌طور خودکار انجام می‌شود: رشته‌های JSON به رشته‌های TOML، اعداد JSON به اعداد صحیح یا اعشاری TOML، مقادیر بولی مستقیماً تبدیل می‌شوند، و آبجکت‌های JSON به جداول TOML تبدیل می‌شوند. تنها استثنا null است — TOML نوع null ندارد، بنابراین مقادیر null یا حذف می‌شوند یا بسته به مبدل به رشته خالی تبدیل می‌شوند.

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

سیستم‌های مقصد فایل‌های پیکربندی TOML انتظار دارند؛ APIها و ابزارها JSON تولید می‌کنند. این مبدل شکاف بین دو فرمت را پر می‌کند تا بدون بازنویسی دستی بتوانید داده را جابه‌جا کنید.

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

مقایسه JSON و TOML

JSON و TOML از نظر قابلیت با هم همپوشانی دارند اما در نحو، پشتیبانی از انواع داده و هدف مورد نظر تفاوت دارند. این جدول تفاوت‌هایی که بر تبدیل تأثیر می‌گذارند را نشان می‌دهد.

نکات مهم در تبدیل TOML

TOML قوانینی دارد که با JSON تفاوت دارند و بر خروجی تبدیل تأثیر می‌گذارند. این چهار مورد بیشترین سردرگمی را ایجاد می‌کنند.

نمونه کد

تبدیل JSON به TOML به‌صورت برنامه‌ای در بیشتر زبان‌ها به یک کتابخانه سریال‌سازی TOML نیاز دارد. کتابخانه‌های استاندارد JSON را تجزیه می‌کنند؛ خروجی TOML به یک بسته اختصاصی نیاز دارد.

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

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