مدقق TOML
تحقّق من ملفات TOML مثل Cargo.toml وpyproject.toml أو إعدادات Hugo وNetlify قبل أن يفشل البناء بسببها. يحلل المدقق الإدخال وفق مواصفات TOML ويعرض أول خطأ مع السطر والعمود وشرح المحلل، بما في ذلك المفاتيح المكررة والجداول المعاد تعريفها والتواريخ المستحيلة. تعرض الملفات الصحيحة عدد الجداول والمفاتيح والمفاتيح الأعلى مستوى، لتتمكن من تأكيد البنية بنظرة سريعة.
الأسئلة الشائعة
ما الذي يتحقق منه مدقق TOML؟
يحلل المفاتيح والسلاسل والأرقام والقيم المنطقية والتواريخ والأوقات والمصفوفات والجداول المضمنة والجداول ومصفوفات الجداول تمامًا كما تحددها مواصفات TOML. ويُبلّغ عن أي انحراف بوصفه خطأ، مثل قيمة مفقودة أو سلسلة غير مقتبسة أو محرف هروب غير صالح. وتحصل الملفات الصحيحة على ملخص موجز لبنيتها.
ما المعلومات التي يتضمنها الخطأ؟
يعرض كل خطأ السطر والعمود اللذين توقف عندهما التحليل، وسطرًا من التفاصيل صادرًا عن المحلل، مثل تاريخ غير صالح أو محاولة إعادة تعريف جدول أو قيمة سبق تعريفها. يبدأ ترقيم الأسطر والأعمدة من 1. يُعرض الخطأ الأول فقط، لأن الأخطاء اللاحقة غالبًا ما تكون نتيجة له.
لماذا يُبلّغ عن إعادة تعريف مفتاح أو جدول؟
لا يسمح TOML بتكرار المفتاح نفسه في جدول، ولا يجوز ظهور عنوان جدول مثل [server] إلا مرة واحدة. ويُعدّ تعريف مفتاح منقّط مثل server.port بعد جدول [server] سبق أن حدّد port إعادة تعريف أيضًا. ادمج الإدخالات في موضع واحد لإصلاح ذلك.
كيف يُحتسب عدد الجداول والمفاتيح؟
يحصي الجداول كل جدول أسفل الجذر، بما في ذلك الجداول المضمنة وكل إدخال في مصفوفة الجداول. وتحصي المفاتيح كل مفتاح يحمل قيمة ليست جدولًا أو مصفوفة جداول، لذا تُحسب قائمة السلاسل مفتاحًا واحدًا. وتسرد المفاتيح الأعلى مستوى الأسماء الموجودة عند الجذر، بحد أقصى 50 اسمًا.
هل يجري التحقق من التواريخ والأوقات؟
نعم. يجري التحقق من التواريخ والأوقات ذات الإزاحة، والتواريخ والأوقات المحلية، والتواريخ المحلية والأوقات المحلية، بما في ذلك القيم المستحيلة مثل الشهر 13 أو الساعة 25. والتاريخ المكتوب بتنسيق آخر، مثل 05/27/1979، ليس تاريخ TOML ويجب اقتباسه كسلسلة نصية.
ما السلاسل ومحارف الهروب المسموح بها؟
تدعم السلاسل الأساسية المقتبسة بعلامتي اقتباس مزدوجتين محارف هروب مثل \n و\t و\" و\uXXXX، بينما تأخذ السلاسل الحرفية المقتبسة بعلامتي اقتباس مفردتين كل محرف كما كُتب. ولكل منهما صيغ متعددة الأسطر تستخدم ثلاث علامات اقتباس. يُعرض أي محرف هروب غير معروف أو سلسلة غير منتهية مع موضعه.
هل تُقبل الأعداد الصحيحة الكبيرة جدًا؟
نعم. تُقبل الأعداد الصحيحة حتى حد 64 بت المحدد في مواصفة TOML، مثل 9223372036854775807. أما الأعداد التي تتجاوز هذا النطاق، والأصفار البادئة، والشرطات السفلية التي لا تقع بين رقمين، فتُعد أخطاء.
هل تسبب علامة ترتيب البايتات أو نهاية السطر Windows مشكلة؟
لا. يتم تجاهل علامة ترتيب بايتات UTF-8 في البداية، وتُقبل نهايتا السطر LF وCRLF. وتُبلّغ عن أحرف التحكم غير المهربة داخل السلاسل النصية بوصفها أخطاء.
هل يتحقق من دلالات المفاتيح، كما يفعل Cargo أو Poetry؟
لا، يتحقق المدقق من صياغة TOML وبنيته فقط. قد يكون الملف صالحًا وفق TOML، ومع ذلك يحتوي على مفتاح لا يفهمه Cargo أو أحد أنظمة إنشاء حزم Python الخلفية. استخدم الأداة لاستبعاد مشكلات الصياغة قبل التحقق من إعدادات أدوات بعينها.
ما الحد الأقصى لحجم الإدخال، وهل يمكنني تحويله؟
يمكن أن يصل حجم الإدخال إلى 5 MiB، ويمكن أن يصل عمق المصفوفات المتداخلة والجداول المضمنة إلى 64 مستوى. لتحويل TOML صالح إلى JSON أو YAML أو تنسيق آخر، استخدم محول تنسيقات البيانات.