YAML سے JSON کنورٹر

YAML کیسے JSON میں بدلتا ہے

JSON، YAML 1.2 کا ذیلی سیٹ ہے، اس لیے ہر YAML mapping ایک JSON آبجیکٹ بنتی ہے، ہر sequence ایک ارے، اور scalars سٹرنگز، نمبرز، بولینز یا null بنتے ہیں۔ صرف YAML والی خصوصیات تبدیلی کے دوران حل ہو جاتی ہیں:

• کمنٹس (# …) ہٹا دیے جاتے ہیں، کیونکہ JSON میں کمنٹس نہیں ہوتے۔
• Anchors اور aliases (&base، *base، <<: *base) مکمل نقول میں پھیلا دیے جاتے ہیں۔
• ٹائم سٹیمپس جیسے 2024-01-02 ISO 8601 سٹرنگز بن جاتے ہیں۔
• ملٹی لائن سٹرنگز (| literal اور > folded بلاکس) \n ایسکیپس والی عام سٹرنگز بن جاتی ہیں۔

ملٹی ڈاکیومنٹ YAML

ایک فائل میں --- سے الگ کیے گئے کئی YAML ڈاکیومنٹس ہو سکتے ہیں، جیسا کہ Kubernetes manifests میں عام ہے۔ JSON میں اس کا کوئی متبادل نہیں، اس لیے کنورٹر ہر ڈاکیومنٹ کے لیے ایک element والا JSON ارے لوٹاتا ہے اور سٹیٹس بار میں یہ بتاتا ہے۔ آخر میں اکیلا --- نظر انداز ہو جاتا ہے۔

YAML 1.1 بمقابلہ 1.2 کی الجھنیں

یہ کنورٹر موجودہ سپیک YAML 1.2 کی پیروی کرتا ہے۔ بہت سے پرانے ٹولز (PyYAML، Ruby کا Psych، Kubernetes اور Ansible کے کچھ ورژن) اب بھی YAML 1.1 پڑھتے ہیں، جہاں اصول مختلف ہیں:

• ناروے کا مسئلہ: YAML 1.1 میں country: no کا مطلب false ہے، اس لیے ناروے کا کنٹری کوڈ NO غائب ہو جاتا ہے۔ یہی yes، on، off، y اور n کے ساتھ ہوتا ہے۔ YAML 1.2 صرف true اور false کو بولین مانتا ہے۔
• Octal نمبرز: 0755 ورژن 1.1 میں octal ہے لیکن 1.2 میں سادہ اعشاری، جو 0o755 استعمال کرتا ہے۔ احتیاطاً فائل موڈز کو کوٹ کریں۔
• Sexagesimal نمبرز: 1.1 میں 22:30 نمبر 1350 کے طور پر پارس ہو سکتا ہے۔ اوقات اور پورٹ میپنگز جیسے "8080:80" کو کوٹ کریں۔

JSON → YAML سمت مبہم سٹرنگز ('no'، 'on'، 'y') کو خودکار طور پر کوٹ کرتی ہے، اس لیے بننے والا YAML دونوں ورژنز میں ایک جیسا پڑھا جاتا ہے۔