YAML (لغة YAML ليست لغة ترميز) هي لغة تسلسل بيانات صديقة للبشر وعابرة للغات تُستخدم عادةً لملفات التكوين وتمثل البيانات كخرائط وتسلسلات وقيم. جعلت النسخة 1.2 من YAML مجموعة صارمة من JSON. في عمل البروكسي والسكربينغ، يظهر YAML في ملفات التكوين. على سبيل المثال، يتم كتابة التكوين الثابت لبروكسي Envoy بلغة YAML ويحدد المستمعين والمجموعات التي تتدفق من خلالها حركة المرور.
أساسيات بناء جملة YAML
- الخرائط:
key: valueأزواج، مثل القواميس أو التجزئات. - التسلسلات: قوائم، مع كل عنصر في سطره الخاص يبدأ بـ
-. - المسافات البادئة: في نمط الكتلة، تحدد المسافات البادئة الهيكل، لذا فإن وجود مسافة غير صحيحة يغير معنى البيانات.
- لا تستخدم علامات التبويب: يجب عدم استخدام أحرف التبويب للمسافات البادئة.
- التعليقات:
#يبدأ تعليقًا.
استخدام YAML بأمان في تكوينات السكربينغ والبروكسي
يمكن لمحللات YAML القيام بأكثر من قراءة البيانات العادية. تحذر وثائق PyYAML من أن استدعاء yaml.load على بيانات من مصدر غير موثوق ليس آمناً، لأنه يمكن أن ينشئ كائنات بايثون عشوائية. وظيفته yaml.safe_load تتعرف فقط على علامات YAML القياسية، مما يجعلها الخيار الموثق للإدخال غير الموثوق.
السلاسل متعددة الأسطر، المراجع والمستندات المتعددة
- الكتلة الحرفية (
|): تحتفظ بكل فاصل سطر في سلسلة متعددة الأسطر. - الكتلة المطوية (
>): تحول كل فاصل سطر إلى مسافة، باستثناء قبل الأسطر الفارغة أو الأسطر الأكثر تداخلاً. - المراجع والألقاب:
&nameيحدد عقدة، و*nameيعيد استخدامها لاحقًا بدلاً من تكرارها. - مستندات متعددة:
---يحدد بداية محتوى مستند، لذا يمكن أن تحتوي دفق واحد على عدة مستندات....ينهي مستندًا دون بدء مستند جديد.