تحويل JSON إلى TOML

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

تحويل JSON إلى TOML يُحوّل البيانات من تدوين كائنات JavaScript إلى لغة TOML (Tom's Obvious Minimal Language). يستخدم JSON الأقواس المعقوصة والمربعة والمفاتيح بين علامات اقتباس لتمثيل البيانات المهيكلة. أما TOML فيعتمد صيغة زوج مفتاح-قيمة مسطحة مع ترويسات الأقسام (تُسمى الجداول)، تُشبه في قراءتها ملفات INI لكن مع كتابة صارمة للأنواع. صُمّم TOML خصيصاً لملفات الإعداد حيث تُقدَّم القراءة البشرية على التبادل الآلي.

أصبح TOML صيغة الإعداد الافتراضية في Rust (Cargo.toml) وتعبئة Python (pyproject.toml) ومولدات المواقع الثابتة كـ Hugo وإعدادات نشر Netlify وكثير من أدوات سطر الأوامر. حين تكون بياناتك المصدر بصيغة JSON — من استجابة API أو إعداد مُصدَّر أو ملف مُولَّد — ويتوقع نظامك الهدف TOML، فأنت بحاجة إلى محوّل يَربط كائنات JSON بجداول TOML، ومصفوفات JSON بمصفوفات TOML، مع الحفاظ على كل نوع بيانات بدقة.

تحويل JSON إلى TOML عبر الإنترنت هو أسرع طريقة لإنشاء TOML صالح من بيانات JSON موجودة. يتولى التحويل ربط الأنواع تلقائياً: تصبح سلاسل JSON سلاسل TOML، وتصبح أرقام JSON أعداداً صحيحة أو عشرية في TOML، وتُربط القيم المنطقية مباشرة، وتصبح كائنات JSON جداول TOML. الاستثناء الوحيد هو القيمة null — إذ لا يوجد في TOML نوع null، لذا تُحذف قيم null أو تُحوَّل إلى سلاسل فارغة بحسب المحوّل.

لماذا تستخدم هذا المحوّل؟

TOML هو ما تتوقعه ملفات الإعداد؛ و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

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