تحويل YAML إلى JSON والعكس

بامتداد الملف أولًا: ملف .json يتحول إلى YAML، وملفا .yaml و.yml يتحولان إلى JSON. وفي ملفات .txt وغيرها من الملفات بلا امتداد معروف يحسم المحتوى: يُجرَّب النص على أنه JSON أولًا، ثم على أنه YAML. وإذا لم ينجح التحليل في الحالتين تُبلَّغ بذلك، ويمكنك أن تختار الاتجاه بنفسك.

الملف المقسوم بعلامات --- يمكن قراءته بطريقتين. حين يكون وضع المستندات المتعددة مفعّلًا، يصير كل مستند عنصرًا في مصفوفة JSON واحدة. وحين يكون متوقفًا، لا يُحوَّل إلا المستند الأول، وتظهر لك ملاحظة لا توقف العمل تخبرك بأن الباقي تُجوهل، فلا تفاجئك نتيجة مبتورة بصمت أبدًا.

لأن التعريف الثاني في YAML يستبدل الأول دون أي إشارة إلى أن ذلك حدث. وهذه طريقة شائعة لفقدان ربط منفذ أو متغير بيئة في ملف إعدادات. يتوقف التحويل ويذكر المفتاح مع رقمي السطرين، فتقرر أنت أي تعريف كان مقصودًا.

لا يتعرف failsafe إلا على السلاسل النصية والخرائط والتسلسلات؛ لا شيء يتحول إلى عدد أو قيمة منطقية أو تاريخ أو null. وهو الاختيار الصحيح حين يجب أن يُحفظ ملف الإعدادات حرفيًا، مثلًا حين تكون قيمة مثل 1.10 رقم إصدار لا عددًا، أو حين تحوّل «مشكلة النرويج» رمز الدولة no إلى false.

لا، ولا يمكن أن تبقى. ليس في JSON أي صياغة للتعليقات أصلًا، فكل ما يأتي بعد # يُحذف أثناء التحويل. هذه خاصية في الصيغة الهدف لا نقص في الأداة، فاحتفظ بملف YAML مصدرًا أساسيًا إذا كانت التعليقات تهمك.

يحدد عند أي عمق من التداخل ينتقل إخراج YAML من الأسلوب الكتلي، بالشرطات والمسافات البادئة، إلى الأسلوب المضمّن مثل [a, b] و{a: b}. والإعداد الافتراضي يُبقي كل المستويات بالأسلوب الكتلي، وهو الأسهل قراءة لملفات الإعدادات التي تُعدَّل يدويًا. وضبط عمق موجب يضغط كل ما تحته، وهذا يناسب البيانات شديدة التداخل.

لا. المراسي والأسماء المستعارة ومفاتيح الدمج (&defaults و*defaults و<<)، ومعها الوسوم المخصصة للتطبيقات، خارج ما تقرؤه هذه الأداة. والملف الذي يستخدمها يحصل على خطأ واضح يذكر السطر بدل نتيجة خاطئة بصمت، وهذا الفشل أكثر أمانًا لملف إعدادات أنت على وشك نشره.

لا. المحللان كلاهما يصلان مع الصفحة ويعملان داخل علامة التبويب في متصفحك، فلا تنتقل إعداداتك عبر الشبكة أبدًا. لا يوجد جزء على الخادم يخزنها، ولا يُحتفظ بشيء بعد إغلاق علامة التبويب.