YAML (YAML Ain't Markup Language) ایک انسانی دوستانہ، کراس-زبان ڈیٹا سیریلائزیشن زبان ہے جو عام طور پر کنفیگریشن فائلوں کے لیے استعمال ہوتی ہے اور ڈیٹا کو میپنگز، تسلسل اور اسکیلرز کے طور پر پیش کرتی ہے۔ ورژن 1.2 نے YAML کو JSON کا ایک سخت سپر سیٹ بنا دیا۔ پروکسی اور اسکریپنگ کے کام میں، YAML کنفیگریشن فائلوں میں نظر آتا ہے۔ مثال کے طور پر، Envoy پروکسی کی سٹیٹک کنفیگریشن YAML میں لکھی گئی ہے اور اس میں ان سننے والوں اور کلسٹروں کی وضاحت کی گئی ہے جن کے ذریعے ٹریفک گزرتا ہے۔

YAML کی بنیادی نحو

  • میپنگز: key: value جوڑے، جیسے ڈکشنریاں یا ہیشز۔
  • تسلسل: فہرستیں، ہر آئٹم اپنی اپنی لائن پر - سے شروع ہوتا ہے۔
  • انڈینٹیشن: بلاک طرز میں، انڈینٹیشن ساخت کا تعین کرتا ہے، اس لیے ایک غلط جگہ پر موجود اسپیس ڈیٹا کے معنی کو تبدیل کر دیتی ہے۔
  • کوئی ٹیب نہیں: انڈینٹیشن کے لیے ٹیب کردار استعمال نہیں کیے جانے چاہئیں۔
  • تبصرے: ایک # تبصرے کا آغاز کرتا ہے۔

اسکریپر اور پروکسی کنفیگریشنز میں YAML کا محفوظ استعمال

YAML پارسرز صرف سادہ ڈیٹا پڑھنے سے زیادہ کر سکتے ہیں۔ PyYAML کی دستاویزات خبردار کرتی ہیں کہ کسی غیر معتبر ذریعہ سے ڈیٹا پر yaml.load کا استعمال کرنا محفوظ نہیں ہے، کیونکہ یہ بے ترتیب Python اشیاء بنا سکتا ہے۔ اس کا yaml.safe_load فنکشن صرف معیاری YAML ٹیگ کو پہچانتا ہے، جو اسے غیر معتبر ان پٹ کے لیے دستاویزی انتخاب بناتا ہے۔

کثیر لائن سٹرنگز، اینکرز اور متعدد دستاویزات

  • حقیقی بلاک (|): ایک کثیر لائن سٹرنگ میں ہر لائن کی وقفہ کو برقرار رکھتا ہے۔
  • مڑے ہوئے بلاک (>): ہر لائن کی وقفہ کو ایک اسپیس میں تبدیل کرتا ہے، سوائے خالی یا زیادہ انڈینٹڈ لائنوں کے۔
  • اینکرز اور ایلیاس: &name ایک نوڈ کو نشان زد کرتا ہے، اور *name اسے بعد میں دوبارہ استعمال کرتا ہے بجائے اس کے کہ اسے دہرایا جائے۔
  • متعدد دستاویزات: --- ایک دستاویز کے مواد کے آغاز کی نشاندہی کرتا ہے، اس لیے ایک اسٹریم میں کئی دستاویزات ہو سکتی ہیں۔ ... ایک دستاویز کو ختم کرتا ہے بغیر نئی شروع کیے۔

متعلقہ اصطلاحات