Simple Terraform test helper
Project description
Python Test Helper for Terraform
This simple helper facilitates testing Terraform modules from Python unit tests, by wrapping the Terraform executable and exposing convenience methods to set up fixtures, execute Terraform commands, and parse their output.
It allows for different types of tests: lightweight tests that only use Terraform init and plan to ensure code is syntactically correct and the right number and type of resources should be created, or full-fledged tests that run the full apply/output/destroy cycle, and can be then be used to test the actual created resources, or the state file.
As an additional convenience, the module also provides an easy way to request and access the plan output (via plan -out and show) and the outputs (via output -json), and can return them wrapped in simple classes that simplify accessing their attributes.
This module is heavily inspired by two projects: Terragrunt for the lightweight approach to testing Terraform, and python-terraform for wrapping the Terraform command in Python.
Example Usage
The test folder contains simple examples on how to write tests for both plan and apply, using either synthetic fixtures (simple representations of the plan output and output files), or minimal root modules. This is the test that uses plan output on an actual module:
import pytest
import tftest
@pytest.fixture
def plan(fixtures_dir):
tf = tftest.TerraformTest('plan', fixtures_dir)
tf.setup(extra_files=['plan.auto.tfvars'])
return tf.plan(output=True)
def test_variables(plan):
assert 'prefix' in plan.variables
assert plan.variables['names'] == ['one', 'two']
def test_outputs(plan):
assert sorted(plan.outputs['gcs_buckets'].keys()) == plan.variables['names']
def test_root_resource(plan):
res = plan.resources['google_project_iam_member.test_root_resource']
assert res['values']['project'] == plan.variables['project_id']
def test_modules(plan):
mod = plan.modules['module.gcs-buckets']
res = mod.resources['google_storage_bucket.buckets[0]']
assert res['values']['location'] == plan.variables['gcs_location']
Compatibility
Starting from version 1.0.0 Terraform 0.12 is required, and tests written with previous versions of this module are incompatible. Check the CHANGELOG.md file for details on what's changed.
Testing
Tests use the pytest framework and have no other dependency except on the Terraform binary. The version used during development is in the DEV-REQUIREMENTS.txt file.
Disclaimer
This is not an officially supported Google product.
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
File details
Details for the file tftest-1.5.1.tar.gz.
File metadata
- Download URL: tftest-1.5.1.tar.gz
- Upload date:
- Size: 8.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.7.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 63a6625bf535527734c4c4dbccf50707f62dc749b59134c22bb04707b12aaee7 |
|
| MD5 | 76e04ab45f130f34c8f41de54695dc86 |
|
| BLAKE2b-256 | 5cc4bae7afc01254e30f864440d0871ffa5273003df20a35b1a14932b99c4e5e |
Provenance
File details
Details for the file tftest-1.5.1-py3-none-any.whl.
File metadata
- Download URL: tftest-1.5.1-py3-none-any.whl
- Upload date:
- Size: 10.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.7.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e2c913d72b2d3d19ec40a8ea6ea333ec91ad9e9840992fcc97025a0d9a8b8fc6 |
|
| MD5 | 195855649d6d646eced549ed0077d190 |
|
| BLAKE2b-256 | 692bb5f119ff2f417d0bc8048ba1657b0b3f9db116bf65b0fecbfcfabb1cc367 |
