حوّل مستند YAML (yml) إلى JSON لترى البنية التي تُخفيها الإزاحة والنوع الفعلي الذي حُلّلت إليه كل قيمة. تُوسَّع الـ anchors والـ aliases إلى قيم حقيقية، وتُجمع المستندات المتعددة المفصولة بـ --- في مصفوفة.
مفيد خصوصًا لاكتشاف أخطاء YAML الكلاسيكية: قيمة التصقت بالأب الخطأ بسبب مسافة واحدة ناقصة، أو version: 1.10 الذي يصبح بصمت الرقم 1.1.
YAML، أو أفلت الملف عليها.النتيجة لترى إن كانت كل قيمة قد أصبحت سلسلة نصية أو رقمًا أو قيمة منطقية، وانسخه إن احتجت إليه.name: ci
on:
push:
branches: [main]
defaults: &node
runs-on: ubuntu-latest
timeout-minutes: 10
jobs:
test: *node
{
"name": "ci",
"on": {
"push": {
"branches": [
"main"
]
}
},
"defaults": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
},
"jobs": {
"test": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
}
}
}يبقى المفتاح on: في GitHub Actions مفتاحًا نصيًا "on"، لأن هذه الأداة تحلّل بقواعد YAML 1.2. وتُوسَّع الكتلة المعرَّفة بالـ anchor &node في موضع *node.
yes وon وoff سلاسل نصية، ولا يصبح قيمًا منطقية إلا true/True/false.~ والقيم الفارغة null؛ وتصبح القيم السداسية عشرية 0x1F والثمانية 0o17 أرقامًا.&anchors و*aliases إلى القيم المشار إليها.| والمطوية > إلى سلاسل نصية مع تطبيق قواعد YAML للأسطر الجديدة.--- مصفوفة JSON؛ والمستند الواحد يُخرج كقيمته الخاصة.إن كان env تحت containers مُزاحًا بمستوى أقل من اللازم، فإنه يلتصق بصمت بحقل آخر ولا تكتشف ذلك إلا عند التطبيق. في JSON تُظهر الأقواس بالضبط إلى أي كائن ينتمي.
لسكربت أو حزمة واجهة أمامية تكون إضافة محلّل YAML إليها مبالغة، حوّل الإعدادات مرة واحدة واستخدمها بالشكل import config from './config.json'.
مستند OpenAPI المكتوب بـ YAML أسهل في الاستعلام بـ JSONPath أو jq بعد تحويله، مثلًا لاستخراج المخطط عند مسار معين.
<<: *defaults): تُنسخ مفاتيح الـ mapping المرتبط بالـ anchor، والمفاتيح المكتوبة بجانب << تتجاوزها. أما المحلّل الذي يقتصر على YAML 1.2 فيُبقي << مفتاحًا عاديًا، لذا قد تختلف النتائج عن تلك الأدوات.2024-01-01 سلاسل نصية ولا تصبح قيم Date..inf و.nan تمثيل في JSON فتصبحان null.on وyes على أنهما true، لذا قد تختلف النتائج في Python.on في GitHub Actions على شكل "on" لا true؟في YAML 1.2 القيم المنطقية الوحيدة هي true وfalse، فيكون on سلسلة نصية عادية، وهكذا يقرأ GitHub Actions المفتاح أيضًا. أما PyYAML في Python فيتبع 1.1 ويحوّله إلى مفتاح True، فانتبه عند تحليل ملفات workflow من السكربتات.
version: 1.10 يخرج على شكل 1.1.1.10 غير المقتبس رقم في YAML، و1.10 يساوي 1.1. للإبقاء على سلسلة إصدار، اقتبسها في YAML المصدر بالشكل "1.10".
يصبح كل مستند مفصول بـ --- عنصرًا في مصفوفة بالترتيب، لذا فإن ملفًا متعدد الموارد يُستخدم مع kubectl apply -f يُنتج مصفوفة من الموارد.