JSON سے YAML کنورٹر

JSON کو YAML میں کیوں تبدیل کریں؟

JSON مشینوں اور APIs کے لیے بہترین ہے، لیکن YAML انسانوں کے لیے پڑھنا اور ایڈٹ کرنا آسان ہے: نہ بریسز، نہ لازمی کوٹس، اور کمنٹس کی سپورٹ۔ زیادہ تر انفراسٹرکچر ٹولز، بشمول Kubernetes، Helm، Docker Compose، GitHub Actions، GitLab CI اور Ansible، YAML میں کنفیگر ہوتے ہیں، جبکہ جس ڈیٹا سے آپ شروع کرتے ہیں (API آؤٹ پٹ، kubectl get -o json، Terraform state) وہ اکثر JSON ہوتا ہے۔

Block بمقابلہ flow انداز

Block انداز ہر کی اور فہرست آئٹم کو اپنی لائن میں رکھتا ہے اور کنفیگ فائلوں کے لیے روایتی انتخاب ہے۔ Flow انداز JSON کی طرح اِن لائن {} اور [] استعمال کرتا ہے اور چھوٹے آخری سٹرکچرز کو کمپیکٹ رکھتا ہے۔ «لیول 2 سے Flow» اوپر کے دو لیولز کو block انداز میں رکھتا ہے اور اس سے گہری ہر چیز کو اِن لائن کرتا ہے، جو ports یا env vars جیسے چھوٹے آبجیکٹس کی لمبی فہرستوں کے لیے اچھا کام کرتا ہے۔

محفوظ کوٹنگ

جن سٹرنگز کو YAML پارسر غلط پڑھ سکتا ہے وہ خودکار طور پر کوٹ ہوتی ہیں: جیسے 'no'، 'on'، '1.0'، 'null'، شروع میں * یا & والی سٹرنگز، اور : پر مشتمل سٹرنگز۔ اگر آپ کی سٹائل گائیڈ ہر سٹرنگ کو کوٹ کرنے کا تقاضا کرتی ہے تو ہمیشہ سنگل یا ہمیشہ ڈبل منتخب کریں۔

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 دونوں ورژنز میں ایک جیسا پڑھا جاتا ہے۔