Terraform developer tool to extract variables and generate variables.tf files.
Project description
Terraform module development tool.
- Extract variables from
main.tf
and generate avariables.tf
file - Find missing variables in
variables.tf
andmain.tf
based on each other - Generate a module use stub from a
variables.tf
file - Generate a .env file with variables from
main.tf
- Delete extra scratchrelaxtv files
install
pip install scratchrelaxtv
tips
Once installed, you can run scratchrelaxtv by typing either relaxtv
or scratchrelaxtv
.
Find out more about Terraform workflows and using scratchrelaxtv here.
workflows
Here are two example workflows using scratchrelaxtv.
Original module development:
- Write
main.tf
with whatever variables you need - Run scratchrelaxtv to generate
variables.tf
- Fill in descriptions, defaults, etc. in
variables.tf
- Run
terraform fmt
to prettify everything
Cleanup module:
- Run scratchrelaxtv in folder with
main.tf
andvariables.tf
to find missing variables - Using
-cf
option, automatically add missing vars tovariables.tf
- Fill in descriptions, defaults, etc. in
variables.tf
for newly added vars - Run
terraform fmt
to prettify everything
examples
example: generate variables.tf
By default, scratchrelaxtv looks for main.tf
and will generate a variables.tf
file. Variables will be in the same order in variables.tf
as they were in main.tf
. There are options to sort variables. You can --force
to overwrite an existing variables.tf
file. Otherwise, scratchrelaxtv will generate new variables.tf
files with each run: variables.1.tf
, variables.2.tf
and so on.
Assume this main.tf
:
resource "aws_s3_bucket" "this" {
count = "${var.create_bucket ? 1 : 0}"
bucket = "${var.bucket}"
region = "${var.region}"
}
Run scratchrelaxtv:
$ relaxtv
2019-04-26 08:02:54,011 - INFO - generating variables file
2019-04-26 08:02:54,011 - INFO - input file: main.tf
2019-04-26 08:02:54,011 - INFO - output file: variables.tf
2019-04-26 08:02:54,011 - INFO - not forcing overwrite of output file
2019-04-26 08:02:54,011 - INFO - not ordering output file
The generated variables.tf
:
variable "create_bucket" {
description = ""
type = "string"
default = ""
}
variable "bucket" {
description = ""
type = "string"
default = ""
}
variable "region" {
description = ""
type = "string"
default = ""
}
example: find and fix missing variables
Assume you already have a main.tf
and a variables.tf
. In this example, the variables.tf
is missing the region
variable.
main.tf
:
resource "aws_s3_bucket" "this" {
bucket = "${var.bucket}"
region = "${var.region}"
}
variables.tf
:
variable "bucket" {
description = "The bucket where the stuff will be stored"
type = "string"
default = ""
}
Run scratchrelaxtv to automatically add any missing variables:
$ relaxtv -cf
2019-04-26 08:21:27,289 - INFO - checking for missing variables
2019-04-26 08:21:27,289 - INFO - input file: main.tf
2019-04-26 08:21:27,289 - INFO - output file: variables.tf
2019-04-26 08:21:27,289 - INFO - forcing overwrite of output file
2019-04-26 08:21:27,289 - INFO - not ordering output file
2019-04-26 08:21:27,290 - WARNING - input file main.tf is missing variables:
region
Now, the variables.tf
looks like this:
variable "bucket" {
description = "The bucket where the stuff will be stored"
type = "string"
default = ""
}
variable "region" {
description = ""
type = "string"
default = ""
}
example: generate a stub for using the module
By default, when generating a stub, scratchrelaxtv looks for variables.tf
.
Assume this variables.tf
:
variable "id" {
description = "The ID of the resource"
type = "string"
default = ""
}
variable "bucket" {
description = "The bucket where the stuff will be stored"
type = "string"
default = ""
}
variable "region" {
description = "The AWS region where the bucket lives"
type = "string"
default = ""
}
Run scratchrelaxtv with the module stub option:
$ relaxtv -m
2019-04-26 08:09:27,147 - INFO - generating module usage stub
2019-04-26 08:09:27,147 - INFO - input file: variables.tf
2019-04-26 08:09:27,147 - INFO - output file: modstub.tf
2019-04-26 08:09:27,147 - INFO - not forcing overwrite of output file
2019-04-26 08:09:27,147 - INFO - not ordering output file
The generated modstub.tf
:
module "tests2" {
source = "../tests2"
providers = {
aws = "aws"
}
id = "${local.id}"
bucket = "${local.bucket}"
region = "${local.region}"
}
example: generate a .env
(dotenv) file
By default, when generating a .env
file, scratchrelaxtv looks for variables.tf
.
Assume this variables.tf
:
resource "aws_s3_bucket" "this" {
bucket = "${var.bucket}"
region = "${var.region}"
}
Run scratchrelaxtv with the generate .env
and sort-ascending options:
$ relaxtv -ea
2019-06-21 20:01:35,362 - INFO - generating .env file
2019-06-21 20:01:35,362 - INFO - input file: main.tf
2019-06-21 20:01:35,362 - INFO - output file: .env
2019-06-21 20:01:35,362 - INFO - not forcing overwrite of output file
2019-06-21 20:01:35,362 - INFO - ordering output file ascending
The generated .env
:
unset "${!TF_VAR_@}"
TF_VAR_bucket=replace
TF_VAR_region=replace
example: remove files
$ relaxtv -r
scratchrelaxtv can also tidy up your directories by removing its own extra generated files. Presumably it will only remove files you no longer need but be careful. This chart shows examples of what would be deleted or not.
NOTE: scratchrelaxtv removes files in the current directory and subdirectories.
Filename | Deleted? |
---|---|
variables.tf | no |
modstub.tf | yes |
modstub.1.tf | yes |
variables.1.tf | yes |
xyz.abc | no |
variables.a.tf | no |
variables.43.tf | yes |
modstub | no |
modstub..tf | no |
help
scratchrelaxtv includes help:
$ relaxtv --help
usage: scratchrelaxtv [-h] [-i INPUT] [-o OUTPUT] [-f] [-m] [-n MODNAME] [-r]
[-c] [-e] [-a | -d]
optional arguments:
-h, --help show this help message and exit
-i INPUT, --input INPUT
file to extract vars from
-o OUTPUT, --output OUTPUT
file to write extracted vars to
-f, --force overwrite existing out file
-m, --modstub generate module usage stub
-n MODNAME, --modname MODNAME
name to use in module stub
-r, --remove remove all modstub.tf, variables.#.tf files
-c, --check check that all vars are listed
-e, --env generate .env with Terraform vars
-a, --asc sort output variables in ascending order
-d, --desc sort output variables in descending order
CHANGE LOG
0.5.2 - 2019.07.19
- Add compatibility with HCL2 / Terraform 0.12.x variables (variables without
"${}"
) - Remove feature to automatically set lists default value to an empty list (does not work well with HCL2-style variables)
0.5.0 - 2019.07.02
- Add feature to generate Terraform variables (
.tfvars
) file
0.4.0 - 2019.06.21
- Add feature to generate dot-env (
.env
) file
0.3.0 - 2019.04.25
- Add functionality to check existing
main.tf
andvariables.tf
for missing variables
0.2.1 - 2019.04.25
- Fix inconsequential error thrown when removing files
0.2.0 - 2019.04.25
- Add capability to delete extra working files
0.1.3 - 2019.04.17
- Add module stub capability
0.1.2 - 2019.04.17
- Add simple docs
0.1.1 - 2019.04.16
- Initial working version
0.1.0 - 2019.04.15
- Initial release!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for scratchrelaxtv-0.5.8-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f664225f329e2f261a4cc9b4adfe431e0d8ac804e5e9db5e82ed38b6ac4802c2 |
|
MD5 | fdf2bb80c6e7eae34c1c62b1d0a26775 |
|
BLAKE2b-256 | a65abf6f13d6b1c8373509eaa6668df5318b058e1c5998d9a1735038c297c3d2 |