terraback 0.0.1__tar.gz

terraback-0.0.1/LICENSE

@@ -0,0 +1,120 @@
+# Terraback Licensing
+
+This project uses a multi-tier licensing model designed to support different use cases, from individual developers to enterprise teams.
+
+## Community Edition (MIT License)
+
+The Community Edition of Terraback is free and open source, perfect for individuals, students, and small projects.
+
+### 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.
+```
+
+## Commercial Editions
+
+### Migration Pass ($149 - One-Time)
+
+Perfect for consultants and teams with one-time migration projects.
+- **Duration**: 60 days from activation
+- **Users**: Single user/machine
+- **Features**: Full access to all scanning and import features
+- **Support**: Community support via GitHub
+
+### Professional Edition ($49/user/month or $499/user/year)
+
+Designed for DevOps teams who need ongoing infrastructure management.
+- **Duration**: Monthly or annual subscription
+- **Users**: Per-user licensing with authentication
+- **Features**: Everything in Migration Pass, plus drift detection and monitoring
+- **Support**: Priority email support
+
+### Enterprise Edition (Custom Pricing)
+
+For large organizations with specific requirements.
+- **Duration**: Annual contracts
+- **Users**: Flexible site licensing
+- **Features**: Everything in Professional, plus SSO, on-premise deployment
+- **Support**: Premium support with SLA
+
+## Feature Comparison
+
+| Feature                                  | Community | Migration Pass | Professional | Enterprise |
+|------------------------------------------|:---------:|:--------------:|:------------:|:----------:|
+| **Core Features**                        |           |                |              |            |
+| Basic Resource Scanning (EC2, VPC, S3)   |    ✅     |       ✅       |      ✅      |     ✅   |
+| CLI with `list` & `import` helpers       |    ✅     |       ✅       |      ✅      |     ✅   |
+| Resource Limit                           | 100/scan  |   Unlimited    |  Unlimited   | Unlimited  |
+| **Advanced Scanning**                    |           |                |              |            |
+| RDS & Database Resources                 |    ❌     |       ✅       |      ✅      |     ✅   |
+| Load Balancers (ALB/NLB/CLB)             |    ❌     |       ✅       |      ✅      |     ✅   |
+| Lambda & API Gateway                     |    ❌     |       ✅       |      ✅      |     ✅   |
+| Route 53 & DNS                           |    ❌     |       ✅       |      ✅      |     ✅   |
+| IAM Roles & Policies                     |    ❌     |       ✅       |      ✅      |     ✅    |
+| Full Dependency Analysis                 |    ❌     |       ✅       |      ✅      |     ✅    |
+| Cross-Account Scanning                   |    ❌     |       ❌       |      ✅      |     ✅    |
+| **Ongoing Features**                     |            |                |              |             |
+| Infrastructure Drift Detection           |    ❌     |       ❌       |      ✅      |     ✅    |
+| Scheduled Scans & Alerts                 |    ❌     |       ❌       |      ✅      |     ✅     |
+| Web Dashboard                            |    ❌     |       ❌       |      ✅      |     ✅     |
+| Compliance Reporting                     |    ❌     |       ❌       |      ✅      |     ✅     |
+| **Enterprise Features**                  |            |                |              |              |
+| Single Sign-On (SSO)                     |    ❌     |       ❌       |      ❌      |     ✅     |
+| On-Premise Deployment                    |    ❌     |       ❌       |      ❌      |     ✅     |
+| Custom Resource Scanners                 |    ❌     |       ❌       |      ❌      |     ✅     |
+| API Access                               |    ❌     |       ❌       |      ❌      |     ✅      |
+| **Support & Updates**                    |            |                 |               |              |
+| Community Support                        |    ✅     |       ✅       |      ✅      |     ✅     |
+| Email Support                            |    ❌     |       ❌       |      ✅      |     ✅      |
+| Priority Support & SLA                   |    ❌     |       ❌       |      ❌      |     ✅      |
+| Automatic Updates                        |    ✅     |       ✅       |      ✅      |     ✅      |
+
+## License Activation
+
+### Community Edition
+No activation required. Install and use immediately:
+```bash
+pip install terraback
+```
+
+### Migration Pass & Professional
+After purchase, activate your license:
+```bash
+terraback activate --license-key=XXXX-XXXX-XXXX-XXXX
+```
+
+### Enterprise Edition
+Custom deployment and activation process. Contact sales for details.
+
+## Purchasing
+
+- **Migration Pass**: Purchase at [terraback.io/purchase](https://terraback.io/purchase)
+- **Professional**: Subscribe at [terraback.io/subscribe](https://terraback.io/subscribe)
+- **Enterprise**: Contact sales@terraback.io
+
+## Questions?
+
+- **Sales**: sales@terraback.io
+- **Support**: support@terraback.io
+- **Community**: [GitHub Discussions](https://github.com/terraback/terraback/discussions)

terraback-0.0.1/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include terraback/templates *.j2

terraback-0.0.1/PKG-INFO

@@ -0,0 +1,479 @@
+Metadata-Version: 2.4
+Name: terraback
+Version: 0.0.1
+Summary: Multi-Cloud Infrastructure as Code - Community Edition
+Home-page: https://github.com/bmoldo/terraback
+Author: Reops Tech
+Author-email: hello@terraback.io
+Project-URL: Bug Reports, https://github.com/bmoldo/terraback/issues
+Project-URL: Source, https://github.com/bmoldo/terraback
+Project-URL: Website, https://www.terraback.dev.io
+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.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3==1.38.21
+Requires-Dist: botocore==1.38.21
+Requires-Dist: azure-identity==1.15.0
+Requires-Dist: azure-mgmt-resource==23.1.0
+Requires-Dist: azure-mgmt-compute==31.0.0
+Requires-Dist: azure-mgmt-network==27.0.0
+Requires-Dist: azure-mgmt-storage==21.2.0
+Requires-Dist: azure-mgmt-web==7.3.0
+Requires-Dist: azure-mgmt-sql==3.0.1
+Requires-Dist: azure-mgmt-keyvault==10.3.0
+Requires-Dist: azure-mgmt-monitor==6.0.0
+Requires-Dist: azure-core==1.30.0
+Requires-Dist: click==8.1.8
+Requires-Dist: typer==0.15.4
+Requires-Dist: colorama==0.4.6
+Requires-Dist: rich==14.0.0
+Requires-Dist: Pygments==2.19.1
+Requires-Dist: Jinja2==3.1.6
+Requires-Dist: MarkupSafe==3.0.2
+Requires-Dist: jmespath==1.0.1
+Requires-Dist: markdown-it-py==3.0.0
+Requires-Dist: mdurl==0.1.2
+Requires-Dist: python-dateutil==2.9.0.post0
+Requires-Dist: shellingham==1.5.4
+Requires-Dist: six==1.17.0
+Requires-Dist: typing_extensions==4.13.2
+Requires-Dist: urllib3<2.0,>=1.26.0
+Requires-Dist: s3transfer==0.12.0
+Requires-Dist: google-cloud-compute==1.14.0
+Requires-Dist: google-cloud-storage==2.10.0
+Requires-Dist: google-cloud-resource-manager==1.10.0
+Requires-Dist: google-auth==2.23.0
+Provides-Extra: aws
+Requires-Dist: boto3>=1.38.21; extra == "aws"
+Requires-Dist: botocore>=1.38.21; extra == "aws"
+Requires-Dist: s3transfer>=0.12.0; extra == "aws"
+Provides-Extra: azure
+Requires-Dist: azure-identity>=1.15.0; extra == "azure"
+Requires-Dist: azure-mgmt-resource>=23.1.0; extra == "azure"
+Requires-Dist: azure-mgmt-compute>=31.0.0; extra == "azure"
+Requires-Dist: azure-mgmt-network>=27.0.0; extra == "azure"
+Requires-Dist: azure-mgmt-storage>=21.2.0; extra == "azure"
+Requires-Dist: azure-mgmt-web>=7.3.0; extra == "azure"
+Requires-Dist: azure-mgmt-sql>=4.0.0; extra == "azure"
+Requires-Dist: azure-mgmt-keyvault>=10.3.0; extra == "azure"
+Requires-Dist: azure-mgmt-monitor>=6.0.0; extra == "azure"
+Requires-Dist: azure-core>=1.30.0; extra == "azure"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 🚀 Terraback
+
+**Enterprise Infrastructure Discovery Platform**
+
+Terraback is an advanced CLI tool that reverse-engineers existing cloud infrastructure into clean, production-ready Terraform code with intelligent dependency discovery.
+
+**Transform legacy cloud environments into infrastructure-as-code in minutes, not months.**
+
+---
+
+## ✨ Why Terraback?
+
+- **🎯 90% Faster**: Reduce infrastructure documentation time from weeks to hours  
+- **🧠 Intelligent Discovery**: Automatic dependency mapping across 50+ cloud services  
+- **🏢 Enterprise-Grade**: Production-ready templates with lifecycle management  
+- **☁️ Multi-Cloud**: Full support for AWS and Azure, with GCP coming soon  
+- **🔒 Security-First**: Read-only permissions, no credential storage, enterprise compliance
+
+---
+
+## 🌟 Features
+
+### 📊 Comprehensive Cloud Coverage
+
+**Core Infrastructure (Community Edition - Free):**
+
+- **AWS**: EC2 Instances, VPCs, Subnets, Security Groups, S3 Buckets, IAM Roles
+- **Azure**: Virtual Machines, Virtual Networks, Subnets, Network Security Groups, Storage Accounts
+- **Basic Commands**: list, import, scan (limited to 100 resources)
+
+**Advanced Services (Professional Edition):**
+
+**AWS Services:**
+- **Container Platform**: ECS Clusters, Services, Task Definitions, ECR Repositories
+- **Advanced Networking**: CloudFront CDN, Route 53 DNS, NAT/Internet Gateways, VPC Endpoints
+- **Database & Caching**: RDS instances, ElastiCache Redis/Memcached clusters
+- **Monitoring & Security**: CloudWatch, Auto Scaling, ACM Certificates
+- **Serverless & APIs**: Lambda Functions, API Gateway, SQS, SNS
+- **Storage**: EFS, EBS Volumes/Snapshots, S3 advanced features
+- **Load Balancing**: ALB/NLB with advanced features, listener rules, SSL policies
+
+**Azure Services:**
+- **Compute**: Virtual Machines with OS detection, Managed Disks, SSH Keys
+- **Networking**: Virtual Networks, Subnets with delegations, NSGs with rules
+- **Storage**: Storage Accounts with blob properties, static websites, encryption
+- **Load Balancing**: Application Gateway, Load Balancers (coming soon)
+- **Database**: Azure SQL, Cosmos DB (coming soon)
+- **Container**: AKS, Container Instances (coming soon)
+
+### 🔗 Intelligent Dependency Discovery
+
+The `--with-deps` flag automatically discovers and maps complete infrastructure stacks:
+
+```bash
+# AWS Example
+terraback ec2 scan --with-deps
+# Automatically finds and scans:
+# ├── VPC and networking (subnets, security groups)
+# ├── Load balancers (ALB, target groups, listeners)
+# ├── Storage (EBS volumes, snapshots)
+# ├── Security (IAM roles, certificates)
+# ├── Monitoring (CloudWatch logs, alarms)
+# └── All interconnected dependencies
+
+# Azure Example
+terraback vm scan --with-deps
+# Automatically finds and scans:
+# ├── Virtual Networks and Subnets
+# ├── Network Security Groups with rules
+# ├── Managed Disks and Snapshots
+# ├── Network Interfaces and Public IPs
+# ├── Storage Accounts
+# └── All interconnected dependencies
+```
+
+### 🚀 Advanced Features
+
+- **Performance Optimization**: API response caching, parallel scanning, smart dependency resolution
+- **Multi-Account/Subscription**: Scan across multiple AWS accounts or Azure subscriptions
+- **Module Generation**: Create reusable Terraform modules automatically
+- **State Management**: Import existing resources directly into Terraform state
+- **Compliance Ready**: Generate code following HashiCorp and cloud provider best practices
+
+---
+
+## 📦 Installation
+
+### Prerequisites
+- Python 3.8+ (for pip installation)
+- Terraform 1.0+ (for import functionality)
+- Cloud CLI tools:
+  - AWS: `aws` CLI configured
+  - Azure: `az` CLI configured and logged in
+
+### Install via pip (Recommended)
+
+```bash
+pip install terraback
+```
+
+### Install via Binary
+
+**Linux/macOS:**
+```bash
+# Linux
+curl -L https://dist.terraback.dev.io/releases/latest/terraback-linux -o terraback
+chmod +x terraback
+sudo mv terraback /usr/local/bin/
+
+# macOS
+curl -L https://dist.terraback.dev.io/releases/latest/terraback-macos -o terraback
+chmod +x terraback
+sudo mv terraback /usr/local/bin/
+```
+
+**Windows:**
+Download from [releases](https://dist.terraback.dev.io/releases/latest/terraback-windows.exe)
+
+---
+
+## 🚀 Quick Start
+
+### AWS Scanning
+
+```bash
+# Configure AWS credentials (if not already done)
+aws configure
+
+# Scan EC2 instances
+terraback ec2 scan
+
+# Scan VPC with all dependencies
+terraback vpc scan --with-deps
+
+# Scan specific region
+terraback ec2 scan --region eu-west-1
+
+# Scan with specific profile
+terraback s3 scan --profile production
+```
+
+### Azure Scanning
+
+```bash
+# Login to Azure (if not already done)
+az login
+
+# Scan Virtual Machines
+terraback vm scan
+
+# Scan entire resource group
+terraback vm scan --resource-group production-rg
+
+# Scan specific subscription
+terraback vnet scan --subscription-id YOUR-SUBSCRIPTION-ID
+
+# Scan with location filter
+terraback storage scan --location westeurope
+```
+
+### Multi-Cloud Commands
+
+```bash
+# Scan all resources (cloud-specific)
+terraback scan-all aws --region us-east-1
+terraback scan-all azure --resource-group my-rg
+
+# Check authentication status
+terraback auth-check
+
+# Use caching for large infrastructures
+terraback scan-recursive ec2 --use-cache --cache-ttl 120
+terraback scan-recursive vm --use-cache --parallel-workers 10
+```
+
+---
+
+## 📋 Supported Resources
+
+### AWS Resources (Full Support)
+
+| Service | Resources | Status |
+|---------|-----------|---------|
+| **EC2** | Instances, Volumes, Snapshots, AMIs, Key Pairs, Launch Templates, Network Interfaces | ✅ Full Support |
+| **VPC** | VPCs, Subnets, Security Groups, Internet/NAT Gateways, Route Tables, VPC Endpoints | ✅ Full Support |
+| **IAM** | Roles, Policies, Instance Profiles | ✅ Full Support |
+| **S3** | Buckets, Versioning, Lifecycle, ACLs, Policies | ✅ Full Support |
+| **RDS** | Instances, Subnet Groups, Parameter Groups | ✅ Full Support |
+| **Load Balancing** | ALB, NLB, CLB, Target Groups, Listeners, SSL Policies | ✅ Full Support |
+| **Lambda** | Functions, Layers, Permissions | ✅ Full Support |
+| **Route 53** | Hosted Zones, Records | ✅ Full Support |
+| **CloudWatch** | Log Groups, Alarms, Dashboards | ✅ Full Support |
+| **Auto Scaling** | Groups, Launch Templates, Policies | ✅ Full Support |
+| **ECS/ECR** | Clusters, Services, Task Definitions, Repositories | ✅ Full Support |
+| **CloudFront** | Distributions, Origin Access Controls, Cache Policies | ✅ Full Support |
+| **ElastiCache** | Redis/Memcached Clusters, Parameter Groups | ✅ Full Support |
+| **ACM** | Certificates | ✅ Full Support |
+| **EFS** | File Systems, Mount Targets, Access Points | ✅ Full Support |
+| **API Gateway** | REST APIs, Resources, Methods, Deployments | ✅ Full Support |
+| **SQS/SNS** | Queues, Topics, Subscriptions | ✅ Full Support |
+| **Secrets Manager** | Secrets, Versions | ✅ Full Support |
+| **Systems Manager** | Parameters, Documents | ✅ Full Support |
+
+### Azure Resources (New!)
+
+| Service | Resources | Status |
+|---------|-----------|---------|
+| **Compute** | Virtual Machines, Managed Disks, Availability Sets, SSH Keys | ✅ Full Support |
+| **Networking** | Virtual Networks, Subnets, Network Security Groups, Network Interfaces | ✅ Full Support |
+| **Storage** | Storage Accounts, Blob Storage, File Shares | ✅ Full Support |
+| **Load Balancing** | Load Balancers, Application Gateways | 🚧 In Progress |
+| **Database** | SQL Database, Cosmos DB | 🔜 Coming Soon |
+| **Container** | AKS, Container Instances | 🔜 Coming Soon |
+| **Identity** | Managed Identities, Service Principals | 🔜 Coming Soon |
+
+### GCP Resources (Coming Q3 2025)
+
+| Service | Resources | Status |
+|---------|-----------|---------|
+| **Compute Engine** | Instances, Disks, Images | 🔮 Planned |
+| **VPC** | Networks, Subnets, Firewalls | 🔮 Planned |
+| **Cloud Storage** | Buckets, Objects | 🔮 Planned |
+| **GKE** | Clusters, Node Pools | 🔮 Planned |
+
+---
+
+## 🎯 Advanced Usage
+
+### Dependency Scanning
+
+```bash
+# AWS: Scan EC2 with all dependencies
+terraback ec2 scan --with-deps --output-dir ./infrastructure
+
+# Azure: Scan VM with all dependencies  
+terraback vm scan --with-deps --output-dir ./infrastructure
+
+# Result: Complete infrastructure graph
+# ├── compute/
+# │   ├── instances.tf
+# │   └── launch_templates.tf
+# ├── networking/
+# │   ├── vpc.tf
+# │   ├── subnets.tf
+# │   └── security_groups.tf
+# └── storage/
+#     ├── volumes.tf
+#     └── snapshots.tf
+```
+
+### Caching & Performance
+
+```bash
+# Enable caching for large infrastructures
+terraback scan-recursive ec2 --use-cache --cache-ttl 60
+
+# View cache statistics
+terraback cache stats
+
+# Clear cache
+terraback cache clear
+
+# Parallel scanning
+terraback scan-recursive vm --parallel-workers 10
+```
+
+### Import to Terraform
+
+```bash
+# List discovered resources
+terraback list all
+
+# Import specific resource
+terraback ec2 import i-1234567890abcdef0
+
+# Import Azure VM
+terraback vm import /subscriptions/xxx/resourceGroups/my-rg/providers/Microsoft.Compute/virtualMachines/my-vm
+```
+
+---
+
+## ⚖️ License
+
+Terraback uses a multi-tier licensing model:
+
+### Community Edition (MIT License)
+- ✅ Free forever
+- ✅ Basic resource scanning (EC2, VPC, S3 for AWS; VMs, VNets for Azure)
+- ✅ Up to 100 resources per scan
+- ❌ No dependency scanning
+- ❌ Limited to basic services
+
+### Professional Edition ($49/month or $499/year)
+- ✅ All Community features
+- ✅ Unlimited resources
+- ✅ All cloud services
+- ✅ Dependency scanning (`--with-deps`)
+- ✅ API response caching
+- ✅ Priority support
+
+### Migration Pass ($149 one-time, 60 days)
+- ✅ All Professional features
+- ✅ Perfect for migration projects
+- ✅ 60-day access
+- ✅ Email support
+
+### Enterprise Edition (Custom pricing)
+- ✅ All Professional features
+- ✅ SSO integration
+- ✅ On-premise deployment
+- ✅ Custom scanners
+- ✅ SLA support
+
+
+
+---
+
+## 📚 Documentation
+
+- [Full Documentation](https://docs.terraback.io)
+- [AWS Scanning Guide](https://docs.terraback.io/aws)
+- [Azure Scanning Guide](https://docs.terraback.io/azure)
+- [API Reference](https://docs.terraback.io/api)
+- [Examples & Tutorials](https://docs.terraback.io/examples)
+
+---
+
+## 🐛 Troubleshooting
+
+### AWS Issues
+
+```bash
+# Check AWS credentials
+aws sts get-caller-identity
+
+# Use specific profile
+export AWS_PROFILE=production
+
+# Debug mode
+terraback ec2 scan --debug
+```
+
+### Azure Issues
+
+```bash
+# Check Azure login
+az account show
+
+# Set subscription
+az account set --subscription "My Subscription"
+
+# List available subscriptions
+az account list --output table
+```
+
+### Common Issues
+
+1. **Permission Denied**: Ensure your cloud credentials have read access to resources
+2. **Rate Limiting**: Use `--use-cache` flag for large infrastructures
+3. **Module Not Found**: Install with `pip install -e .` for development
+
+---
+
+## 🚀 Roadmap
+
+- [x] AWS support (50+ services)
+- [x] Azure support (Core services)
+- [ ] GCP support (Q3 2025)
+- [ ] Kubernetes resources
+- [ ] Terraform module generation
+- [ ] Web UI dashboard
+- [ ] CI/CD integrations
+
+---
+
+## 📞 Support
+
+- **Community**: [Documentation Portal](https://docs.terraback.io/community)
+- **Issues & Feature Requests**: support@terraback.io
+- **Professional**: support@terraback.io
+- **Enterprise**: sales@terraback.io
+
+---
+
+## 🙏 Acknowledgments
+
+Built with ❤️ by DevOps engineers who understand the pain of manual cloud documentation.
+
+---
+
+**Copyright © 2025 Terraback**