محوّل JSON ↔ YAML ثنائي الاتجاه

نعم. YAML 1.2 مجموعة شاملة صارمة من JSON، بمعنى أن كل مستند JSON صالح هو YAML صالح. العكس ليس صحيحاً دائماً: ميزات YAML كالتعليقات والمراسي وكتل القيم ليس لها مكافئ في JSON.

YAML شائع في الملفات التكوينية: Docker Compose، ومناشير Kubernetes، وسير عمل GitHub Actions، وكتب تشغيل Ansible. أسلوبه المقروء مناسب للملفات التي يحررها المطورون يدوياً.

يفوز YAML في الغالب للتكوين الذي يحرره البشر لأنه يدعم التعليقات وأقل ضوضاءً بصرياً. JSON أفضل للتكوين الذي تنشئه أو تستهلكه الآلات. كثير من الأدوات (ESLint، Prettier، tsconfig) تقبل كلا الصيغتين.

السلاسل التي تحتوي على نقطتين متبوعتين بمسافة، أو أحرف خاصة في البداية ({, [, #)، أو قيم تبدو كقيم منطقية أو أرقام يجب وضعها بين اقتباسات. علامات الاقتباس المفردة تعطّل جميع الهروب، وعلامات الاقتباس المزدوجة تستخدم هروباً بالشرطة المائلة العكسية مشابهاً لـ JSON. يضيف هذا المحوّل اقتباسات تلقائياً حيثما لزم.

للأنواع التي يدعمها JSON (سلاسل، أرقام، قيم منطقية، null، كائنات، مصفوفات) التحويل بدون خسائر. المشكلة الوحيدة المحتملة هي استنتاج نوع YAML للقيم دون اقتباس، لذا يضع المحوّل اقتباسات حول السلاسل التي قد تُسَاء تفسيرها.

استخدم مكتبة PyYAML: import yaml, json; data = yaml.safe_load(open('file.yaml')); print(json.dumps(data, indent=2)). تتجنب الدالة safe_load تنفيذ وسوم YAML التعسفية، وهو أمر مهم للأمان.

باستخدام حزمة js-yaml: const yaml = require('js-yaml'); const obj = JSON.parse(fs.readFileSync('file.json')); console.log(yaml.dump(obj)). لتجنب الاعتماديات، اكتب مسلسل YAML يدوياً — وهو ما يفعله هذا المحوّل.

يتجاهل هذا المحوّل عمداً ميزات YAML المتقدمة: المراسي (&مرساة)، والأسماء المستعارة (*اسم)، ووسوم الأنواع (!!int وغيرها)، وكتل القيم متعددة الأسطر (| و>)، وفاصلات المستندات (---). وتشمل هذه الميزات أقل من 5% من استخدامات YAML الفعلية. لهذه الحالات، استخدم مكتبة YAML كاملة.