Skip to main content

A parser for HCL2

Project description

Build Status License PyPI Python Versions Downloads


This is a fork of the Python HCL2 repo by Amplify and is officially supported by Bridgecrew. We contributed as much as possible to the upstream project, but the two projects are now deviating in a way that pushing new changes upstream doesn't make sense anymore.

Python HCL2

A parser for HCL2 written in Python using Lark. This parser only supports HCL2 and isn't backwards compatible with HCL v1. It can be used to parse any HCL2 config file such as Terraform.

About Amplify

Amplify builds innovative and compelling digital educational products that empower teachers and students across the country. We have a long history as the leading innovator in K-12 education - and have been described as the best tech company in education and the best education company in tech. While others try to shrink the learning experience into
the technology, we use technology to expand what is possible in real classrooms with real students and teachers.

Learn more at

Getting Started


python-hcl2 requires Python 3.6.0 or higher to run.


This package can be installed using pip

pip3 install python-hcl2


import hcl2
with open('', 'r') as file:
    dict = hcl2.load(file)

Building From Source

For development, tox>=2.9.1 is recommended.

Running Tests

python-hcl2 uses tox. You will need to install tox with pip install tox. Running tox will automatically execute linters as well as the unit tests.

You can also run them individually with the -e argument.

For example, tox -e py37-unit will run the unit tests for python 3.7

To see all the available options, run tox -l.

Responsible Disclosure

If you have any security issue to report, contact project maintainers privately. You can reach us at


We welcome pull requests! For your pull request to be accepted smoothly, we suggest that you:

  1. For any sizable change, first open a GitHub issue to discuss your idea.
  2. Create a pull request. Explain why you want to make the change and what it’s for.

We’ll try to answer any PR’s promptly.

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

bc-python-hcl2-0.3.51.tar.gz (12.0 kB view hashes)

Uploaded source

Built Distribution

bc_python_hcl2-0.3.51-py3-none-any.whl (14.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page