hq

hq 是一个命令行HCL处理器。

安装

这将将在您的系统上安装 hq 二进制文件

$ cargo install hq-rs

用法

以下是一个HCL文件的示例

some_attr = {
    foo = [1, 2]
    bar = true
}

some_block "some_block_label" {
    attr = "value"
}

some_block "another_block_label" {
    attr = "another_value"
}

您可以通过这种方式查询HCL文件中的属性（和块）

$ cat example.hcl | hq '.some_attr'

{
  foo = [
    1,
    2
  ]
  bar = true
}

$ cat example.hcl | hq '.some_attr.foo'

[
  1,
  2
]

$ cat example.hcl | hq '.some_block'

some_block "some_block_label" {
  attr = "value"
}
some_block "another_block_label" {
  attr = "another_value"
}

$ cat example.hcl | hq '.some_block[label="some_block_label"].attr'

"value"

$ cat example.hcl | hq '.some_block[label="another_block_label"].attr'

"another_value"

或者通过传递 read -f 从文件中直接读取

$ hq read -f example.hcl '.some_block'

some_block "some_block_label" {
  attr = "value"
}
some_block "another_block_label" {
  attr = "another_value"
}

您还可以这样修改HCL（即使是格式化且包含注释的HCL）

$ cat example.hcl | hq write '.fmt_block.first_formatted_field="something_new"'

some_attr = {
    foo = [1, 2]
    bar = true
}

some_block "some_block_label" {
    attr = "value"
}

some_block "another_block_label" {
    attr = "another_value"
}

# this is a block comment
fmt_block "fmt_label" {
    # this is a body comment
    # this is another body comment

    # this is a third body comment
    first_formatted_field  = "something_new"
    second_formatted_field = "second_value"
}

修改也可以通过传递 -i（内联）和 -f（文件）直接写入文件

$ hq write -i -f example.hcl '.fmt_block.first_formatted_field="something_written_inline"'

$ hq read -f example.hcl .fmt_block.first_formatted_field
"something_written_inline"