Metadata-Version: 2.4
Name: devops-project-generator
Version: 2.0.0
Summary: A CLI tool and modern web UI that scaffolds production-ready DevOps repositories with advanced features
Author-email: NotHarshhaa <devops-project-generator@notHarshhaa.com>
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer[all]>=0.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: click>=8.0.0
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: license-file

# 🚀 DevOps Project Generator 🚀

[![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)](https://pypi.org/project/devops-project-generator/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)

A powerful CLI tool and modern web UI that scaffolds production-ready DevOps repositories with ease, allowing you to quickly bootstrap complete DevOps projects by selecting user-friendly options for pipeline frameworks, infrastructure patterns, deployment strategies, observability stacks, and security compliance frameworks.

## ✨ Why DevOps Project Generator?

Setting up a real-world DevOps project from scratch is repetitive and error-prone. This tool helps you bootstrap a complete DevOps-ready repository in seconds, following industry best practices and modern DevOps patterns.

✔ Opinionated but configurable  
✔ DevOps-focused, production-oriented  
✔ CLI + Modern Web UI  
✔ Advanced configuration analysis  
✔ Real-time cost optimization  
✔ Project analytics dashboard  
✔ No tool lock-in  
✔ Modern DevOps patterns

## 🎯 Who Is This For?

- **DevOps Engineers**
- **Cloud Engineers** 
- **Platform Engineers**
- **SREs**
- **Infrastructure Engineers**
- **DevOps Architects**
- **Students & professionals building real DevOps projects**

## 🌟 Key Features

### Core Features
- **Fast DevOps project generation** - Generate complete projects in seconds
- **Interactive setup with modern UI** - Beautiful Next.js web interface
- **Pipeline framework selection** - Support for 8+ tech stacks
- **Infrastructure as Code patterns** - Terraform, CloudFormation, Ansible
- **Deployment strategy templates** - Blue-green, canary, GitOps, and more
- **Observability stack configurations** - Prometheus, ELK, DataDog, etc.
- **Security compliance frameworks** - NIST, CIS, SOC2, GDPR, HIPAA
- **Best practices project structure** - Industry-standard layouts
- **Multi-environment support** - Dev, staging, production configs
- **Integration-ready configurations** - Ready to deploy

### 🆕 New in v2.0.0: Advanced UI Features

#### 🔧 Advanced Configuration Builder
- **Dependency graph visualization** - See how components relate
- **Conflict detection** - Automatic incompatibility detection
- **Complexity scoring** - Understand your stack complexity (0-100)
- **Smart recommendations** - AI-powered optimization suggestions
- **Real-time validation** - Instant feedback on configurations

#### 💰 Cost Optimization Advisor
- **Monthly cost estimation** - Accurate cloud provider pricing
- **Cost breakdown by category** - Infrastructure, observability, CI/CD, security
- **Optimization recommendations** - Save up to 70% on cloud costs
- **Savings calculator** - See potential monthly savings
- **Multi-environment costing** - Account for all environments

#### 📊 Project Analytics Dashboard
- **Real-time tracking** - Track all your generated projects
- **Technology distribution** - See your most-used technologies
- **Popular combinations** - Learn from successful patterns
- **Trending analysis** - Identify growing technologies
- **Privacy-first** - All data stored locally in browser

## 🖥️ Usage

### Quick Start

```bash
# Install
pip install devops-project-generator

# Generate a project
devops-project-generator init --name my-infra --pipeline nodejs-typescript --infra aws-vpc-eks --deploy blue-green

# Web UI with Advanced Features (v2.0.0)
cd web-ui && npm install && npm run dev
# Visit http://localhost:3000
# Features: Generator, Config Builder, Cost Advisor, Analytics
```

### Documentation

- 📖 **[Commands Reference](COMMANDS.md)** - Complete command documentation
- 🎯 **[Usage Examples](EXAMPLES.md)** - Practical examples and workflows
- 📋 **[DevOps Patterns Guide](DEVOPS_PATTERNS.md)** - DevOps pattern customization guide

## 🧠 What This Generator Creates

A complete DevOps project structure covering:
- **Pipeline Frameworks** - CI/CD templates for various tech stacks
- **Infrastructure Patterns** - Terraform, CloudFormation, Ansible templates
- **Deployment Strategies** - Blue-green, canary, rolling, GitOps configurations
- **Observability Stacks** - Prometheus, Grafana, ELK, DataDog integrations
- **Security Frameworks** - NIST CSF, CIS Benchmarks, Zero Trust, SOC2, GDPR, HIPAA
- **Environment Management** - Multi-environment configurations
- **Automation Scripts** - Setup, deployment, and maintenance scripts

All generated based on your selected DevOps options.

## 🎨 Web UI Features

The modern web interface includes four powerful tabs:

### 1. 🚀 Generator Tab
- Step-by-step project configuration
- Visual option cards with descriptions
- Real-time validation
- Instant project generation
- Download as ZIP

### 2. 🔧 Config Builder Tab
- Dependency graph visualization
- Conflict detection and warnings
- Complexity scoring (Simple/Moderate/Complex)
- Smart recommendations
- Configuration validation

### 3. 💰 Cost Advisor Tab
- Monthly cost estimation
- Cost breakdown by component
- Optimization recommendations
- Potential savings calculator
- Difficulty and impact ratings

### 4. 📊 Analytics Tab
- Total projects generated
- Technology distribution charts
- Popular stack combinations
- Trending technologies
- Real-time statistics

## ⚙️ Supported Options (v2.0.0)

### 🔄 Pipeline Frameworks
- **Node.js + TypeScript** - Modern JavaScript/TypeScript pipelines
- **Python** - Python application pipelines
- **Java + Maven** - Enterprise Java pipelines
- **Go** - Go application pipelines
- **Docker Multi-Stage** - Containerized application pipelines
- **Terraform Module** - Infrastructure module pipelines
- **Kubernetes Operator** - Kubernetes operator pipelines
- **Microservice** - Microservice architecture pipelines

### ☁️ Infrastructure Patterns
- **AWS VPC + EKS** - Amazon EKS with VPC networking
- **Azure VNet + AKS** - Azure AKS with virtual networking
- **GCP VPC + GKE** - Google GKE with VPC networking
- **Multi-Cloud Terraform** - Cross-cloud infrastructure
- **Kubernetes On-Prem** - On-premises Kubernetes
- **AWS ECS Fargate** - Serverless container orchestration
- **Ansible Automation** - Configuration management

### 🚀 Deployment Strategies
- **Blue-Green** - Zero-downtime deployments
- **Canary** - Gradual rollout deployments
- **Rolling Updates** - Incremental updates
- **GitOps with ArgoCD** - Git-based continuous deployment
- **Helm Charts** - Kubernetes package management
- **Kustomize** - Kubernetes configuration management
- **Serverless Lambda** - AWS Lambda deployments

### 📊 Observability Stacks
- **Prometheus + Grafana** - Metrics and visualization
- **ELK Stack** - Elasticsearch, Logstash, Kibana
- **DataDog** - Full-stack monitoring
- **Jaeger + Prometheus** - Distributed tracing and metrics
- **AWS CloudWatch** - AWS native monitoring
- **New Relic** - Application performance monitoring

### 🔒 Security Frameworks
- **NIST CSF** - NIST Cybersecurity Framework
- **CIS Benchmarks** - Center for Internet Security controls
- **Zero Trust** - Zero Trust Architecture
- **SOC2 Compliance** - Service Organization Control 2
- **GDPR Compliance** - General Data Protection Regulation
- **HIPAA Compliance** - Health Insurance Portability and Accountability Act

### 🌍 Environments
- **Single** - Single environment setup
- **Dev / Stage / Prod** - Multi-environment setup
- **Custom** - Custom environment configuration

## 📦 Installation

### From PyPI

```bash
pip install devops-project-generator
```

### From Source

```bash
git clone https://github.com/NotHarshhaa/devops-project-generator.git
cd devops-project-generator
pip install -e .
```

### Web UI Setup

```bash
git clone https://github.com/NotHarshhaa/devops-project-generator.git
cd devops-project-generator/web-ui
npm install
npm run dev
```

### Development Setup

```bash
git clone https://github.com/NotHarshhaa/devops-project-generator.git
cd devops-project-generator
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e ".[dev]"
```

## 🏗️ Generated Project Structure

```
devops-project/
├── pipelines/           # CI/CD pipeline configurations
├── infrastructure/      # Terraform/CloudFormation templates
├── deployments/         # Helm charts, Kustomize configs
├── monitoring/          # Prometheus, Grafana, ELK configs
├── security/            # Security policies and compliance
├── scripts/             # Automation scripts
├── config/              # Multi-environment configs
└── docs/               # Documentation
```

For detailed structure information, see the **[DevOps Patterns Guide](DEVOPS_PATTERNS.md)**.

### DevOps Pattern Templates

The generator supports custom DevOps patterns. See the **[DevOps Patterns Guide](DEVOPS_PATTERNS.md)** for detailed information on creating and customizing DevOps patterns.

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

### Development Workflow

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Run the test suite
6. Submit a pull request

### Getting Help

- **Issues**: [GitHub Issues](https://github.com/NotHarshhaa/devops-project-generator/issues)
- **Discussions**: [GitHub Discussions](https://github.com/NotHarshhaa/devops-project-generator/discussions)
- **Documentation**: [Wiki](https://github.com/NotHarshhaa/devops-project-generator/wiki)

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- **Typer** - For the amazing CLI framework
- **Rich** - For beautiful terminal output
- **Jinja2** - For powerful templating
- **Next.js 16** - For the modern web UI
- **React 19** - For the UI components
- **shadcn/ui** - For beautiful UI components
- **Tailwind CSS** - For styling
- **Lucide Icons** - For icons
- **DevOps Community** - For best practices and inspiration

## 📞 Contact

This project is crafted with 💡 by **[Harshhaa](https://github.com/NotHarshhaa)**.  
Your feedback is always welcome! Let's build together. 🚀  

📧 **Connect with me:**  
🔗 **GitHub**: [@NotHarshhaa](https://github.com/NotHarshhaa)  
🔗 **Portfolio**: [Personal Portfolio](https://notharshhaa.site)  
🔗 **Links - Portfolio**: [Links](https://link.notharshhaa.site)  
🔗 **Telegram Community**: [Join Here](https://t.me/prodevopsguy)  
🔗 **LinkedIn**: [Harshhaa Vardhan Reddy](https://www.linkedin.com/in/NotHarshhaa/)  

---

**Built with ❤️ by the DevOps community**  
*Making DevOps accessible to everyone*
