محوّل الإعدادات من TOML إلى JSON

طريقة الاستخدام

1. الصق ملف TOML في مستند TOML، أو أبقِ المثال الموجود.
2. اقرأ الفحص. الأخضر يعني أن الملف يتبع TOML 1.0.0، والأحمر يذكر السطر والقاعدة التي يكسرها الملف.
3. انسخ مخرج JSON، أو نزّله باسم data.json.

كيف يعمل التحويل

يتبع القارئ قواعد TOML 1.0.0، ويبني الشجرة التي تصفها المواصفة. ثم تُكتب الشجرة بصيغة JSON بمسافتين للإزاحة، وتحتفظ المفاتيح بترتيب الملف، فيُقرأ JSON كما يُقرأ TOML.

• يصبح الجدول وجداوله الفرعية كائنات JSON.
• تصبح المصفوفة مصفوفة JSON. ومصفوفة الجداول، التي تكتبها TOML بقوسين مزدوجين، تصبح مصفوفة JSON من الكائنات.
• يصبح الجدول المضمّن كائن JSON، وتبقى مفاتيحه بترتيب سطره.

ما لا يستطيع JSON حمله

• يصبح التاريخ أو الوقت أو التاريخ مع الإزاحة نصاً، مثل ”1979-05-27T07:32:00-08:00“. فلا يملك JSON نوع تاريخ، والنص يحفظ الإزاحة وكل أرقام الكسر.
• تصبح اللانهاية أو NaN السلسلة ”inf“ أو ”-inf“ أو ”nan“، لأن JSON لا يملك هذا العدد.
• يُكتب العدد العشري بلا كسر، مثل 1.0، هكذا 1.0، ويُكتب العدد الصحيح مثل 1 هكذا 1. ويقرأ قارئ JSON الذي يعرف نوعاً واحداً من الأعداد كليهما على أنه العدد نفسه.

القواعد التي يتبعها الفحص

يُرفض الملف حين يكسر قاعدة من المواصفة. وتسبب هذه القواعد أغلب الأخطاء:

• لا يُعرَّف المفتاح إلا مرة واحدة. والمفتاح غير المقتبس والمفتاح المقتبس بالاسم نفسه هما المفتاح نفسه.
• ترويسة الجدول تعرّف جدولها مرة واحدة. ويمكن تعريف جدول كانت ترويسة أطول تضمّنته ضمناً فيما بعد، أما جدول أُنشئ بمفاتيح منقّطة أو بجدول مضمّن فلا.
• تنمو مصفوفة الجداول بجدول واحد لكل ترويسة مكتوبة بقوسين مزدوجين. والمصفوفة الثابتة، مثل التي تُكتب بزوج أقواس فارغ، لا تنمو بهذه الطريقة.
• العدد الصحيح عدد موقّع بـ64 بت، من -9223372036854775808 إلى 9223372036854775807.

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