من JSON إلى TOML

إن JSON هو صيغة تبادل البيانات بين واجهات API والبرامج، لكن TOML أكثر راحةً كملف إعدادات يحرّره الإنسان: أقسام بين قوسين مربّعين، وأسطر key=value بسيطة، مع إمكانية إضافة التعليقات؛ تحوّل هذه الأداة كائن JSON الخاص بك إلى TOML سليم البنية، مثل الذي تستخدمه ملفات Cargo.toml و pyproject.toml.

تعمل الأداة محليًا بالكامل (عبر smol-toml المكتوبة بلغة JavaScript خالصة)؛ تصبح الكائنات جداول، وتصبح الكائنات المتداخلة جداول فرعية (مثل [server.meta])، وتصبح المصفوفات مصفوفات TOML، وتبقى القيم المفردة كما هي؛ وبما أن TOML يتطلّب جدولًا في المستوى الأعلى، فإن وجود مصفوفة أو قيمة مفردة أو null في الجذر يُرفض مع رسالة واضحة.

تصادف هذا عند توليد إعدادات Cargo أو pyproject من قالب، أو عند تحويل إعدادات JSON إلى ملف ‎.toml قابل للتحرير يدويًا، أو عند إنتاج إعدادات قابلة للقراءة انطلاقًا من واجهة API؛ وبصراحة، لا يملك TOML نوع null، لذا تُرفض الكائنات التي تحتوي قيم null برسالة واضحة بدلًا من إسقاطها بصمت؛ ولا يُرفع أي شيء.

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

البيانات التقنية

في 3 خطوات

1. أفلِت ملف JSON أو اختره.
2. تحوّله الأداة إلى TOML.
3. نزّل ملف TOML.

القيود: تتوقّع الأداة كائن JSON في المستوى الأعلى (تُرفض المصفوفة أو القيمة المفردة أو null في الجذر)؛ تتحوّل الكائنات المتداخلة إلى جداول فرعية، والمصفوفات إلى مصفوفات TOML؛ ولا يملك TOML نوع null لذا تُرفض الكائنات التي تحتوي قيم null؛ ويتبع ترتيبُ المفاتيح ترتيبَها في JSON.

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

أدوات ذات صلة

من TOML إلى JSON · JSON إلى YAML · YAML إلى JSON · من YAML إلى TOML · تحويل OBJ إلى GLB · تحويل GLB إلى OBJ