#hcl #processor #hq

bin+lib hq-rs

command-line HCL processor

26 releases (breaking)

new 0.21.0 Mar 22, 2025
0.19.1 Feb 15, 2025
0.13.0 Jul 16, 2024

#204 in Configuration

Download history 29/week @ 2024-12-08 1/week @ 2024-12-15 289/week @ 2025-01-26 441/week @ 2025-02-02 194/week @ 2025-02-09 253/week @ 2025-02-16 24/week @ 2025-02-23 8/week @ 2025-03-02

421 downloads per month

MIT license

32KB
696 lines

hq

ci crate docs

hq is a command-line HCL processor.

install

This will install an hq binary on your system:

$ cargo install hq-rs

usage

Here is an example HCL file:

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

some_block "some_block_label" {
    attr = "value"
}

some_block "another_block_label" {
    attr = "another_value"
}

You can query the attribute(s) and block(s) in an HCL file like so:

$ 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{"some_block_label"}.attr'
"value"
$ cat example.hcl | hq '.some_block{"another_block_label"}.attr'
"another_value"

Or read directly from a file by passing read -f:

$ hq read -f example.hcl '.some_block'
some_block "some_block_label" {
  attr = "value"
}
some_block "another_block_label" {
  attr = "another_value"
}

You can modify HCL (even HCL that is formatted and contains comments) like so:

$ 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"
}

nested_block {
    inner_block {
        value = "deep"
        another_value = "nested"
    }
}

Modifications can also be written directly to a file by passing -i/--inline and -f/--file:

$ 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"

You can delete entries in an HCL file like so:

$ cat example.hcl | hq delete '.nested_block.inner_block.value'
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  = "fmt_value"
    second_formatted_field = "second_value"
}

nested_block {
    inner_block {
        another_value = "nested"
    }
}

Or you can delete entries from a file by passing -i/--inline and -f/--file:

$ hq delete -i -f example.hcl '.nested_block.inner_block.another_value'

Dependencies

~8.5MB
~163K SLoC