Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/minamijoyo/hcledit
A command line editor for HCL
https://github.com/minamijoyo/hcledit
cli go hcl
Last synced: 6 days ago
JSON representation
A command line editor for HCL
- Host: GitHub
- URL: https://github.com/minamijoyo/hcledit
- Owner: minamijoyo
- License: mit
- Created: 2020-01-01T14:42:28.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-30T08:59:40.000Z (3 months ago)
- Last Synced: 2024-10-30T02:36:59.548Z (about 1 month ago)
- Topics: cli, go, hcl
- Language: Go
- Homepage:
- Size: 255 KB
- Stars: 462
- Watchers: 6
- Forks: 30
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - minamijoyo/hcledit - A command line editor for HCL (Go)
- awesome-tf - hcledit - A command line editor for HCL. (Tools / Community providers)
README
# hcledit
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![GitHub release](https://img.shields.io/github/release/minamijoyo/hcledit.svg)](https://github.com/minamijoyo/hcledit/releases/latest)
[![GoDoc](https://godoc.org/github.com/minamijoyo/hcledit/hcledit?status.svg)](https://godoc.org/github.com/minamijoyo/hcledit)## Features
- CLI-friendly: Read HCL from stdin, edit and write to stdout, easily pipe and combine other commands
- Token-based edit: You can update lots of existing HCL files with automation scripts without losing comments.
- Schemaless: No dependency on specific HCL application binary or schema
- Support HCL2 (not HCL1)
- Available operations:
- attribute append/get/rm/set
- block append/get/list/mv/rm
- body get
- fmtThe hcledit focuses on editing HCL with command line, doesn't aim for generic query tools. It was originally born for refactoring Terraform configurations, but it's not limited to specific applications.
The HCL specification is somewhat generic, so usability takes precedence over strictness if there is room for interpreting meanings in the schemaless approach.## Install
### Homebrew
If you are macOS user:
```
$ brew install minamijoyo/hcledit/hcledit
```### Download
Download the latest compiled binaries and put it anywhere in your executable path.
https://github.com/minamijoyo/hcledit/releases
### Source
If you have Go 1.22+ development environment:
```
$ git clone https://github.com/minamijoyo/hcledit
$ cd hcledit/
$ make install
$ hcledit version
```## Usage
```
$ hcledit --help
A command line editor for HCLUsage:
hcledit [command]Available Commands:
attribute Edit attribute
block Edit block
body Edit body
fmt Format file
help Help about any command
version Print versionFlags:
-f, --file string A path of input file (default "-")
-h, --help help for hcledit
-u, --update Update files in-placeUse "hcledit [command] --help" for more information about a command.
```### attribute
```
$ hcledit attribute --help
Edit attributeUsage:
hcledit attribute [flags]
hcledit attribute [command]Available Commands:
append Append attribute
get Get attribute
rm Remove attribute
set Set attributeFlags:
-h, --help help for attributeGlobal Flags:
-f, --file string A path of input file (default "-")
-u, --update Update files in-placeUse "hcledit attribute [command] --help" for more information about a command.
```Given the following file:
```attr.hcl
resource "foo" "bar" {
attr1 = "val1"
nested {
attr2 = "val2"
}
}
``````
$ cat tmp/attr.hcl | hcledit attribute get resource.foo.bar.nested.attr2
"val2"
``````
$ cat tmp/attr.hcl | hcledit attribute set resource.foo.bar.nested.attr2 '"val3"'
resource "foo" "bar" {
attr1 = "val1"
nested {
attr2 = "val3"
}
}
``````
$ cat tmp/attr.hcl | hcledit attribute rm resource.foo.bar.attr1
resource "foo" "bar" {
nested {
attr2 = "val2"
}
}
``````
$ cat tmp/attr.hcl | hcledit attribute append resource.foo.bar.nested.attr3 '"val3"' --newline
resource "foo" "bar" {
attr1 = "val1"
nested {
attr2 = "val2"attr3 = "val3"
}
}
```### block
```
$ hcledit block --help
Edit blockUsage:
hcledit block [flags]
hcledit block [command]Available Commands:
append Append block
get Get block
list List block
mv Move block (Rename block type and labels)
rm Remove blockFlags:
-h, --help help for blockGlobal Flags:
-f, --file string A path of input file (default "-")
-u, --update Update files in-placeUse "hcledit block [command] --help" for more information about a command.
```Given the following file:
```block.hcl
resource "foo" "bar" {
attr1 = "val1"
}resource "foo" "baz" {
attr1 = "val2"
}
``````
$ cat tmp/block.hcl | hcledit block list
resource.foo.bar
resource.foo.baz
``````
$ cat tmp/block.hcl | hcledit block get resource.foo.bar
resource "foo" "bar" {
attr1 = "val1"
}
``````
$ cat tmp/block.hcl | hcledit block mv resource.foo.bar resource.foo.qux
resource "foo" "qux" {
attr1 = "val1"
}resource "foo" "baz" {
attr1 = "val2"
}
``````
$ cat tmp/block.hcl | hcledit block rm resource.foo.baz
resource "foo" "bar" {
attr1 = "val1"
}
``````
$ cat tmp/block.hcl | hcledit block append resource.foo.bar block1.label1 --newline
resource "foo" "bar" {
attr1 = "val1"block1 "label1" {
}
}resource "foo" "baz" {
attr1 = "val2"
}
```### body
```
$ hcledit body --help
Edit bodyUsage:
hcledit body [flags]
hcledit body [command]Available Commands:
get Get bodyFlags:
-h, --help help for bodyGlobal Flags:
-f, --file string A path of input file (default "-")
-u, --update Update files in-placeUse "hcledit body [command] --help" for more information about a command.
```Given the following file:
```body.hcl
resource "foo" "bar" {
attr1 = "val1"
nested {
attr2 = "val2"
}
}
``````
$ cat tmp/body.hcl | hcledit body get resource.foo.bar
attr1 = "val1"
nested {
attr2 = "val2"
}
```### fmt
```
$ hcledit fmt --help
Format a file to a caconical styleUsage:
hcledit fmt [flags]Flags:
-h, --help help for fmtGlobal Flags:
-f, --file string A path of input file (default "-")
-u, --update Update files in-place
```Given the following file:
```
$ cat tmp/fmt.hcl
resource "foo" "bar" {
attr1 = "val1"
attr2="val2"
}
``````
$ cat tmp/fmt.hcl | hcledit fmt
resource "foo" "bar" {
attr1 = "val1"
attr2 = "val2"
}
```### Address escaping
Address escaping is supported for labels that contain `.`.
Given the following file:
```body.hcl
resource "foo.bar" {
attr1 = "val1"
nested {
attr2 = "val2"
}
}
``````
$ cat tmp/attr.hcl | hcledit attribute get 'resource.foo\.bar.nested.attr2'
"val2"
```## License
MIT