تنسيق TOML — دليل ملفات الإعداد

TOML هو تنسيق ملفات إعداد مصمم للوضوح والبساطة. يُعيّن بشكل لا لبس فيه إلى جدول تجزئة وسهل القراءة والكتابة. TOML هو التنسيق القياسي لـ Cargo.toml في Rust وpyproject.toml في Python.

نوع MIME

application/toml

النوع

نص

الضغط

بدون فقدان

المزايا

+ Unambiguous — no implicit type coercion unlike YAML
+ Native datetime support without quoting
+ Simple, flat structure that maps directly to hash tables
+ Standard in Rust and Python ecosystems

العيوب

− Deeply nested data structures become verbose
− Less widespread tool support compared to JSON and YAML
− No standard way to represent null values

متى تستخدم .TOML

استخدم TOML لملفات الإعداد — خاصة في بيئات Rust (Cargo.toml) وPython (pyproject.toml). مثالي حيث يهم التحليل اللا لبس فيه.

التفاصيل التقنية

يستخدم TOML أزواج مفتاح-قيمة وجداول (أقسام بين أقواس) ومصفوفات جداول (أقواس مزدوجة) وقيم مُنمّطة أصلياً تشمل التاريخ والوقت والأعداد الصحيحة والعشرية والقيم المنطقية والنصوص. المسافة البادئة ليست ذات دلالة.

التاريخ

أنشأ توم بريستون ويرنر (المؤسس المشارك لـ GitHub) تنسيق TOML في عام 2013 كبديل بسيط لـ YAML وJSON لملفات الإعداد. صدر TOML 1.0 في يناير 2021 بعد مساهمات مجتمعية واسعة.