From 943489ca41b99f0474439d13b843c90fd6174a83 Mon Sep 17 00:00:00 2001 From: Christian Kampka Date: Thu, 10 Nov 2022 17:49:19 +0100 Subject: [PATCH] Ignore inputs with terraform-docs-ignore comment --- terraform/load.go | 9 ++++++++- terraform/testdata/full-example/variables.tf | 6 ++++++ 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/terraform/load.go b/terraform/load.go index a8587b4..348f346 100644 --- a/terraform/load.go +++ b/terraform/load.go @@ -187,10 +187,17 @@ func loadInputs(tfmodule *tfconfig.Module, config *print.Config) ([]*Input, []*I var optional = make([]*Input, 0, len(tfmodule.Variables)) for _, input := range tfmodule.Variables { + comments := loadComments(input.Pos.Filename, input.Pos.Line) + + // Skip over inputs that are marked as being ignored + if strings.Contains(comments, "terraform-docs-ignore") { + continue + } + // convert CRLF to LF early on (https://github.com/terraform-docs/terraform-docs/issues/305) inputDescription := strings.ReplaceAll(input.Description, "\r\n", "\n") if inputDescription == "" && config.Settings.ReadComments { - inputDescription = loadComments(input.Pos.Filename, input.Pos.Line) + inputDescription = comments } i := &Input{ diff --git a/terraform/testdata/full-example/variables.tf b/terraform/testdata/full-example/variables.tf index c504a0f..ecec599 100644 --- a/terraform/testdata/full-example/variables.tf +++ b/terraform/testdata/full-example/variables.tf @@ -28,3 +28,9 @@ variable "G" { description = "G description" default = null } + +# terraform-docs-ignore +variable "H" { + description = "H description" + default = null +}