terraform_docs failing on TF0.12

[thenom]

Hi,

This is connected to #45 that was fixed in v1.15.0. That version has fixed the issue i had with mktemp but i am getting a new error on this version:

$ pre-commit run terraform_docs -a
Terraform docs...........................................................Failed
hookid: terraform_docs

2019/06/19 10:45:22 At 62:1: expected: IDENT | STRING | ASSIGN | LBRACE got: RBRACE

But on another terraform config we have the error slightly differs:

$ pre-commit run terraform_docs -a
Trim Trailing Whitespace.................................................Passed
Fix End of Files.........................................................Passed
Terraform docs...........................................................Failed
hookid: terraform_docs

2019/06/19 10:48:03 At 24:11: nested object expected: LBRACE got: ASSIGN

Both of these worked previously as they have fully populated README's. I would look into this further but not sure where the files are that the error location refers too (if you point me in the right direction i am more than happy to investigate)

Thanks,

[antonbabenko]

Please try v1.16.0.

If the problem persists please provide the failing snippet of the code you are trying to process.

[thenom]

Ok, all autoupdated and still getting the same problems:

$ pre-commit run terraform_docs -a
Terraform docs...........................................................Failed
hookid: terraform_docs

2019/06/19 19:27:28 At 62:1: expected: IDENT | STRING | ASSIGN | LBRACE got: RBRACE

and

pre-commit run terraform_docs -a
Terraform docs...........................................................Failed
hookid: terraform_docs

2019/06/19 19:23:01 At 13:15: nested object expected: LBRACE got: ASSIGN

It is always 1 of the 2 above but as a test i created a new local tf repo with:

$ cat README.md
Test documentation

<!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->

<!-- END OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
$ cat variables.tf
variable "test_var" {
  description = "This is a test variable"
  default     = ""
  type        = string
}
$ cat .pre-commit-config.yaml
repos:
- repo: https://github.com/antonbabenko/pre-commit-terraform
  rev: v1.16.0
  hooks:
  - id: terraform_fmt
  - id: terraform_docs

and forced ran the pre-commit on it which worked:

$ pre-commit run -a
Terraform fmt............................................................Failed
hookid: terraform_fmt

Files were modified by this hook. Additional output:

variables.tf

Terraform docs...........................................................Failed
hookid: terraform_docs

Files were modified by this hook.
$ cat README.md
Test documentation

<!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
## Inputs

| Name | Description | Type | Default | Required |
|------|-------------|:----:|:-----:|:-----:|
| test\_var | This is a test variable | string | `""` | no |

<!-- END OF PRE-COMMIT-TERRAFORM DOCS HOOK -->

I am afraid my TF modules are quite large and i am force running this to test it as i have not changed anything that would trigger it hence doing the minimal test. I have tried it on 4 of our repos so far and all have failed with one of the 2 errors.

As a side test though i cleaned out all output in a few of the README's (between the block identifier hooks) and re-ran and still got the same error on each.

Just a note though, these are all v0.11 TF code that i am currently in the process of converting to 0.12, not sure if this is relevant but thought it might be worth mentioning as the test setup i ran was fine.

Thanks again

[thenom]

Just an additional note, 1.16.0 works fine on pure TF 0.11 files.

[antonbabenko]

I tried to reproduce this several times with Terraform 0.12 and latest pre-commit-terraform (v1.16.0), but can't reproduce it.

When Terraform 0.11 is used the terraform_docs hook uses previous behavior (no awk script of other magic is necessary) and it works fine.

Let's keep it open for some time in case someone experiences a similar issue as you are describing and can provide failing code.

[gstewart]

Try with a single file (variables.tf for me) with something like this:

variable "test" {
  type        = "string"
  description = "testing"
}

With quotes around the string, you end up with two sets of quotes around it after the awk script runs (ex. ""string""). This is what terraform docs seems to fail on. If you remove the quotes from around it, everything runs ok.

This only seems to happen when the type line comes first and then another line like description comes after. If the type line comes on the second line, or is the only line between the brackets, you'll get a different exception.

[thenom]

Correct @gstewart,

I changed my test setup variables.tf to:

variable "test_var" {
  type        = "string"
  description = "This is a test variable"
  default     = ""
}

and now i get:

pre-commit run -a
Terraform fmt............................................................Passed
Terraform docs...........................................................Failed
hookid: terraform_docs

2019/06/25 10:12:16 At 3:15: nested object expected: LBRACE got: ASSIGN

If i take the quotes of the type it works fine. I have removed all the quotes from my main terraform modules variable types and i still get this error:

pre-commit run -a
Terraform fmt............................................................Passed
Terraform docs...........................................................Failed
hookid: terraform_docs

2019/06/25 10:21:17 At 62:1: expected: IDENT | STRING | ASSIGN | LBRACE got: RBRACE

[antonbabenko]

Yes, I could reproduce it.

@cytopia Once type is already enquoted it should not enquote it again.

[antonbabenko]

Looks like it has been just fixed by @cytopia, so I have released v1.17.0.

[thenom]

I am afraid i am still get the same problem:

pre-commit autoupdate
Updating https://github.com/antonbabenko/pre-commit-terraform...[INFO] Initializing environment for https://github.com/antonbabenko/pre-commit-terraform.
updating v1.16.0 -> v1.17.0.

pre-commit run -a
Terraform fmt............................................................Passed
Terraform docs...........................................................Failed
hookid: terraform_docs

2019/06/25 16:35:45 At 62:1: expected: IDENT | STRING | ASSIGN | LBRACE got: RBRACE

[cytopia]

@thenom

I've tested it for the block you pasted above:

variable "test_var" {
  type        = "string"
  description = "This is a test variable"
  default     = ""
}

Maybe there is another exception which is causing it?

[thenom]

@cytopia is there anyway i can get this to be more verbose to find out where it is having issues. I cannot rules out this being my tf files but as terraform formats it and runs fine on it i can't see how.

I dont mind spending the time investigating this but would help if there was anything built in that i could enable to start me off.