محوّل YAML وJSON

الصيغتان تصفان الأشكال نفسها — الخرائط والمتتاليات والقيم المفردة — فالتحويل تحليل في واحدة وتسلسل في الأخرى. والذي يختلف هو ما تتسامح معه كل صيغة.

وYAML يستعمل الإزاحة للبنية، والمسافات وحدها. فالمسافة الجدولية خطأ صياغي لا مسافة عريضة، وهو أشيع إخفاق في YAML بمفرده والذي تخفيه المحرّرات بعرضها المسافات الجدولية مسافاتٍ. والأخطاء هنا تبلّغ عن السطر، لأن السطر هو الجواب في الغالب الأعمّ.

وبعض السلاسل تحتاج اقتباسًا وليس بيّنًا أيّها. فـyes وno وon وoff قيم منطقية في YAML 1.1، فرمز بلد قيمته NO يصير false. وإصدار مكتوب 1.10 يصير العدد 1.1. والتحويل إلى JSON والعودة طريقة سريعة لترى ما يعنيه YAML عندك فعلًا لا ما يبدو عليه.

وفي الاتجاه الآخر، تُوسَّع المراسي والأسماء البديلة — آلية إعادة الاستعمال في YAML — لأن JSON لا سبيل فيه للتعبير عن مرجع. فالبيانات واحدة؛ والملف أطول.

اضغط حمّل عيّنة YAML: ملف Docker Compose، وهو حيث يلتقي معظم الناس بـYAML.

وبتحويله إلى JSON تصير البنية صريحة — كل خريطة بين قوسين معقوفين، وكل متتالية بين قوسين مربّعين. وهذه أسرع طريقة لتفحص ما أنتجته إزاحتك فعلًا. فمفتاح ظننته متداخلًا تحت web ويظهر في المستوى الأعلى من JSON يخبرك أنه أُزيح بمسافة واحدة أقلّ، ويشير إلى السطر بالضبط.

والآن فخّ الاقتباس. أضف سطرًا يقرأ enabled: yes وحوّل. يعود في JSON هكذا true، لا "yes". فإن كانت تلك القيمة رمز بلد أو جواب مستخدم، فقد غيّرها YAML في صمت. اقتبسها — enabled: "yes" — فتبقى سلسلة.

والاتجاه العكسي نافع لتوليد الإعدادات. اكتب الإعدادات أو اجلبها بصيغة JSON، وحوّلها إلى YAML، والصقها في ملف Compose أو بيان Kubernetes والإزاحة صحيحة أصلًا.

وإذا احتاجت جهة JSON ترتيبًا أولًا، فالمنسّق يبلّغ عن سطر أي خطأ صياغي وعموده بالضبط.