مدقّق YAML
تحقّق من YAML لاكتشاف أخطاء الصياغة والمفاتيح المكررة وغيرها من المشكلات، مع عرض رقم السطر والعمود لكل منها. تعمل في متصفحك.
الإدخال
الإخراج
ملف القراءة
ما الذي يتحقق منه مدقّق YAML؟
يُستخدم YAML في كثير من ملفات الإعدادات، مثل ملفات Docker Compose وبيانات Kubernetes وعمليات سير العمل في GitHub Actions وGitLab CI وملفات Ansible التشغيلية ومواصفات OpenAPI وإعدادات عدد لا يُحصى من التطبيقات. ولأن المسافات البادئة تحمل معنى في YAML، فقد يؤدي نقص مسافة أو وجود علامة جدولة في غير موضعها أو تكرار مفتاح إلى تعطيل الملف بطرق يصعب اكتشافها. يقرأ المدقّق YAML بالطريقة التي يقرأه بها المحلّل، ويسرد كل مشكلة مع رقم السطر والعمود.
طريقة الاستخدام
- الصق YAML أو اكتبه في المحرّر.
- تظهر النتيجة أثناء الكتابة: إما أن يكون YAML صالحًا، مع عدد المستندات التي يحتوي عليها، أو تُسرد كل مشكلة حسب ترتيب ظهورها في النص.
- تُحدَّد كل مشكلة في المحرّر؛ إذ تظهر الأخطاء باللون الأحمر والتحذيرات باللون الأصفر. انقر على المشكلة للانتقال إليها في المحرّر، أو انقر على موضع تحديدها للعثور عليها في القائمة.
ما الذي يكتشفه
- أخطاء الصياغة: علامات اقتباس وأقواس غير مغلقة، وعناصر ذات مسافات بادئة أقل أو أكثر من اللازم، وخلط مفتاح وعنصر قائمة في المستوى نفسه، وتداخل التعيينات في سطر واحد، مثل
a: b: c. - المفاتيح المكررة: تكرار المفتاح نفسه في التعيين الواحد. تحتفظ معظم المحلّلات بإحدى القيمتين فقط دون تنبيه، ما يؤدي إلى فقدان الإعداد الآخر.
- استخدام علامات الجدولة للمسافات البادئة: لا يسمح YAML إلا بالمسافات للمسافات البادئة.
- الأسماء المستعارة دون مراسٍ: يتطلب الاسم المستعار
*nameمرساة&nameتسبقه في المستند نفسه. - تحذيرات بشأن ما يُحلَّل بنجاح، لكنه قد لا يعمل على النحو المقصود، مثل وسم لا يتعرّف عليه المحلّل أو إصدار
%YAMLغير مدعوم.
لا مشكلة في استخدام المفتاح نفسه في تعيينات مختلفة، كما لا مشكلة في وجود عدة مستندات في ملف واحد تفصل بينها أسطر ---: إذ تُحتسب الأسطر في الملف بأكمله.
ما الذي لا يتحقق منه
يتحقق المدقّق من أن النص صالح بصيغة YAML، لا من أن برنامجًا معينًا يقبله. فقد يكون ملف Docker Compose صالحًا بصيغة YAML، ومع ذلك يتضمن اسم إعداد لا يتعرّف عليه Docker Compose. وترد الرسائل من مكتبة yaml باللغة الإنجليزية.
آلية العمل
تحلّل الأداة النص باستخدام مكتبة yaml، التي تتبع مواصفات YAML 1.2 وتشترط أن تكون المفاتيح فريدة. تُجرى جميع العمليات في متصفحك؛ ولا تُرفع ملفاتك مطلقًا.
الميزات
- عرض أخطاء الصياغة مع رقم السطر والعمود
- اكتشاف المفاتيح المكررة وعلامات الجدولة المستخدمة للمسافات البادئة والأسماء المستعارة دون مراسٍ
- تحديد الأخطاء والتحذيرات في المحرّر، مع إمكانية النقر للانتقال إلى موضعها
- دعم الملفات التي تحتوي على عدة مستندات
- يعمل في متصفحك