Terraform Docs Versions Save

Generate documentation from Terraform modules in various output formats

v0.11.1

3 years ago

Changelog

Bug Fixes

e5c8df5 fixed modules section visibility set via commandline (#387) 7b6afa3 include Resource.Mode when sorting to ensure deterministic resource table rendering fb204ca Fix release scripts for chocolatey

Docker images

  • docker pull quay.io/terraform-docs/terraform-docs:latest
  • docker pull quay.io/terraform-docs/terraform-docs:0.11.1

Contributors

Very special thanks to the contributors.

  • @bashims
  • @HeikoNeblung
  • @khos2ow

v0.11.0

3 years ago

Notable Updates

The most notable changes in this release are:

Note: We've also enabled GoReleaser for the release workflow, and to be able to support all the use-cases we changed the distribution of assets from standalone binary to compressed files (tar.gz and zip). In the upcoming releases we're going to deprecate distribution of standalone binaries, please adjust any scripts accordingly.

Changelog

Features

24e7cba Update download instruction to use tar.gz aecd044 Use goreleaser for release workflow and tasks 2575a40 added output section for modulecalls 533a82b Add section for Resources 54fc067 Add support for plugin execution aa7224d Add Slack workspace link

Bug Fixes

4f8952b Do not escape asterisk in markdown or asciidoc 4a98297 Cleanup extra empty lines from 'pretty' output 2353afb Never escape special characters in tfvars json 63750c1 Normalize last empty line of the generated output 4cd6f59 Show correct version when brew installs it

Refactoring

cbc0987 Make Developer Certificate of Origin (DCO) a requirement 37b9faa Move internal/tfconfig out of tree 89d7f6c Move pkg/print to internal/print e3a19ea Move pkg/tfconf to internal/terraform 446b9bc Move pkg/tmpl to internal/template

Docker images

  • docker pull quay.io/terraform-docs/terraform-docs:latest
  • docker pull quay.io/terraform-docs/terraform-docs:0.11.0

Contributors

Very special thanks to the contributors.

  • @HeikoNeblung
  • @dependabot
  • @khos2ow
  • @xortim
  • @winmillwill

v0.10.1

3 years ago

Changelog

This is a small patch over v0.10.0. It fixes an issue where terraform-docs crashes if provided argument is a file and not a directory.

Note: If you are a user of antonbabenko/pre-commit-terraform, you most probably are affected by this issue and need to upgrade to v0.10.1 otherwise you can continue using v0.10.0 without any issue.

Bug Fixes

  • Prevent segfault error if input arg is a file (#327)

v0.10.0

3 years ago

Changelog

BREAKING CHANGE

  • Following flags have been deprecated and will be removed in the following releases:
    • Flag --no-color has been deprecated, use --color=false instead
    • Flag --no-escape has been deprecated, use --escape=false instead
    • Flag --no-header has been deprecated, use --hide header instead
    • Flag --no-inputs has been deprecated, use --hide inputs instead
    • Flag --no-outputs has been deprecated, use --hide outputs instead
    • Flag --no-providers has been deprecated, use --hide providers instead
    • Flag --no-requirements has been deprecated, use --hide requirements instead
    • Flag --no-required has been deprecated, use --required=false instead
    • Flag --no-sensitive has been deprecated, use --sensitive=false instead
    • Flag --no-sort has been deprecated, use --sort=false instead
  • Flags --with-aggregate-type-defaults and --sort-inputs-by-required were marked as deprecated in v0.8.0 and now are removed.

Features

  • Add support for .terraform-docs.yml config file (#272)
  • Build and push docker image (#289)
  • Add new flags: --show, --show-all, --hide-all (#267)
  • Add support for TOML renderer (#197)
  • Add new flag to sort inputs by type (#246)
  • Add support for AsciiDoc renderer (#241)

Bug Fixes

  • Normalize variables with CRLF line ending in heredoc (#307)
  • Render special chars in variables' default value properly (#284)

Refactoring

  • Refactor cli implemention and configuration (#266)
  • Deprecate multiple flags in favor of new ones (#265)
  • Remove deprecated flags (#229)
  • Add factory function to return format types (#243)
  • Reorganize markdown format tests (#244)

Documentation

  • Overall improvements to documentation (#293)
  • Add detail about module header usage guide (#282)

Contributors

Very special thanks to the contributors.

  • @achaussier
  • @dependabot[bot]
  • @dependabot-preview[bot]
  • @swails
  • @jlosito
  • @Plouufff
  • @khos2ow
  • @rdelcampog
  • @ryanking
  • @tomoasleep

v0.10.0-rc.1

3 years ago

terraform-docs v0.10.0-rc.1 is a pre-release. It is to help gather feedback from the community as well as give users a chance to test terraform-docs in staging environments before v0.10.0 is officially released.

Action Required: This release deprecates handful of flags. Please update your workflow accordingly based on the changelog.

The official changelog will come out with the v0.10.0 release. For now, you can see the interim changelog here.

v0.9.1

4 years ago

Changelog

This is a small patch over v0.9.0 fixing issues with header section when there's no main.tf file.

Bug Fixes

  • Don't crash when reading header if 'main.tf' not found (#235)
  • Make sure requirements section is sorted (#233)

v0.9.0

4 years ago

Changelog

Note A regression found in this release where if there's no main.tf file available in the module, generating any output formats fails with Error: open main.tf: no such file or directory error. This has been fixed in v0.9.1 but as a workaround for this release you can explicitly pass --no-header flag to circumvent the issue.

Features

  • Add support for tfvars hcl and json commands (#226)
  • Allow hiding the "Sensitive" column in markdown (#223)
  • Add section for module requirements (#222)
  • Add support for fetching the module header from any file (#217)
  • Add support for XML renderer (#198)
  • Show sensitivity of the output value in rendered result (#207)
  • Extract and render output values from Terraform (#191)
  • Render formatted results with go templates (#177)
  • Add support for YAML renderer (#189)

Bug Fixes

  • Mark variables not required if default set to null (#221)
  • --no-header should not attempt reading main.tf file (#224)
  • Fix type conversion for numbers (#204)

Enhancements

  • Add extensive tests coverage for all the packages (#208)

Refactoring

  • Add Default value types for better marshalling (#196)
  • Introduce Format interface and expose to public pkg (#195)
  • Add tfconf.Options to load Module with (#193)

Documentation

  • Enhance automatic document generation (#227)
  • Add installation guide for Windows users (#218)
  • Put reference to usage, cli, etc. in user guide (#216)
  • Example git hook to keep module docs up to date (#214)
  • Auto generate formats document from examples (#192)

Contributors

Very special thanks to the contributors.

  • @aaronsteers
  • @gshel
  • @iMartyn
  • @JamesUoM
  • @julienduchesne
  • @khos2ow

v0.8.2

4 years ago

Changelog

This is a small patch over v0.8.1 fixing issues with header section.

Bug Fixes

  • Do not escape markdown table inside module header (#186)
  • Add double space only at the end of paragraph lines (#185)
  • Preserve asterisk list in header and fix escaping (#179)
  • Add newline between code block and trailing lines (#184)

v0.8.1

4 years ago

Changelog

This is a small patch release over v0.8.0.

Bug Fixes

  • Show native map and list as default value in JSON (#174)

v0.8.0

4 years ago

Changelog

This release supports Terraform v0.12.x configuration.

BREAKING CHANGE

  • With Terraform 0.12 ability to generate output from file has been deprecated in favor of from folder which contains one or more .tf files.

  • In the JSON format response, list of "Inputs" has been renamed to inputs.

  • In the JSON format response, list of "Outputs" has been renamed to outputs.

  • In the JSON format respone, module "Comment" has been renamed to module header.

  • For simplicity we've decided to deprecated the old --sort-inputs-by-required flag to the simpler and more generic --sort--by-required. The deprecated flags will get removed second release from now.

  • As of Terraform 0.12, the default value of input variables are shown in full JSON format (if available) and --with-aggregate-type-defaults is not needed anymore. The flag is marked as soft deprecated and will get removed in the second release from now.

  • With Terraform 0.12 the information about providers being used in the module will be generated by default. This will cause the first generation of documents with the latest release of terraform-docs binary be slightly different than before, now there will be Providers section in Markdown and providers block in JSON. You can ignore this by using new --no-providers flag if you choose to.

Features

  • Add '--no-escape' flag to 'json' command (#147)
  • Add flags to not show different sections (#144)
  • Add '--no-color' flag to 'pretty' command (#143)
  • Show 'providers' information (#140)
  • Bump golang to latest v1.13 (#133)
  • Support Terraform 0.12.x configuration (#113)

Bug Fixes

  • Do not escape any characters of a URL (#170)
  • Add double space at the end of multi-lines paragraph (#169)
  • Show empty JSON properties, as 'null' for all types (#166)
  • Show all JSON properties, empty or null (#160)
  • Do not escape strings inside code blocks (#155)
  • Read leading module header from main.tf (#154)
  • Read leading comment lines if description is not provided (#151)
  • Reimplement '--no-sort' to be compatible with Terraform 0.12 configuration (#141)

Enhancements

  • Rename flag to '--sort-by-required' (#150)
  • Mark '--with-aggregate-type-defaults' as deprecated (#148)
  • Bump homebrew formula version on release (#135)
  • Enable new go linters and fix the existing issues (#132)

Refactoring

  • Move doc.Doc to tfconf.Module (#136)

Documentation

  • Initial commit of usage documentation (#162)
  • Deprecate accepting files as commands param (#163)
  • Update Module internal documentaion

Contributors

Very special thanks for @moatra for the awesome work :heart:

  • @chenrui333
  • @khos2ow
  • @moatra