dabf54f29f
terraform-docs version constraints is almost identical to the syntax used by Terraform. A version constraint is a string literal containing one or more condition, which are separated by commas. ```yaml version: ">= 0.13.0, < 1.0.0" ``` Each condition consists of an operator and a version number. A version number is a series of numbers separated by dots (e.g. `0.13.0`). Note that version number should not have leading `v` in it. Valid operators are as follow: - `=` (or no operator): allows for exact version number. - `!=`: exclude an exact version number. - `>`, `>=`, `<`, and `<=`: comparisons against a specific version. - `~>`: only the rightmost version component to increment. Signed-off-by: Khosrow Moossavi <khos2ow@gmail.com>
terraform-docs
What is terraform-docs
A utility to generate documentation from Terraform modules in various output formats.
Documentation
- Users
- Read the User Guide to learn how to use terraform-docs
- Read the Formats Guide to learn about different output formats of terraform-docs
- Refer to Config File Reference for all the available configuration options
- Developers
- Read Contributing Guide before submitting a pull request
Visit our website for all documentation.
Installation
The latest version can be installed using go get:
GO111MODULE="on" go get github.com/terraform-docs/terraform-docs@v0.12.1
NOTE: to download any version before v0.9.1 (inclusive) you need to use to
old module namespace (segmentio):
# only for v0.9.1 and before
GO111MODULE="on" go get github.com/segmentio/terraform-docs@v0.9.1
NOTE: please use the latest Go to do this, minimum go1.16 or greater.
This will put terraform-docs in $(go env GOPATH)/bin. If you encounter the error
terraform-docs: command not found after installation then you may need to either add
that directory to your $PATH as shown here or do a manual installation by cloning
the repo and run make build from the repository which will put terraform-docs in:
$(go env GOPATH)/src/github.com/terraform-docs/terraform-docs/bin/$(uname | tr '[:upper:]' '[:lower:]')-amd64/terraform-docs
Stable binaries are also available on the releases page. To install, download the
binary for your platform from "Assets" and place this into your $PATH:
curl -Lo ./terraform-docs.tar.gz https://github.com/terraform-docs/terraform-docs/releases/download/v0.12.1/terraform-docs-v0.12.1-$(uname)-amd64.tar.gz
tar -xzf terraform-docs.tar.gz
chmod +x terraform-docs
mv terraform-docs /some-dir-in-your-PATH/terraform-docs
NOTE: Windows releases are in ZIP format.
If you are a Mac OS X user, you can use Homebrew:
brew install terraform-docs
or
brew install terraform-docs/tap/terraform-docs
Windows users can install using Scoop:
scoop bucket add terraform-docs https://github.com/terraform-docs/scoop-bucket
scoop install terraform-docs
or Chocolatey:
choco install terraform-docs
Alternatively you also can run terraform-docs as a container:
docker run quay.io/terraform-docs/terraform-docs:0.12.1
NOTE: Docker tag latest refers to latest stable released version and edge
refers to HEAD of master at any given point in time.
Community
- Discuss terraform-docs on Slack
License
MIT License - Copyright (c) 2021 The terraform-docs Authors.