在yaml中使用占位符

时间:2017-01-12 18:44:50

标签: yaml template-variables

有没有办法在yaml中使用这样的占位符:

foo: &FOO
    <<propname>>: 
        type: number 
        default: <<default>>

bar:
    - *FOO 
       propname: "some_prop"
       default: "some default" 

3 个答案:

答案 0 :(得分:44)

上下文

  • YAML 1.2版
  • 用户希望在YAML中包含变量占位符

问题

  • YAML本身不支持变量占位符
  • Anchors和Aliases允许某种程度的抽象和间接,但这些不能作为可以插入整个YAML文本中任意区域的可变占位符。它们必须作为单独的YAML节点放置
  • 有一些附加库支持任意变量占位符,但它们不是本机YAML规范的一部分

实施例

考虑以下示例YAML。它是格式良好的YAML语法,但它使用带有嵌入式表达式的(非标准)大括号占位符。

嵌入式表达式不会在YAML中产生所需的结果,因为它们不是本机YAML规范的一部分。尽管如此,本例中仅使用它们来帮助说明标准YAML可用的内容以及不适用的内容。

part01_customer_info:
  cust_fname:   "Homer"
  cust_lname:   "Himpson"
  cust_motto:   "I love donuts!"
  cust_email:   homer@himpson.org

part01_government_info:
  govt_sales_taxrate: 1.15

part01_purchase_info:
  prch_unit_label:    "Bacon-Wrapped Fancy Glazed Donut"
  prch_unit_price:    3.00
  prch_unit_quant:    7
  prch_product_cost:  "{{prch_unit_price * prch_unit_quant}}"
  prch_total_cost:    "{{prch_product_cost * govt_sales_taxrate}}"

part02_shipping_info:
  cust_fname:   "{{cust_fname}}"
  cust_lname:   "{{cust_lname}}"
  ship_city:    Houston
  ship_state:   Hexas

part03_email_info:
  cust_email:     "{{cust_email}}"
  mail_subject:   Thanks for your DoughNutz order!
  mail_notes: |
    We want the mail_greeting to have all the expected values
    with filled-in placeholders (and not curly-braces).
  mail_greeting: |
    Greetings {{cust_fname}} {{cust_lname}}!

    We love your motto "{{cust_motto}}" and we agree with you!

    Your total purchase price is {{prch_total_cost}}

    Thank you for your order!

说明

  • GREEN 中标记的替换在标准YAML中很容易获得,使用锚点,别名和merge keys

  • YELLOW 中标记的替换在技术上可用于标准YAML,但不能没有custom type declaration或其他绑定机制。

  • RED 中标记的替换在标准YAML中不可用。然而,有一些解决方法和替代方案;例如通过string formatting或字符串模板引擎(例如python&#39; s str.format)。

Image explaining the different types of variable substitution in YAML

详细

YAML经常请求的功能是能够插入任意变量占位符,这些占位符支持与相同(或transcluded)YAML文件中的其他内容相关的任意交叉引用和表达式。< / p>

YAML支持锚点和别名,但此功能不支持在YAML文本中的任何位置任意放置占位符和表达式。它们仅适用于YAML节点。

YAML也支持custom type declaration,但这些不太常见,如果您接受来自潜在不受信任来源的YAML内容,则存在安全隐患。

YAML插件库

有YAML扩展库,但这些不是本机YAML规范的一部分。

变通方法

  • 将YAML与模板系统结合使用,例如Jinja2或Twig
  • 使用YAML扩展程序库
  • 使用托管语言中的sprintfstr.format样式功能

另见

答案 1 :(得分:4)

使用Yglu结构模板,您的示例可以编写为:

foo: !()
  !? $.propname: 
     type: number 
     default: !? $.default

bar:
  !apply .foo: 
    propname: "some_prop"
    default: "some default"

免责声明:我是作者或Yglu。

答案 2 :(得分:3)

我想https://get-ytt.io/是解决您问题的可接受方法