Files
terraform-docs/docs/reference/tfvars-json.md
Simon Clifford aa1e6bbf59 Add support for footer docs
Enables a footer to be appended to the end of a generated document
sourced from tf files or documents in the same way as the header

Adds the `footer-from` field to the config yml
Adds the `--footer-from` flag to the cli

Signed-off-by: Simon Clifford <siclifford@gmail.com>
Signed-off-by: Khosrow Moossavi <khos2ow@gmail.com>
2021-03-15 14:51:00 -04:00

3.2 KiB

title, description, menu, weight, toc
title description menu weight toc
tfvars json Generate JSON format of terraform.tfvars of inputs.
docs
parent
tfvars
961 true

Synopsis

Generate JSON format of terraform.tfvars of inputs.

terraform-docs tfvars json [PATH] [flags]

Options

  -h, --help   help for json

Inherited Options

  -c, --config string               config file name (default ".terraform-docs.yml")
      --footer-from string          relative path of a file to read footer from (default "")
      --header-from string          relative path of a file to read header from (default "main.tf")
      --hide strings                hide section [footer, header, inputs, modules, outputs, providers, requirements, resources]
      --hide-all                    hide all sections (default false)
      --output-file string          File in module directory to insert output into (default "")
      --output-mode string          Output to file method [inject, replace] (default "inject")
      --output-template string      Output template (default "<!-- BEGIN_TF_DOCS -->\n{{ .Content }}\n<!-- END_TF_DOCS -->")
      --output-values               inject output values into outputs (default false)
      --output-values-from string   inject output values from file into outputs (default "")
      --show strings                show section [footer, header, inputs, modules, outputs, providers, requirements, resources]
      --show-all                    show all sections (default true)
      --sort                        sort items (default true)
      --sort-by-required            sort items by name and print required ones first (default false)
      --sort-by-type                sort items by type of them (default false)

Example

Given the examples module:

terraform-docs tfvars json --footer-from footer.md ./examples/

generates the following output:

{
  "bool-1": true,
  "bool-2": false,
  "bool-3": true,
  "bool_default_false": false,
  "input-with-code-block": [
    "name rack:location"
  ],
  "input-with-pipe": "v1",
  "input_with_underscores": null,
  "list-1": [
    "a",
    "b",
    "c"
  ],
  "list-2": null,
  "list-3": [],
  "list_default_empty": [],
  "long_type": {
    "bar": {
      "bar": "bar",
      "foo": "bar"
    },
    "buzz": [
      "fizz",
      "buzz"
    ],
    "fizz": [],
    "foo": {
      "bar": "foo",
      "foo": "foo"
    },
    "name": "hello"
  },
  "map-1": {
    "a": 1,
    "b": 2,
    "c": 3
  },
  "map-2": null,
  "map-3": {},
  "no-escape-default-value": "VALUE_WITH_UNDERSCORE",
  "number-1": 42,
  "number-2": null,
  "number-3": "19",
  "number-4": 15.75,
  "number_default_zero": 0,
  "object_default_empty": {},
  "string-1": "bar",
  "string-2": null,
  "string-3": "",
  "string-special-chars": "\\.<>[]{}_-",
  "string_default_empty": "",
  "string_default_null": null,
  "string_no_default": null,
  "unquoted": null,
  "with-url": ""
}