TOML إلى JSON

ما هو تحويل TOML إلى JSON؟

TOML (Tom's Obvious Minimal Language) هي صيغة ملفات إعداد مصمّمة للبشر. تُربط بوضوح تام بجدول hash، وتدعم الجداول المتداخلة والقيم ذات الأنواع والتعليقات المضمّنة. تستخدم كثير من الأدوات والأطر TOML بوصفها صيغة الإعداد الرئيسية: تعتمد مشاريع Rust على Cargo.toml، وتعبئة Python على pyproject.toml، والمواقع الثابتة في Hugo على config.toml. يتيح تحويل TOML إلى JSON أونلاين تحويل ملفات الإعداد هذه إلى صيغة تستطيع تقريباً كل لغة برمجة وواجهة API وخط بيانات استهلاكها بشكل مباشر.

JSON (JavaScript Object Notation)، المُعرَّف في 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 قيم عشرية من نوع اللانهاية وNaN، لكن لا يوجد لها تمثيل في JSON وستُسبّب خطأ في التحويل في الوضع الصارم.

أمثلة برمجية

أمثلة عملية لتحويل 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

الأسئلة الشائعة