Add ranges to terraform_required_version errors

Author: rdimartino

rules/terraform_required_version.go

@@ -1,6 +1,8 @@
 package rules
 
 import (
+	"path/filepath"
+
 	"github.com/hashicorp/hcl/v2"
 	"github.com/terraform-linters/tflint-plugin-sdk/hclext"
 	"github.com/terraform-linters/tflint-plugin-sdk/tflint"
@@ -78,13 +80,37 @@ func (r *TerraformRequiredVersionRule) Check(runner tflint.Runner) error {
 		exists = exists || ok
 	}
 
-	if !exists {
-		return runner.EmitIssue(
-			r,
-			`terraform "required_version" attribute is required`,
-			hcl.Range{},
-		)
+	if exists {
+		return nil
+	}
+
+	var missingRange hcl.Range
+
+	if len(body.Blocks) > 0 {
+		missingRange = body.Blocks[0].DefRange
+	} else {
+		// If there are no "terraform" blocks, create a hcl.Range for the files
+		var filename string
+		for k := range files {
+			filename = k
+			break
+		}
+
+		if len(files) == 1 {
+			missingRange = hcl.Range{
+				Filename: filename,
+			}
+		} else {
+			// If there are multiple files, reference the module directory
+			missingRange = hcl.Range{
+				Filename: filepath.Dir(filename) + string(filepath.Separator),
+			}
+		}
 	}
 
-	return nil
+	return runner.EmitIssue(
+		r,
+		`terraform "required_version" attribute is required`,
+		missingRange,
+	)
 }

rules/terraform_required_version_test.go

@@ -1,8 +1,10 @@
 package rules
 
 import (
+	"path/filepath"
 	"testing"
 
+	"github.com/hashicorp/hcl/v2"
 	"github.com/terraform-linters/tflint-plugin-sdk/helper"
 )
 
@@ -25,6 +27,17 @@ terraform {}
 				{
 					Rule:    NewTerraformRequiredVersionRule(),
 					Message: "terraform \"required_version\" attribute is required",
+					Range: hcl.Range{
+						Filename: "module.tf",
+						Start: hcl.Pos{
+							Line:   2,
+							Column: 1,
+						},
+						End: hcl.Pos{
+							Line:   2,
+							Column: 10,
+						},
+					},
 				},
 			},
 		},
@@ -53,6 +66,23 @@ terraform {
 `,
 			Expected: helper.Issues{},
 		},
+		{
+			Name: "no terraform block",
+			Content: `
+locals {
+	foo = "bar"
+}
+`,
+			Expected: helper.Issues{
+				{
+					Rule:    NewTerraformRequiredVersionRule(),
+					Message: "terraform \"required_version\" attribute is required",
+					Range: hcl.Range{
+						Filename: "module.tf",
+					},
+				},
+			},
+		},
 	}
 
 	rule := NewTerraformRequiredVersionRule()
@@ -73,3 +103,29 @@ terraform {
 		})
 	}
 }
+
+func Test_TerraformRequiredVersionRuleMultipleFiles(t *testing.T) {
+	rule := NewTerraformRequiredVersionRule()
+
+	t.Run("multiple files no terraform blocks", func(t *testing.T) {
+		files := map[string]string{
+			filepath.FromSlash("modules/foo/outputs.tf"):   "",
+			filepath.FromSlash("modules/foo/main.tf"):      "",
+			filepath.FromSlash("modules/foo/variables.tf"): "",
+		}
+		runner := helper.TestRunner(t, files)
+		if err := rule.Check(runner); err != nil {
+			t.Fatal(err)
+		}
+
+		helper.AssertIssues(t, helper.Issues{
+			{
+				Rule:    NewTerraformRequiredVersionRule(),
+				Message: "terraform \"required_version\" attribute is required",
+				Range: hcl.Range{
+					Filename: filepath.FromSlash("modules/foo/"),
+				},
+			},
+		}, runner.Issues)
+	})
+}