YAML (YAML ไม่ใช่ภาษา Markup) เป็นภาษาการจัดเรียงข้อมูลที่เป็นมิตรกับมนุษย์และข้ามภาษา ซึ่งมักใช้สำหรับไฟล์การกำหนดค่าและแสดงข้อมูลในรูปแบบการจับคู่ ลำดับ และสเกลาร์ เวอร์ชัน 1.2 ทำให้ YAML เป็นซุปเปอร์เซ็ตที่เข้มงวดของ JSON ในงานพร็อกซีและการขูดข้อมูล YAML จะปรากฏในไฟล์การกำหนดค่า ตัวอย่างเช่น การกำหนดค่าคงที่ของพร็อกซี Envoy เขียนด้วย YAML และกำหนดผู้ฟังและกลุ่มที่การจราจรไหลผ่าน

พื้นฐานไวยากรณ์ YAML

  • การจับคู่: key: value คู่ เช่น พจนานุกรมหรือแฮช
  • ลำดับ: รายการ โดยแต่ละรายการอยู่ในบรรทัดของตัวเองเริ่มต้นด้วย -
  • การเยื้อง: ในรูปแบบบล็อก การเยื้องจะกำหนดโครงสร้าง ดังนั้นการเว้นวรรคที่ไม่ถูกต้องจะเปลี่ยนความหมายของข้อมูล
  • ไม่มีแท็บ: ตัวอักษรแท็บต้องไม่ถูกใช้สำหรับการเยื้อง
  • ความคิดเห็น: # เริ่มความคิดเห็น

การใช้ YAML อย่างปลอดภัยใน Scraper และ Proxy Configs

YAML parsers สามารถทำมากกว่าการอ่านข้อมูลธรรมดา เอกสาร PyYAML เตือนว่าการเรียกใช้ yaml.load บนข้อมูลจากแหล่งที่ไม่น่าเชื่อถือไม่ปลอดภัย เพราะมันสามารถสร้างวัตถุ Python ตามอำเภอใจ ฟังก์ชัน yaml.safe_load ของมันรับรู้เฉพาะแท็ก YAML มาตรฐาน ซึ่งทำให้มันเป็นตัวเลือกที่มีเอกสารสำหรับข้อมูลที่ไม่น่าเชื่อถือ

สตริงหลายบรรทัด, แอนเคอร์ และเอกสารหลายฉบับ

  • บล็อกตัวอักษร (|): เก็บรักษาการขึ้นบรรทัดทุกบรรทัดในสตริงหลายบรรทัด
  • บล็อกพับ (>): เปลี่ยนการขึ้นบรรทัดแต่ละบรรทัดให้เป็นช่องว่าง ยกเว้นก่อนบรรทัดที่ว่างหรือมีการเยื้องมากขึ้น
  • แอนเคอร์และอัลลิอัส: &name ทำเครื่องหมายโหนด และ *name ใช้ซ้ำในภายหลังแทนที่จะทำซ้ำ
  • เอกสารหลายฉบับ: --- ทำเครื่องหมายจุดเริ่มต้นของเนื้อหาของเอกสาร ดังนั้นสตรีมหนึ่งสามารถถือเอกสารหลายฉบับ ... สิ้นสุดเอกสารโดยไม่เริ่มเอกสารใหม่

ข้อกำหนดที่เกี่ยวข้อง