Skip to content

Automatically create a README file for your Terraform Module.

License

Notifications You must be signed in to change notification settings

holgerson97/auto-readme-for-tf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

88 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Auto README for Terraform

Tool to help you create templated READMEs that contain the actual information from your Terraform Module. Iterates through your module folder and pick up all information needed to make your README look good and provide helpful content.

Take a look at the examples folder to see some READMEs generated by this tool.  

Requirements

Software Version
Python >= 3.7
Pip3 >= 20.0.2
Terraform >= 0.14.0
 

NOTE: Older versions may work too, but aren't tested.

Examples

 

Creates a README with all features for the Terraform module at given path.

python3 main.py --path "terraform-example-module/"

 

Creates a README excluding contributions for the Terraform module at given path and specifys title name.

python3 main.py --path "terraform-exaple-module" --name "Example Module" --contributing False

 

Contributing

Feel free to create pull requests.