stack-forge-infra 0.1.0__tar.gz

stack_forge_infra-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0   # hatch-vcs needs full history to derive the version
+      
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      
+      - name: Lint with ruff
+        run: |
+          ruff check src/
+          ruff format src/ --check
+      
+      - name: Run tests
+        run: |
+          pytest tests/ -v --tb=short

stack_forge_infra-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,142 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v[0-9]+.[0-9]+.[0-9]+"
+      - "v[0-9]+.[0-9]+.[0-9]+-*"   # pre-releases: v1.2.3-alpha.1
+
+permissions:
+  contents: write   # create GitHub Releases
+  id-token: write   # PyPI trusted publishing (OIDC)
+
+jobs:
+  # ── 1. Validate the tag format ────────────────────────────────────────────
+  validate-tag:
+    name: Validate tag
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.parse.outputs.version }}
+      prerelease: ${{ steps.parse.outputs.prerelease }}
+    steps:
+      - name: Parse tag
+        id: parse
+        run: |
+          TAG="${GITHUB_REF_NAME}"
+          VERSION="${TAG#v}"
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          if [[ "$TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "prerelease=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "prerelease=true" >> "$GITHUB_OUTPUT"
+          fi
+          echo "Releasing: ${TAG} (pre-release: $([[ '$TAG' =~ - ]] && echo true || echo false))"
+
+  # ── 2. Run test suite ─────────────────────────────────────────────────────
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    needs: validate-tag
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0   # hatch-vcs needs full history to derive version
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint
+        run: |
+          ruff check src/
+          ruff format src/ --check
+
+      - name: Run tests
+        run: pytest tests/ -v --tb=short
+
+  # ── 3. Build distribution ─────────────────────────────────────────────────
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install --upgrade build hatch-vcs
+
+      - name: Build wheel and sdist
+        run: python -m build
+
+      - name: Verify the build
+        run: |
+          pip install twine
+          twine check dist/*
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  # ── 4. Publish to PyPI ────────────────────────────────────────────────────
+  publish-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: pypi
+      url: https://pypi.org/p/stack-forge-infra
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # Uses OIDC trusted publishing — no API token needed.
+        # Configure a trusted publisher at https://pypi.org/manage/project/stack-forge-infra/settings/publishing/
+        # with: publisher = GitHub Actions, workflow = release.yml, environment = pypi
+
+  # ── 5. Create GitHub Release ──────────────────────────────────────────────
+  github-release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    needs: [validate-tag, publish-pypi]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: "v${{ needs.validate-tag.outputs.version }}"
+          tag_name: ${{ github.ref_name }}
+          prerelease: ${{ needs.validate-tag.outputs.prerelease }}
+          generate_release_notes: true
+          files: dist/*

stack_forge_infra-0.1.0/.gitignore

@@ -0,0 +1,49 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Auto-generated by hatch-vcs — do not commit
+src/stack_forge/_version.py
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# mypy
+.mypy_cache/
+
+# Ruff
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Generated infrastructure (keep examples)
+infrastructure/
+!examples/
+
+# Terraform
+*.tfstate
+*.tfstate.*
+.terraform/
+.terraform.lock.hcl

stack_forge_infra-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Praneeth Turlapati
+
+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.

stack_forge_infra-0.1.0/PKG-INFO

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: stack-forge-infra
+Version: 0.1.0
+Summary: Self-Service Infrastructure Templating Engine for Terraform & Terragrunt
+Project-URL: Homepage, https://github.com/pt1691/stack-forge
+Project-URL: Repository, https://github.com/pt1691/stack-forge
+Project-URL: Issues, https://github.com/pt1691/stack-forge/issues
+Author-email: Praneeth Turlapati <praneeth1691@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automation,aws,cli,devops,iac,infrastructure-as-code,templates,terraform,terragrunt
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.12
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-hcl2>=4.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: hatch-vcs>=0.4.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 🔨 Stack Forge
+
+[![CI](https://github.com/pt1691/stack-forge/actions/workflows/ci.yml/badge.svg)](https://github.com/pt1691/stack-forge/actions/workflows/ci.yml)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+
+> **Self-Service Infrastructure Templating Engine for Terraform & Terragrunt**
+
+A CLI tool that generates production-ready Terraform and Terragrunt configurations from reusable templates. Stop writing boilerplate infrastructure code and start deploying in minutes.
+
+## ⚡ 30-Second Quick Start
+
+```bash
+git clone https://github.com/pt1691/stack-forge.git && cd stack-forge
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e .
+forge list-templates  # See available templates!
+```
+
+**That's it!** Now create your first infrastructure:
+
+```bash
+mkdir my-infra && cd my-infra
+forge init --name my-app --org mycompany
+forge add-stack --name network --env dev
+forge add-resource --stack network --name main-vpc --type vpc
+forge generate  # Creates Terraform files!
+```
+
+---
+
+## ✨ Features
+
+- 🚀 **Quick Setup** - Generate complete infrastructure stacks with a few commands
+- 📦 **Pre-built Templates** - VPC, EKS, S3, RDS, Lambda, and more
+- 🔧 **Terragrunt Support** - DRY configurations with Terragrunt integration
+- 🏷️ **Consistent Tagging** - Automatic resource tagging across all resources
+- 🔒 **Security Best Practices** - Templates follow AWS security guidelines
+- 📝 **Customizable** - Extend with your own templates
+
+## 🚀 Installation
+
+```bash
+git clone https://github.com/pt1691/stack-forge.git
+cd stack-forge
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+## 📖 Workflow Example
+
+```bash
+# 1. Create a new project
+mkdir my-platform && cd my-platform
+forge init --name my-platform --org acmecorp
+
+# 2. Add a stack (environment + resource group)
+forge add-stack --name network --env dev
+
+# 3. Add resources to the stack
+forge add-resource --stack network --name main-vpc --type vpc
+forge add-resource --stack network --name logs --type s3_bucket
+
+# 4. Generate Terraform files
+forge generate
+
+# 5. Review what was created
+tree infrastructure/
+```
+
+## 📋 Commands
+
+| Command | Description |
+|---------|-------------|
+| `forge init` | Initialize a new Stack Forge project |
+| `forge add-stack` | Add a new infrastructure stack |
+| `forge add-resource` | Add a resource to a stack |
+| `forge generate` | Generate Terraform/Terragrunt files |
+| `forge show` | Show project configuration |
+| `forge validate` | Validate configuration |
+| `forge list-templates` | List available templates |
+
+## 📦 Available Templates
+
+| Template | Description |
+|----------|-------------|
+| `vpc` | VPC with public/private subnets, NAT gateways, flow logs |
+| `s3_bucket` | S3 bucket with versioning, encryption, lifecycle rules |
+| `eks` | EKS cluster with managed node groups, IRSA, encryption |
+| `rds` | RDS instance with Multi-AZ, automated backups |
+| `dynamodb` | DynamoDB table with auto-scaling |
+| `lambda` | Lambda function with IAM role, CloudWatch logs |
+| `iam_role` | IAM role with customizable policies |
+| `security_group` | Security group with configurable rules |
+| `secrets_manager` | Secrets Manager with rotation |
+| `ecr` | ECR repository with lifecycle policies |
+
+## 📁 Generated Structure
+
+```
+infrastructure/
+├── network/
+│   ├── providers.tf          # AWS provider configuration
+│   ├── backend.tf            # S3 backend for state
+│   ├── main.tf               # Module calls
+│   ├── terragrunt.hcl        # Terragrunt configuration
+│   └── modules/
+│       ├── main-vpc/
+│       │   ├── main.tf
+│       │   ├── variables.tf
+│       │   └── outputs.tf
+│       └── logs/
+│           ├── main.tf
+│           ├── variables.tf
+│           └── outputs.tf
+```
+
+## ⚙️ Configuration (forge.yaml)
+
+```yaml
+version: "1.0"
+name: my-platform
+organization: mycompany
+default_provider: aws
+default_region: us-west-2
+environments:
+  - dev
+  - staging
+  - prod
+
+stacks:
+  - name: network
+    environment: dev
+    region: us-west-2
+    use_terragrunt: true
+    resources:
+      - name: main-vpc
+        type: vpc
+        variables:
+          vpc_cidr: "10.0.0.0/16"
+          az_count: 3
+          enable_nat_gateway: true
+          
+      - name: logs
+        type: s3_bucket
+        variables:
+          versioning_enabled: true
+```
+
+## 🔧 Custom Templates
+
+Add your own templates in `~/.stack-forge/templates/`:
+
+```
+~/.stack-forge/templates/
+└── my_custom_resource/
+    ├── main.tf.j2
+    ├── variables.tf.j2
+    └── outputs.tf.j2
+```
+
+Templates use Jinja2 with these available variables:
+- `{{ name }}` - Resource name
+- `{{ environment }}` - Environment (dev/staging/prod)
+- `{{ region }}` - AWS region
+- `{{ variables }}` - Resource-specific variables
+- `{{ tags }}` - Merged tags
+
+## 📝 Best Practices
+
+1. **Use environments** - Create separate stacks for dev/staging/prod
+2. **DRY with Terragrunt** - Enable `use_terragrunt: true` for DRY configs
+3. **Consistent naming** - Use descriptive stack and resource names
+4. **Tag everything** - Define `global_tags` in your project config
+
+## 🧪 Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run linter
+ruff check .
+```
+
+## 📝 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## 🙋‍♂️ Author
+
+**Praneeth Turlapati**
+- LinkedIn: [linkedin.com/in/praneeth-turlapati](https://linkedin.com/in/praneeth-turlapati)
+- GitHub: [github.com/pt1691](https://github.com/pt1691)
+
+---
+
+⭐ **If you find this useful, please star the repository!**

stack_forge_infra-0.1.0/README.md

@@ -0,0 +1,203 @@
+# 🔨 Stack Forge
+
+[![CI](https://github.com/pt1691/stack-forge/actions/workflows/ci.yml/badge.svg)](https://github.com/pt1691/stack-forge/actions/workflows/ci.yml)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+
+> **Self-Service Infrastructure Templating Engine for Terraform & Terragrunt**
+
+A CLI tool that generates production-ready Terraform and Terragrunt configurations from reusable templates. Stop writing boilerplate infrastructure code and start deploying in minutes.
+
+## ⚡ 30-Second Quick Start
+
+```bash
+git clone https://github.com/pt1691/stack-forge.git && cd stack-forge
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e .
+forge list-templates  # See available templates!
+```
+
+**That's it!** Now create your first infrastructure:
+
+```bash
+mkdir my-infra && cd my-infra
+forge init --name my-app --org mycompany
+forge add-stack --name network --env dev
+forge add-resource --stack network --name main-vpc --type vpc
+forge generate  # Creates Terraform files!
+```
+
+---
+
+## ✨ Features
+
+- 🚀 **Quick Setup** - Generate complete infrastructure stacks with a few commands
+- 📦 **Pre-built Templates** - VPC, EKS, S3, RDS, Lambda, and more
+- 🔧 **Terragrunt Support** - DRY configurations with Terragrunt integration
+- 🏷️ **Consistent Tagging** - Automatic resource tagging across all resources
+- 🔒 **Security Best Practices** - Templates follow AWS security guidelines
+- 📝 **Customizable** - Extend with your own templates
+
+## 🚀 Installation
+
+```bash
+git clone https://github.com/pt1691/stack-forge.git
+cd stack-forge
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+## 📖 Workflow Example
+
+```bash
+# 1. Create a new project
+mkdir my-platform && cd my-platform
+forge init --name my-platform --org acmecorp
+
+# 2. Add a stack (environment + resource group)
+forge add-stack --name network --env dev
+
+# 3. Add resources to the stack
+forge add-resource --stack network --name main-vpc --type vpc
+forge add-resource --stack network --name logs --type s3_bucket
+
+# 4. Generate Terraform files
+forge generate
+
+# 5. Review what was created
+tree infrastructure/
+```
+
+## 📋 Commands
+
+| Command | Description |
+|---------|-------------|
+| `forge init` | Initialize a new Stack Forge project |
+| `forge add-stack` | Add a new infrastructure stack |
+| `forge add-resource` | Add a resource to a stack |
+| `forge generate` | Generate Terraform/Terragrunt files |
+| `forge show` | Show project configuration |
+| `forge validate` | Validate configuration |
+| `forge list-templates` | List available templates |
+
+## 📦 Available Templates
+
+| Template | Description |
+|----------|-------------|
+| `vpc` | VPC with public/private subnets, NAT gateways, flow logs |
+| `s3_bucket` | S3 bucket with versioning, encryption, lifecycle rules |
+| `eks` | EKS cluster with managed node groups, IRSA, encryption |
+| `rds` | RDS instance with Multi-AZ, automated backups |
+| `dynamodb` | DynamoDB table with auto-scaling |
+| `lambda` | Lambda function with IAM role, CloudWatch logs |
+| `iam_role` | IAM role with customizable policies |
+| `security_group` | Security group with configurable rules |
+| `secrets_manager` | Secrets Manager with rotation |
+| `ecr` | ECR repository with lifecycle policies |
+
+## 📁 Generated Structure
+
+```
+infrastructure/
+├── network/
+│   ├── providers.tf          # AWS provider configuration
+│   ├── backend.tf            # S3 backend for state
+│   ├── main.tf               # Module calls
+│   ├── terragrunt.hcl        # Terragrunt configuration
+│   └── modules/
+│       ├── main-vpc/
+│       │   ├── main.tf
+│       │   ├── variables.tf
+│       │   └── outputs.tf
+│       └── logs/
+│           ├── main.tf
+│           ├── variables.tf
+│           └── outputs.tf
+```
+
+## ⚙️ Configuration (forge.yaml)
+
+```yaml
+version: "1.0"
+name: my-platform
+organization: mycompany
+default_provider: aws
+default_region: us-west-2
+environments:
+  - dev
+  - staging
+  - prod
+
+stacks:
+  - name: network
+    environment: dev
+    region: us-west-2
+    use_terragrunt: true
+    resources:
+      - name: main-vpc
+        type: vpc
+        variables:
+          vpc_cidr: "10.0.0.0/16"
+          az_count: 3
+          enable_nat_gateway: true
+          
+      - name: logs
+        type: s3_bucket
+        variables:
+          versioning_enabled: true
+```
+
+## 🔧 Custom Templates
+
+Add your own templates in `~/.stack-forge/templates/`:
+
+```
+~/.stack-forge/templates/
+└── my_custom_resource/
+    ├── main.tf.j2
+    ├── variables.tf.j2
+    └── outputs.tf.j2
+```
+
+Templates use Jinja2 with these available variables:
+- `{{ name }}` - Resource name
+- `{{ environment }}` - Environment (dev/staging/prod)
+- `{{ region }}` - AWS region
+- `{{ variables }}` - Resource-specific variables
+- `{{ tags }}` - Merged tags
+
+## 📝 Best Practices
+
+1. **Use environments** - Create separate stacks for dev/staging/prod
+2. **DRY with Terragrunt** - Enable `use_terragrunt: true` for DRY configs
+3. **Consistent naming** - Use descriptive stack and resource names
+4. **Tag everything** - Define `global_tags` in your project config
+
+## 🧪 Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run linter
+ruff check .
+```
+
+## 📝 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## 🙋‍♂️ Author
+
+**Praneeth Turlapati**
+- LinkedIn: [linkedin.com/in/praneeth-turlapati](https://linkedin.com/in/praneeth-turlapati)
+- GitHub: [github.com/pt1691](https://github.com/pt1691)
+
+---
+
+⭐ **If you find this useful, please star the repository!**