محول JSON إلى YAML

يقوم محول JSON إلى YAML بتحويل أي مستند JSON إلى YAML مكافئ وصالح. لصق JSON - حمولة API، وبيان الحزمة، وتصدير التكوين - واستعادة YAML النظيف مع مسافة بادئة متسقة، وبناء جملة القائمة الصحيحة، والسلاسل المقتبسة بشكل صحيح، جاهزة للإسقاط في بيان Kubernetes، أو ملف Docker Compose، أو سير عمل GitHub Actions، أو أي تكوين آخر قائم على YAML.

التحويل ليس مجرد مبادلة بناء الجملة. YAML له حواف حادة ولا يفعل JSON ذلك: يصبح "لا" غير المقتبس خطأ منطقيًا في العديد من المحللين، ويتحول "3000" بصمت إلى رقم، ويتم اقتطاع سلاسل الإصدارات مثل 1.10 إلى 1.1. يكتشف هذا المحول الكميات القياسية الغامضة الشائعة - القيم المنطقية، والأرقام العشرية الفارغة، والقيم القديمة لـ YAML 1.1 مثل نعم/لا/تشغيل/إيقاف، والسلاسل ذات الأحرف الخاصة - ويقتبسها حتى تبقى بياناتك على قيد الحياة ذهابًا وإيابًا مع الأنواع سليمة.

إليك ما يفعله محول JSON إلى YAML عبر الإنترنت مع مقتطف صغير من نمط Docker Compose. الإدخال {"name": "web"، "ports": ["8080:80"]، "debug": "no"} يأتي في أربعة أسطر: الاسم: web، ثم المنافذ:، ثم مسافة بادئة - "8080:80"، ثم تصحيح الأخطاء: "لا". يتم اقتباس تعيين المنفذ لأنه يحتوي على نقطتين، ويتم اقتباس "لا" بحيث يظل سلسلة. لم يتم تثبيت أي شيء: يعمل محول JSON إلى YAML عبر الإنترنت في الصفحة، لذا فهو يعمل بنفس الطريقة على جهاز كمبيوتر محمول أو متصفح هاتف.

كل شيء يحدث من جانب العميل، في متصفحك. غالبًا ما تحتوي ملفات التكوين على أسماء المضيفين والمنافذ الداخلية والأسرار، لذلك لا يتم تحميل أو تخزين أي شيء تقوم بلصقه - يعمل المحول دون اتصال بالإنترنت بمجرد تحميله. المسافة البادئة قابلة للتكوين (مسافتان أو 4 مسافات) لتتناسب مع أسلوب فريقك، وهناك خيار لاقتباس كل سلسلة لتحقيق أقصى قدر من الأمان.

هناك شيئان يتعلقان بالتحويل يستحقان التحقق من المخرجات. يتم اقتباس السلاسل التي تبدو مثل الأنواع الأخرى عمدًا، لأن YAML ستعيد تفسيرها بطريقة أخرى: سلسلة JSON "نعم" هي قيمة منطقية لم يتم اقتباسها مرة واحدة بموجب قواعد YAML 1.1، ويصبح "1.10" هو الرقم 1.1. الإفراط في الاقتباس هو الفشل الآمن هنا والتقليل من الاقتباس هو الخطير. والثاني هو أن JSON ليس لديه أي تعليقات لنقلها، لذلك يصل التكوين المحول من JSON بدون أي تعليقات، ويجب إعادة كتابة أي شيء توضيحي يدويًا. تظل الهياكل المتداخلة بعمق صالحة ولكنها تتوقف عن القراءة، وهو أمر يستحق التذكر عندما يكون سبب الانتقال إلى YAML هو سهولة القراءة في المقام الأول: بعد أربعة أو خمسة مستويات، يكون من الصعب متابعة المسافة البادئة لـ YAML مقارنة بأقواس JSON.