Allow hcl format from stdin

cli/commands/hclfmt/action.go

@@ -4,8 +4,10 @@
 package hclfmt
 
 import (
+	"bufio"
 	"bytes"
 	"fmt"
+	"io"
 	"os"
 	"os/exec"
 	"path/filepath"
@@ -28,6 +30,15 @@ import (
 func Run(opts *options.TerragruntOptions) error {
 	workingDir := opts.WorkingDir
 	targetFile := opts.HclFile
+	stdIn := opts.HclFromStdin
+
+	if stdIn {
+		if targetFile != "" {
+			return errors.Errorf("both stdin and path flags are specified")
+		}
+
+		return formatFromStdin(opts)
+	}
 
 	// handle when option specifies a particular file
 	if targetFile != "" {
@@ -81,6 +92,36 @@ func Run(opts *options.TerragruntOptions) error {
 	return formatErrors.ErrorOrNil()
 }
 
+func formatFromStdin(opts *options.TerragruntOptions) error {
+	contents, err := io.ReadAll(os.Stdin)
+
+	if err != nil {
+		opts.Logger.Errorf("Error reading from stdin: %s", err)
+		return err
+	}
+
+	if err = checkErrors(opts.Logger, opts.DisableLogColors, contents, "stdin"); err != nil {
+		opts.Logger.Errorf("Error parsing hcl from stdin")
+		return err
+	}
+
+	newContents := hclwrite.Format(contents)
+
+	buf := bufio.NewWriter(os.Stdout)
+
+	if _, err = buf.Write(newContents); err != nil {
+		opts.Logger.Errorf("Failed to write to stdout")
+		return err
+	}
+
+	if err = buf.Flush(); err != nil {
+		opts.Logger.Errorf("Failed to flush to stdout")
+		return err
+	}
+
+	return nil
+}
+
 // formatTgHCL uses the hcl2 library to format the hcl file. This will attempt to parse the HCL file first to
 // ensure that there are no syntax errors, before attempting to format it.
 func formatTgHCL(opts *options.TerragruntOptions, tgHclFile string) error {

cli/commands/hclfmt/action_test.go

@@ -263,6 +263,41 @@ func TestHCLFmtFile(t *testing.T) {
 	}
 }
 
+func TestHCLFmtStdin(t *testing.T) {
+	t.Parallel()
+
+	realStdin := os.Stdin
+	realStdout := os.Stdout
+
+	tempStdoutFile, err := os.CreateTemp(t.TempDir(), "stdout.hcl")
+	defer func() {
+		_ = tempStdoutFile.Close()
+	}()
+	require.NoError(t, err)
+
+	os.Stdout = tempStdoutFile
+	defer func() { os.Stdout = realStdout }()
+
+	os.Stdin, err = os.Open("../../../test/fixtures/hclfmt-stdin/terragrunt.hcl")
+	defer func() { os.Stdin = realStdin }()
+	require.NoError(t, err)
+
+	expected, err := os.ReadFile("../../../test/fixtures/hclfmt-stdin/expected.hcl")
+	require.NoError(t, err)
+
+	tgOptions, err := options.NewTerragruntOptionsForTest("")
+	require.NoError(t, err)
+
+	// format hcl from stdin
+	tgOptions.HclFromStdin = true
+	err = hclfmt.Run(tgOptions)
+	require.NoError(t, err)
+
+	formatted, err := os.ReadFile(tempStdoutFile.Name())
+	require.NoError(t, err)
+	assert.Equal(t, expected, formatted)
+}
+
 func TestHCLFmtHeredoc(t *testing.T) {
 	t.Parallel()
 

cli/commands/hclfmt/command.go

@@ -9,9 +9,10 @@ import (
 const (
 	CommandName = "hclfmt"
 
-	FlagNameTerragruntHCLFmt = "terragrunt-hclfmt-file"
-	FlagNameTerragruntCheck  = "terragrunt-check"
-	FlagNameTerragruntDiff   = "terragrunt-diff"
+	FlagNameTerragruntHCLFmt      = "terragrunt-hclfmt-file"
+	FlagNameTerragruntCheck       = "terragrunt-check"
+	FlagNameTerragruntDiff        = "terragrunt-diff"
+	FlagNameTerragruntHCLFmtStdin = "terragrunt-hclfmt-stdin"
 )
 
 func NewFlags(opts *options.TerragruntOptions) cli.Flags {
@@ -33,6 +34,12 @@ func NewFlags(opts *options.TerragruntOptions) cli.Flags {
 			EnvVar:      "TERRAGRUNT_DIFF",
 			Usage:       "Print diff between original and modified file versions when running with 'hclfmt'.",
 		},
+		&cli.BoolFlag{
+			Name:        FlagNameTerragruntHCLFmtStdin,
+			Destination: &opts.HclFromStdin,
+			EnvVar:      "TERRAGRUNT_HCLFMT_STDIN",
+			Usage:       "Format HCL from stdin and print result to stdout.",
+		},
 	}
 }
 

docs/_docs/04_reference/cli-options.md

@@ -65,6 +65,7 @@ This page documents the CLI commands and options available with Terragrunt:
   - [terragrunt-check](#terragrunt-check)
   - [terragrunt-diff](#terragrunt-diff)
   - [terragrunt-hclfmt-file](#terragrunt-hclfmt-file)
+  - [terragrunt-hclfmt-stdin](#terragrunt-hclfmt-stdin)
   - [terragrunt-hclvalidate-json](#terragrunt-hclvalidate-json)
   - [terragrunt-hclvalidate-show-config-path](#terragrunt-hclvalidate-show-config-path)
   - [terragrunt-override-attr](#terragrunt-override-attr)
@@ -769,6 +770,7 @@ prefix `--terragrunt-` (e.g., `--terragrunt-config`). The currently available op
   - [terragrunt-check](#terragrunt-check)
   - [terragrunt-diff](#terragrunt-diff)
   - [terragrunt-hclfmt-file](#terragrunt-hclfmt-file)
+  - [terragrunt-hclfmt-stdin](#terragrunt-hclfmt-stdin)
   - [terragrunt-hclvalidate-json](#terragrunt-hclvalidate-json)
   - [terragrunt-hclvalidate-show-config-path](#terragrunt-hclvalidate-show-config-path)
   - [terragrunt-override-attr](#terragrunt-override-attr)
@@ -1149,7 +1151,15 @@ When passed in, running `hclfmt` will print diff between original and modified f
 
 - [hclfmt](#hclfmt)
 
-When passed in, run `hclfmt` only on specified hcl file.
+### terragrunt-hclfmt-stdin
+
+**CLI Arg**: `--terragrunt-hclfmt-stdin`<br/>
+**Environment Variable**: `TERRAGRUNT_HCLFMT_STDIN` (set to `true`)<br/>
+**Commands**:
+
+- [hclfmt](#hclfmt)
+
+When passed in, run `hclfmt` only on hcl passed to `stdin`, result is printed to `stdout`.
 
 ### terragrunt-hclvalidate-json
 

options/options.go

@@ -239,6 +239,9 @@ type TerragruntOptions struct {
 	// The file which hclfmt should be specifically run on
 	HclFile string
 
+	// If True then HCL from StdIn must should be formatted.
+	HclFromStdin bool
+
 	// The file path that terragrunt should use when rendering the terragrunt.hcl config as json.
 	JSONOut string
 
@@ -577,6 +580,7 @@ func (opts *TerragruntOptions) Clone(terragruntConfigPath string) (*TerragruntOp
 		RunTerragrunt:                  opts.RunTerragrunt,
 		AwsProviderPatchOverrides:      opts.AwsProviderPatchOverrides,
 		HclFile:                        opts.HclFile,
+		HclFromStdin:                   opts.HclFromStdin,
 		JSONOut:                        opts.JSONOut,
 		JSONLogFormat:                  opts.JSONLogFormat,
 		Check:                          opts.Check,

test/fixtures/hclfmt-stdin/expected.hcl

@@ -0,0 +1,13 @@
+inputs = {
+  # comments
+  foo = "bar"
+  bar = "baz"
+
+  inputs   = "disjoint"
+  disjoint = true
+
+  listInput = [
+    "foo",
+    "bar",
+  ]
+}

test/fixtures/hclfmt-stdin/terragrunt.hcl

@@ -0,0 +1,13 @@
+inputs = {
+# comments
+  foo =                               "bar"
+  bar="baz"
+
+  inputs = "disjoint"
+  disjoint = true
+
+  listInput = [
+"foo",
+"bar",
+]
+}