لا تحب الإعلانات؟ يذهب خالية من الإعلانات اليوم 

محول JSON إلى TOML

الخلفيةبياناتمطورJSONيامل

حوّل JSON إلى TOML بسرعة وسهولة. تُحوّل هذه الأداة كائنات JSON إلى صيغة TOML سهلة القراءة، وهي مثالية لملفات التكوين في مشاريع Rust وPython وGo.

إعلان · يزيل؟

مدخل

عملية تلقائية

انتاج

جانب العميل

إعلان · يزيل؟

مرشد

جدول المحتويات

حوّل بيانات JSON إلى صيغة TOML باستخدام هذا المحول البسيط من JSON إلى TOML. تُسهّل هذه الأداة يتحول تم تنظيم مستندات JSON إلى TOML (لغة توم الواضحة والبسيطة)، وهو تنسيق ملف تكوين أكثر سهولة في القراءة بالنسبة للبشر.

ما هو TOML؟

تومل (لغة توم الواضحة والبسيطة) هي تنسيق ملف تكوين مصمم ليسهل على البشر قراءته وكتابته مع الحفاظ على سهولة تحليله للتطبيقات. ابتكر توم بريستون-فيرنر (المؤسس المشارك لـ GitHub) عام ٢٠١٣، وقد اكتسب شعبية واسعة كبديل لتنسيقات مثل JSON وYAML وINI.

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

يوفر تحويل JSON إلى TOML العديد من المزايا:

إعلان · يزيل؟

تحسين قابلية القراءة لملفات التكوين
تمثيل التسلسل الهرمي الواضح باستخدام تدوين النقاط
دعم التعليقات، وهو ما يفتقر إليه JSON
دعم أصلي للتواريخ والأوقات
سلاسل متعددة الأسطر بدون تسلسلات إفلات

الاختلافات الرئيسية بين JSON و TOML

ميزة	JSON	تومل
بناء الجملة	الأقواس والأقواس	أزواج القيمة الرئيسية مع الأقسام
تعليقات	غير مدعوم	مدعوم (# لتعليقات السطر)
التواريخ/الأوقات	مخزنة كسلاسل	تنسيق التاريخ والوقت الأصلي
الهياكل المتداخلة	يستخدم الكائنات المتداخلة	يستخدم تدوين النقاط
المصفوفات	[ ] تدوين	[ ] تدوين (مشابه لـ JSON)
سلاسل متعددة الأسطر	يتطلب أحرف الهروب	علامات اقتباس ثلاثية (""" """)

كيف تستعمل

أدخل بيانات JSON الخاصة بك أو الصقها في مربع الإدخال
قم بمراجعة TOML المحول في منطقة الإخراج
انسخ مخرجات TOML باستخدام زر النسخ

التطبيقات الشائعة لـ TOML

لقد أصبح TOML مستخدمًا على نطاق واسع في العديد من مشاريع وبيئات البرمجيات:

الصدأ مدير حزمة البضائع - يستخدم TOML لتكوين المشروع
يذهب نظام الوحدات – يستخدم TOML لملفات go.mod
بايثون المشاريع - يستخدم في pyproject.toml لتكوين الحزمة
تكوينات التطبيق - الاستخدام المتزايد في التطبيقات المختلفة
تكوينات النشر - للبيئات الحاوية والسحابية

أمثلة على بناء جملة TOML

فيما يلي كيفية تمثيل هياكل JSON الشائعة في TOML:

أزواج القيمة الأساسية

JSON:

{
  "name": "John Doe",
  "age": 30,
  "is_admin": true
}

تومل:

name = "John Doe"
age = 30
is_admin = true

الكائنات المتداخلة

JSON:

{
  "database": {
    "host": "localhost",
    "port": 5432,
    "username": "user"
  }
}

تومل:

[database]
host = "localhost"
port = 5432
username = "user"

المصفوفات

JSON:

{
  "colors": ["red", "green", "blue"]
}

تومل:

colors = ["red", "green", "blue"]

فوائد هذا المحول

الهجرة السهلة - الانتقال من JSON إلى TOML دون إعادة الكتابة يدويًا
يحافظ على بنية البيانات - يحافظ على العلاقات الهرمية
يتعامل مع JSON المعقد - تحويل الكائنات المتداخلة والمصفوفات بشكل صحيح
المعالجة المستندة إلى المتصفح - لا يتم إرسال أي بيانات إلى الخوادم، مما يحافظ على خصوصية بياناتك

القيود

على الرغم من أن هذا المحول يتعامل بشكل جيد مع معظم التحويلات من JSON إلى TOML، إلا أن هناك بعض القيود التي يجب الانتباه إليها:

قد تؤدي ملفات JSON كبيرة الحجم إلى إبطاء أداء المتصفح
قد تتطلب بعض الهياكل المتداخلة المعقدة مراجعة يدوية
سيؤدي إدخال JSON غير صالح إلى حدوث أخطاء في التحويل

 التعليمات

ما هو الفرق بين JSON و TOML؟

يستخدم JSON الأقواس والأقواس المعقوفة لهيكلة البيانات، بينما يستخدم TOML أزواجًا من المفاتيح والقيم مع عناوين الأقسام. يوفر TOML دعمًا أصليًا للتعليقات، والتواريخ/الأوقات، والسلاسل النصية متعددة الأسطر بدون أحرف إفلات، مما يجعله أسهل قراءةً من قِبل المستخدم. يتميز JSON بأنه أكثر إحكامًا، ولكنه يفتقر إلى هذه الميزات، مما يجعل TOML أفضل لملفات التكوين التي تُعد سهولة القراءة فيها أمرًا بالغ الأهمية.
كيف أقوم بتحويل الكائنات المتداخلة المعقدة من JSON إلى TOML؟

يتعامل مُحوّل JSON إلى TOML الخاص بنا تلقائيًا مع الهياكل المُتداخلة المُعقدة. ما عليك سوى لصق ملف JSON المُتداخل، ثم النقر على "تحويل"، وستُحوّله الأداة باستخدام صيغة TOML القسمية ([section]) وصيغة النقاط للخصائص المُتداخلة. بالنسبة للكائنات المُتداخلة بعمق، يستخدم TOML تسلسلًا هرميًا مثل [parent.child.grandchild] للحفاظ على بنية العلاقة.
لماذا أستخدم TOML بدلاً من JSON للتكوين؟

صُممت لغة TOML خصيصًا لملفات التكوين، حيث تتميز بسهولة قراءة أفضل، ودعمًا للتعليقات، وهيكلية أوضح للبيانات المتداخلة. بخلاف JSON، تتيح لك TOML إضافة تعليقات توضيحية، وتدعم التاريخ والوقت بشكل أصلي، ولا تتطلب أحرف إفلات للسلاسل النصية متعددة الأسطر، مما يُسهّل صيانة ملفات التكوين وتعديلها يدويًا.
هل يمكن لـ TOML التعامل مع جميع أنواع بيانات JSON؟

نعم، يُمكن لـ TOML تمثيل جميع أنواع بيانات JSON، بما في ذلك السلاسل النصية والأرقام والقيم المنطقية والمصفوفات والكائنات المتداخلة. بالإضافة إلى ذلك، يُوفر TOML دعمًا أصليًا للتواريخ والأوقات، وهو ما لا يتوفر في JSON. على الرغم من اختلاف الصياغة، لا تُفقد أي بيانات أو معلومات عن النوع عند التحويل الصحيح من JSON إلى TOML.
ما هي لغات البرمجة التي تدعم TOML؟

تدعم العديد من لغات البرمجة لغة TOML، بما في ذلك بايثون، ورست، وغو، وجافا سكريبت/نود.جيه إس، وروبي، وجافا، وPHP، وغيرها الكثير. تحتوي معظم اللغات الرئيسية على مكتبات لتحليل وتوليد لغة TOML. وقد اعتمد مدير حزم كارغو في رست، وبرنامج تهيئة المشاريع في بايثون (pyproject.toml)، والعديد من أدوات التطوير الحديثة، لغة TOML كتنسيق تهيئة مفضل.