https://github.com/tf2project/tf2project
Terraform Test Framework
https://github.com/tf2project/tf2project
automation cloud compliance devops end-to-end-testing hashicorp policy-as-code security terraform testing tf2
Last synced: 9 months ago
JSON representation
Terraform Test Framework
- Host: GitHub
- URL: https://github.com/tf2project/tf2project
- Owner: tf2project
- License: apache-2.0
- Created: 2022-07-15T21:16:25.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-09-30T14:28:41.000Z (over 3 years ago)
- Last Synced: 2025-04-25T00:34:10.941Z (9 months ago)
- Topics: automation, cloud, compliance, devops, end-to-end-testing, hashicorp, policy-as-code, security, terraform, testing, tf2
- Language: Python
- Homepage: https://tf2project.io
- Size: 83 KB
- Stars: 41
- Watchers: 3
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Terraform Test Framework
Unified Test Framework to test Terraform codes and Terraform-provisioned infrastructures.
The new version, v0.2.0 (Freedom) is now available.
---
**Documentation:** https://tf2project.io
**Source Code:** https://github.com/tf2project/tf2project
**Changelog:** https://tf2project.io/changelog.html
---
**TF2** is a unified test framework to test Terraform codes and Terraform-provisioned infrastructures. With TF2, you can implement PaC(**Policy as Code**), **Compliance** tests and e2e(**End to End**) tests just in a unified framework.
## Requirements
The **TF2 core** doesn't have any external or third-party requirements, and we will keep this approach as the main development policy to reduce the attack surface. This policy is created because you run the TF2 in your critical environments, CI/CD systems, and cloud/on-premises infrastructures, and we want to keep you completely secure. The TF2 core is just using standard and official Python libraries.
## Installation
On **production** environment:
```bash
pip install tf2project
```
On **development** environment:
```bash
export ENV=development
pip install git+https://github.com/tf2project/tf2project
```
## Docker Image
You can also use our official Docker image to run the framework. The image `tf2project/tf2project` consists of the latest version of Terraform and the TF2 framework itself.
It's a ready-to-go image to integrate the TF2 within CI/CD pipelines.
```bash
docker run tf2project/tf2project:latest
```
## License
This project is licensed under the terms of the Apache 2.0 license.
Copyright © 2022 Saeid Bostandoust