Skip to main content

Python module for creating Terraform configurations

Project description

Looking for more contributors

IF you feel that this project is useful to you, please consider contributing some of your time towards improving it! For more details on contributions, please have a look at and


Python-Terrascript is a Python package for generating Terraform configurations in JSON format.

Creating Terraform through a Python script offers a degree of flexibility superior to writing Terraform configurations by hand.

  • Control structures like if/else, for/continue/break or try/except/finally.

  • More string methods.

  • Python functions may be used as an alternative to Terraform Modules.

  • Access to the Python Standard Library and third-party packages.


Terraform releases

Terraform 0.12 introduced some changes to how it deals with configuration files in JSON format. This is reflected in Terrascript by currently having separate releases for Terraform 0.12 and Terraform 0.11. Earlier releases of Terraform are not supported.






Cleanup efforts and bug fixes, dropping support for Python <3.6, supporting Terraform 0.13.x



Terrascript 0.8 are a (almost) complete rewrite



Never released



Last releases to support Terraform 0.11 and earlier

Terrascript supports Python 3.6 and later.

Module layout

Python-Terrascript release 0.8.0 changed the location of modules. Providers, resources and data sources are now all available through just three modules.

import terrascript
import terrascript.provider     # aws, google, ...
import terrascript.resource     # aws_instance, google_compute_instance, ...
import         # aws_ami, google_compute_image, ...

The legacy layout is still available but should not be used for new projects.

import terrascript
import          # aws
import        # aws_instance, ...
import        # aws_ami, ...

A first example

The following example has been taken from the official Terraform documentation for the AWS Provider and then converted into a Python script that generates the equivalent configuration in JSON syntax.

The original Terraform HCL format.

provider "aws" {
  version = "~> 2.0"
  region  = "us-east-1"

resource "aws_vpc" "example" {
  cidr_block = ""

The Terrascript code would look like this.

import terrascript
import terrascript.provider as provider
import terrascript.resource as resource

config = terrascript.Terrascript()

config +='~> 2.0', region='us-east-1')
config += resource.aws_vpc('example', cidr_block='')

with open('', 'wt') as fp:

The content of is shown below. It is equivalent to the original HCL format.

  "provider": {
    "aws": [
        "version": "~> 2.0",
        "region": "us-east-1"
  "resource": {
    "aws_vpc": {
      "example": {
        "cidr_block": ""

Terrascript does not verify that the generated JSON code is a valid Terraform configuration. This is a deliberate design decision and is explained in the Frequently Asked Questions (FAQ)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

terrascript-0.9.0.tar.gz (85.6 kB view hashes)

Uploaded source

Built Distribution

terrascript-0.9.0-py2.py3-none-any.whl (174.1 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page