1- # bolwerk - Terraform Plan Analyzer
1+ # tfsumpy - Terraform Plan Summary Tool
22
3- [ ![ CI] ( https://github.com/rafaelherik/bolwerk /actions/workflows/ci.yaml/badge.svg )] ( https://github.com/rafaelherik/bolwerk /actions/workflows/ci.yaml )
3+ [ ![ CI] ( https://github.com/rafaelherik/tfsumpy /actions/workflows/ci.yaml/badge.svg )] ( https://github.com/rafaelherik/tfsumpy /actions/workflows/ci.yaml )
44
5- bolwerk is a Python-based tool that analyzes Terraform plan files to provide a clear summary of infrastructure changes and identify potential risks. It helps DevOps teams review infrastructure changes more effectively by:
6-
7- - Summarizing resource changes (create, update, delete)
8- - Identifying high and medium risk changes
9- - Automatically redacting sensitive information
10- - Providing detailed resource-level reporting
5+ tfsumpy is a Python-based tool that summarizes Terraform plan files to provide a clear overview of infrastructure changes. It helps DevOps teams review infrastructure changes more effectively by providing detailed plan summaries in different formats.
116
127## Features
138
149- 🔍 Detailed plan analysis with change breakdown
1510- 📊 Clear summary statistics for resource changes
1611- 🔒 Automatic sensitive information redaction
17- - 🛡️ Risk assessment for infrastructure changes
18- - 📋 Policy compliance checking
1912- 🎨 Color-coded output for better readability
2013- 🔄 Detailed attribute change tracking
2114
2215## Installation
2316
2417Install using pip:
2518``` bash
26- pip install bolwerk
19+ pip install tfsumpy
2720```
2821Or install from source:
2922``` bash
30- git clone https://github.com/rafaelherik/bolwerk .git
31- cd bolwerk
23+ git clone https://github.com/rafaelherik/tfsumpy .git
24+ cd tfsumpy
3225 pip install .
3326```
3427## Usage
@@ -45,27 +38,17 @@ Or install from source:
4538
4639Basic summary:
4740``` bash
48- bolwerk plan.json
41+ tfsumpy plan.json
4942```
5043
5144Show detailed changes:
5245``` bash
53- bolwerk plan.json --changes
46+ tfsumpy plan.json --changes
5447```
5548
5649Show resource details:
5750``` bash
58- bolwerk plan.json --details
59- ```
60-
61- Enable risk assessment:
62- ``` bash
63- bolwerk plan.json --risks
64- ```
65-
66- Enable policy compliance check:
67- ``` bash
68- bolwerk plan.json --policies
51+ tfsumpy plan.json --details
6952```
7053
7154### Example Output
@@ -88,35 +71,6 @@ Enable policy compliance check:
8871 DELETE aws_security_group: old_sg
8972 - name = " old-sg"
9073```
91- ### Advanced Features
92-
93- 1 . Risk Assessment:
94-
95- ``` bash
96- bolwerk plan.json --risks
97- ```
98-
99- This will show:
100- - High and medium risk changes
101- - Impact assessment
102- - Mitigation suggestions
103-
104- 2 . Policy Compliance:
105-
106- ``` bash
107- bolwerk plan.json --policies
108- ```
109-
110- Checks resources against:
111- - Security best practices
112- - Compliance requirements
113- - Custom policy rules
114-
115- 3 . Detailed Analysis:
116-
117- ``` bash
118- bolwerk plan.json --changes --details --risks
119- ```
12074
12175### Configuration
12276
@@ -144,15 +98,15 @@ Create a custom configuration file (config.json):
14498Use the configuration:
14599
146100``` bash
147- bolwerk plan.json --config config.json
101+ tfsumpy plan.json --config config.json
148102```
149103
150104### Debug Mode
151105
152106For troubleshooting or detailed logging:
153107
154108``` bash
155- bolwerk plan.json --debug
109+ tfsumpy plan.json --debug
156110```
157111
158112This will:
0 commit comments