terraback 0.2.0__tar.gz

terraback-0.2.0/LICENSE

@@ -0,0 +1,66 @@
+# Terraback Licensing
+
+This project uses a dual licensing model:
+
+## Community Edition (MIT License)
+
+The Community Edition of Terraback, which includes basic scanning functionality for EC2, VPC, and S3 resources, is licensed under the MIT License:
+
+```
+MIT License
+
+Copyright (c) 2025 Bogdan Moldovan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## Professional Edition (Commercial License)
+
+The Professional Edition includes advanced features such as:
+- Full RDS support
+- Load Balancer scanning (ALB, NLB, CLB)
+- Advanced dependency scanning with `--with-deps`
+- IAM role and policy scanning
+- Premium support
+
+The Professional Edition requires a separate commercial license. Please contact [your-email@example.com] for licensing information.
+
+## Feature Availability
+
+| Feature                                  | Community Edition |  Professional Edition |
+|------------------------------------------|:-----------------:|:---------------------:|
+| EC2 Instance Scanning                    |        ✅         |         ✅           |
+| VPC/Subnet Scanning                      |        ✅         |         ✅           |
+| Basic S3 Scanning                        |        ✅         |         ✅           |
+| EBS Volume Scanning                      |        ✅         |         ✅           |
+| AMI Scanning                             |        ✅         |         ✅           |
+| Key Pair Scanning                        |        ✅         |         ✅           |
+| Security Group Scanning                  |        ✅         |         ✅           |
+| RDS Support                              |        ❌         |         ✅           |
+| Load Balancer Support (ALB/NLB/CLB)      |        ❌         |         ✅           |
+| Target Groups & Listeners                |        ❌         |         ✅           |
+| Elastic IP (EIP) Support                 |        ❌         |         ✅           |
+| Launch Templates                         |        ❌         |         ✅           |
+| Network Interfaces                       |        ❌         |         ✅           |
+| Dependency Scanning (`--with-deps`)      |        ❌         |         ✅           |
+| IAM Roles & Policies                     |        ❌         |         ✅           |
+| Advanced S3 Features (Versioning, ACLs)  |        ❌         |         ✅           |
+| Cross-Resource Analysis                  |        ❌         |         ✅           |
+| Bulk Import Commands                     |        ❌         |         ✅           |
+| Premium Support & Updates                |        ❌         |         ✅           |

terraback-0.2.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: terraback
+Version: 0.2.0
+Summary: A tool for managing Terraform configurations
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3
+Requires-Dist: typer
+Requires-Dist: jinja2
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Terraback
+
+Terraback is a CLI tool that helps DevOps engineers generate Terraform code from existing AWS infrastructure with automatic dependency discovery.
+
+**Automate Terraform adoption for legacy environments with zero guesswork.**
+
+## 🚀 Features
+
+✅ **Extensive Resource Coverage**: Scan a wide range of AWS services, including:
+
+- **EC2**: Instances, EBS Volumes, EBS Snapshots, AMIs, Key Pairs, Launch Templates, Network Interfaces
+- **RDS**: DB Instances, DB Subnet Groups, DB Parameter Groups
+- **VPC**: VPCs, Subnets, Security Groups
+- **IAM**: Roles and Policies
+- **S3**: Buckets with Versioning and Public Access Block configurations
+- **EIP**: Elastic IP Addresses
+- **Load Balancing**: Application (ALB), Network (NLB), Gateway (GWLB), and Classic (CLB) Load Balancers, including Listeners and Target Groups
+
+✅ **Automatic Dependency Scanning**: Start with a single resource (like an EC2 instance) and use the `--with-deps` flag to automatically find and scan all its dependencies.
+
+✅ **Intelligent Code Generation**: Generates clean, formatted, and best-practice Terraform code (`.tf`) from your existing infrastructure.
+
+✅ **Seamless Terraform Integration**:
+- `terraback <service> import <id>` command provides a simple wrapper around `terraform import`
+- `terraback <service> list` helps you find resource IDs needed for import
+
+✅ **Helper Utilities**: Includes commands to list generated resources, analyse the output, and clean-all generated files to start fresh.
+
+✅ **Flexible & Configurable**: Supports AWS profiles, regions, and custom output directories.
+
+## 📦 Installation
+
+It is highly recommended to install Terraback within a Python virtual environment.
+
+**Clone the repository:**
+```bash
+git clone https://github.com/bmoldo/terraback.git
+cd terraback
+```
+
+**Create and activate a virtual environment:**
+```bash
+python -m venv .venv
+
+# On Windows (PowerShell)
+.\.venv\Scripts\Activate.ps1
+
+# On Linux/macOS
+source .venv/bin/activate
+```
+
+**Install Terraback in editable mode:**
+```bash
+pip install -e .
+```
+
+## ⚙️ Usage
+
+Run `terraback --help` to see all available service commands. Run `terraback <service> --help` for details on a specific service.
+
+### Global Options
+
+- `--profile TEXT`: AWS CLI profile to use
+- `--region TEXT`: AWS region (defaults to us-east-1)
+- `--output-dir DIRECTORY` / `-o DIRECTORY`: Directory to save or read generated files (defaults to generated)
+
+### General Commands
+
+- `terraback analyse`: Shows a summary of all scanned resources
+- `terraback list all`: Lists all resources from all `*_import.json` files in the output directory
+- `terraback clean all`: Removes all generated `.tf` and `_import.json` files
+
+### Service Commands
+
+#### Load Balancers (`terraback elbv2 ...` and `terraback elb ...`)
+- `terraback elbv2 scan-lbs`: Scans for modern Load Balancers (ALB, NLB, GWLB)
+- `terraback elbv2 scan-tgs`: Scans for Target Groups
+- `terraback elbv2 scan-listeners`: Scans for Listeners
+- `terraback elb scan-classic`: Scans for Classic Load Balancers
+
+...and corresponding `list-*` and `import-*` commands for each resource.
+
+#### EC2 (`terraback ec2 ...`)
+- `terraback ec2 scan`: Scans for EC2 Instances
+  - `--with-deps`: Automatically scans all dependencies (VPC, Subnet, SG, IAM Role, Volumes, LBs, etc.)
+- `terraback ec2 scan-volumes`: Scans for EBS Volumes
+
+...and many more.
+
+#### RDS (`terraback rds ...`)
+- `terraback rds scan-instances`: Scans for RDS DB Instances
+- `terraback rds scan-subnet-groups`: Scans for RDS DB Subnet Groups
+
+...and more.
+
+*(For a full list of commands, run `terraback --help`)*
+
+## 🎯 Dependency Scanning
+
+Terraback's most powerful feature is automatic dependency discovery. When you scan an EC2 instance with `--with-deps`, it automatically finds and scans:
+
+- **Networking**: VPC, Subnet, Security Groups, Network Interfaces, EIPs
+- **Load Balancing**: ALBs, NLBs, CLBs, Target Groups, Listeners
+- **Compute**: AMIs, Launch Templates, Key Pairs
+- **Storage**: EBS Volumes and their Snapshots
+- **Permissions**: IAM Roles
+
+### Example Output
+
+```bash
+$ terraback ec2 scan --with-deps -o my-app
+[RECURSIVE_SCAN] Calling scan for: ec2 with output_dir: my-app
+Scanning for EC2 instances in region us-east-1...
+Generated Terraform for 1 EC2 instances -> my-app\ec2.tf
+...
+[RECURSIVE_SCAN] Calling scan for: elbv2_target_group with output_dir: my-app
+Scanning for Target Groups in region us-east-1...
+Generated Terraform for 1 Target Groups -> my-app\elbv2_target_group.tf
+...
+```
+
+This creates a complete infrastructure snapshot with all dependencies automatically discovered!
+
+## 🧭 What's Next (Roadmap)
+
+- [x] ~~Add support for more AWS services~~ (RDS & Load Balancer Support Added!)
+- 🔄 Expand dependency scanning to even more resources
+- 🔗 Enhanced relationship mapping between resources
+- 📝 Generate Terraform modules instead of flat configurations
+- 🎨 Web UI for visualizing infrastructure dependencies
+- ☁️ Support for other cloud providers (Azure, GCP)
+
+## ⚖️ License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

terraback-0.2.0/README.md

@@ -0,0 +1,135 @@
+# Terraback
+
+Terraback is a CLI tool that helps DevOps engineers generate Terraform code from existing AWS infrastructure with automatic dependency discovery.
+
+**Automate Terraform adoption for legacy environments with zero guesswork.**
+
+## 🚀 Features
+
+✅ **Extensive Resource Coverage**: Scan a wide range of AWS services, including:
+
+- **EC2**: Instances, EBS Volumes, EBS Snapshots, AMIs, Key Pairs, Launch Templates, Network Interfaces
+- **RDS**: DB Instances, DB Subnet Groups, DB Parameter Groups
+- **VPC**: VPCs, Subnets, Security Groups
+- **IAM**: Roles and Policies
+- **S3**: Buckets with Versioning and Public Access Block configurations
+- **EIP**: Elastic IP Addresses
+- **Load Balancing**: Application (ALB), Network (NLB), Gateway (GWLB), and Classic (CLB) Load Balancers, including Listeners and Target Groups
+
+✅ **Automatic Dependency Scanning**: Start with a single resource (like an EC2 instance) and use the `--with-deps` flag to automatically find and scan all its dependencies.
+
+✅ **Intelligent Code Generation**: Generates clean, formatted, and best-practice Terraform code (`.tf`) from your existing infrastructure.
+
+✅ **Seamless Terraform Integration**:
+- `terraback <service> import <id>` command provides a simple wrapper around `terraform import`
+- `terraback <service> list` helps you find resource IDs needed for import
+
+✅ **Helper Utilities**: Includes commands to list generated resources, analyse the output, and clean-all generated files to start fresh.
+
+✅ **Flexible & Configurable**: Supports AWS profiles, regions, and custom output directories.
+
+## 📦 Installation
+
+It is highly recommended to install Terraback within a Python virtual environment.
+
+**Clone the repository:**
+```bash
+git clone https://github.com/bmoldo/terraback.git
+cd terraback
+```
+
+**Create and activate a virtual environment:**
+```bash
+python -m venv .venv
+
+# On Windows (PowerShell)
+.\.venv\Scripts\Activate.ps1
+
+# On Linux/macOS
+source .venv/bin/activate
+```
+
+**Install Terraback in editable mode:**
+```bash
+pip install -e .
+```
+
+## ⚙️ Usage
+
+Run `terraback --help` to see all available service commands. Run `terraback <service> --help` for details on a specific service.
+
+### Global Options
+
+- `--profile TEXT`: AWS CLI profile to use
+- `--region TEXT`: AWS region (defaults to us-east-1)
+- `--output-dir DIRECTORY` / `-o DIRECTORY`: Directory to save or read generated files (defaults to generated)
+
+### General Commands
+
+- `terraback analyse`: Shows a summary of all scanned resources
+- `terraback list all`: Lists all resources from all `*_import.json` files in the output directory
+- `terraback clean all`: Removes all generated `.tf` and `_import.json` files
+
+### Service Commands
+
+#### Load Balancers (`terraback elbv2 ...` and `terraback elb ...`)
+- `terraback elbv2 scan-lbs`: Scans for modern Load Balancers (ALB, NLB, GWLB)
+- `terraback elbv2 scan-tgs`: Scans for Target Groups
+- `terraback elbv2 scan-listeners`: Scans for Listeners
+- `terraback elb scan-classic`: Scans for Classic Load Balancers
+
+...and corresponding `list-*` and `import-*` commands for each resource.
+
+#### EC2 (`terraback ec2 ...`)
+- `terraback ec2 scan`: Scans for EC2 Instances
+  - `--with-deps`: Automatically scans all dependencies (VPC, Subnet, SG, IAM Role, Volumes, LBs, etc.)
+- `terraback ec2 scan-volumes`: Scans for EBS Volumes
+
+...and many more.
+
+#### RDS (`terraback rds ...`)
+- `terraback rds scan-instances`: Scans for RDS DB Instances
+- `terraback rds scan-subnet-groups`: Scans for RDS DB Subnet Groups
+
+...and more.
+
+*(For a full list of commands, run `terraback --help`)*
+
+## 🎯 Dependency Scanning
+
+Terraback's most powerful feature is automatic dependency discovery. When you scan an EC2 instance with `--with-deps`, it automatically finds and scans:
+
+- **Networking**: VPC, Subnet, Security Groups, Network Interfaces, EIPs
+- **Load Balancing**: ALBs, NLBs, CLBs, Target Groups, Listeners
+- **Compute**: AMIs, Launch Templates, Key Pairs
+- **Storage**: EBS Volumes and their Snapshots
+- **Permissions**: IAM Roles
+
+### Example Output
+
+```bash
+$ terraback ec2 scan --with-deps -o my-app
+[RECURSIVE_SCAN] Calling scan for: ec2 with output_dir: my-app
+Scanning for EC2 instances in region us-east-1...
+Generated Terraform for 1 EC2 instances -> my-app\ec2.tf
+...
+[RECURSIVE_SCAN] Calling scan for: elbv2_target_group with output_dir: my-app
+Scanning for Target Groups in region us-east-1...
+Generated Terraform for 1 Target Groups -> my-app\elbv2_target_group.tf
+...
+```
+
+This creates a complete infrastructure snapshot with all dependencies automatically discovered!
+
+## 🧭 What's Next (Roadmap)
+
+- [x] ~~Add support for more AWS services~~ (RDS & Load Balancer Support Added!)
+- 🔄 Expand dependency scanning to even more resources
+- 🔗 Enhanced relationship mapping between resources
+- 📝 Generate Terraform modules instead of flat configurations
+- 🎨 Web UI for visualizing infrastructure dependencies
+- ☁️ Support for other cloud providers (Azure, GCP)
+
+## ⚖️ License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

terraback-0.2.0/cli/aws/__init__.py

@@ -0,0 +1,3 @@
+# This file intentionally left blank.
+# Its presence makes the 'aws' directory a Python package,
+# allowing for the modular imports used in main.py.

terraback-0.2.0/cli/aws/apigateway/__init__.py

@@ -0,0 +1,25 @@
+import typer
+from pathlib import Path
+from .rest_apis import scan_rest_apis
+
+from terraback.utils.cross_scan_registry import register_scan_function, cross_scan_registry
+
+app = typer.Typer(
+    name="apigateway",
+    help="Manage API Gateway REST API resources.",
+    no_args_is_help=True
+)
+
+@app.command(name="scan-rest-apis", help="Scan REST APIs and all their sub-resources.")
+def scan_apis_command(output_dir: Path = typer.Option("generated"), profile: str = typer.Option(None), region: str = typer.Option("us-east-1")):
+    scan_rest_apis(output_dir, profile, region)
+
+# Note: list and import commands are omitted for now due to the complexity of nested resources.
+
+def register():
+    """Registers scan functions and dependencies for the API Gateway module."""
+    register_scan_function("api_gateway_rest_api", scan_rest_apis)
+
+    # Define dependencies
+    cross_scan_registry.register_dependency("api_gateway_integration", "lambda_function")
+    cross_scan_registry.register_dependency("lambda_function", "api_gateway_rest_api")