fastforge-cli 0.0.1__tar.gz

fastforge_cli-0.0.1/LICENSE

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

fastforge_cli-0.0.1/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: fastforge-cli
+Version: 0.0.1
+Summary: Production-grade FastAPI project generator for Python backends
+Author-email: Jinna Balu <jinnabaalu@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/VibhuviOiO/fastforge-cli
+Project-URL: Repository, https://github.com/VibhuviOiO/fastforge-cli
+Project-URL: Issues, https://github.com/VibhuviOiO/fastforge-cli/issues
+Project-URL: Documentation, https://github.com/VibhuviOiO/fastforge-cli#readme
+Keywords: fastapi,cookiecutter,production,generator,scaffold,async,docker
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cookiecutter>=2.6.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: rich>=13.0.0
+Dynamic: license-file
+
+# 🔨 FastForge
+
+**Production-grade FastAPI project generator for Python backends.**
+
+[![PyPI](https://img.shields.io/pypi/v/fastforge-cli)](https://pypi.org/project/fastforge-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/fastforge-cli)](https://pypi.org/project/fastforge-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+FastForge generates a **ready-to-run, production-grade FastAPI project** with SOLID architecture, structured logging, Docker containerization, and async CRUD — all in under 30 seconds.
+
+## Quick Start
+
+```bash
+pip install fastforge-cli
+fastforge
+```
+
+That's it. Answer a few prompts and you get a running application.
+
+## What You Get (Basic Mode)
+
+| Feature | Implementation |
+|---|---|
+| **SOLID Architecture** | Repository pattern + Service layer + Dependency Injection |
+| **Async CRUD API** | FastAPI with full Create/Read/Update/Delete |
+| **Structured Logging** | structlog with JSON output, request IDs, duration tracking |
+| **Docker** | Multi-stage Dockerfile, docker-compose, health checks |
+| **Security** | Security headers middleware, CORS, non-root container |
+| **Testing** | pytest + pytest-asyncio, 80%+ coverage out of the box |
+| **Code Quality** | ruff linting, pre-commit hooks |
+
+## CLI Flow
+
+```
+$ fastforge
+
+  ___         _   ___
+ | __| _ _ __| |_| __|__ _ _ __ _ ___
+ | _/ _` (_-<  _| _/ _ \ '_/ _` / -_)
+ |_|\__,_/__/\__|_|\___/_| \__, \___|
+                            |___/
+ Production-grade FastAPI Generator
+
+┌─ Choose your path ───────────────────────────────────┐
+│ Basic mode  → SOLID app, JSON logging, Docker, async │
+│ Advanced    → + Database, Cache, Streaming, Secrets  │
+└──────────────────────────────────────────────────────┘
+
+? Project name: order-service
+? Model name: order
+? Log output: Stdout
+? Include debug compose? No
+? Generate project? Yes
+
+✔ Project created: ./order-service
+```
+
+### Basic Mode (default)
+
+Just 4-5 questions → production-ready app with structured logging, Docker, and CRUD.
+
+### Advanced Mode
+
+Enable with "Enable advanced configuration?" → unlocks:
+
+- **Database** — PostgreSQL, MySQL, SQLite (SQLAlchemy async), MongoDB (Motor)
+- **Cache** — Redis, Memcached, In-memory (cachetools)
+- **Streaming** — Kafka, RabbitMQ, Redis Pub/Sub, NATS (producer + consumer)
+- **Secrets** — HashiCorp Vault, AWS Secrets Manager, Azure Key Vault, GCP Secret Manager
+- **Quality Gate** — SonarQube, SonarCloud, Qodana, CodeClimate
+
+## Generated Project Structure
+
+```
+your-service/
+├── app/
+│   ├── main.py                    # App factory + lifespan
+│   ├── config.py                  # pydantic-settings
+│   ├── dependencies.py            # DI wiring
+│   ├── api/
+│   │   ├── routes/
+│   │   │   ├── health.py          # Health + readiness
+│   │   │   └── orders.py          # CRUD routes
+│   │   └── models/
+│   │       └── order.py           # Pydantic schemas
+│   ├── services/
+│   │   └── order_service.py       # Business logic
+│   ├── repositories/
+│   │   └── order_repository.py    # Data access (interface + impl)
+│   └── middleware/
+│       ├── security_headers.py
+│       └── logging_middleware.py
+├── tests/
+│   └── test_api.py
+├── Dockerfile
+├── docker-compose.yml
+├── pyproject.toml
+└── .pre-commit-config.yaml
+```
+
+## Run Immediately
+
+```bash
+cd your-service
+
+# Option A: Docker
+docker compose up --build
+
+# Option B: Local
+pip install -e ".[dev]"
+uvicorn app.main:app --reload
+pytest
+```
+
+## Extend Your Project
+
+```bash
+fastforge-infra           # Infrastructure (Kafka, Elasticsearch, Vault, DB)
+fastforge-cicd            # CI/CD pipeline
+fastforge-secops          # Security tools
+fastforge-helm            # Helm chart
+fastforge-k8s             # Kubernetes manifests
+fastforge-observability   # Tracing + Metrics
+```
+
+## Requirements
+
+- Python 3.10+
+- pip
+
+## License
+
+MIT

fastforge_cli-0.0.1/README.md

@@ -0,0 +1,133 @@
+# 🔨 FastForge
+
+**Production-grade FastAPI project generator for Python backends.**
+
+[![PyPI](https://img.shields.io/pypi/v/fastforge-cli)](https://pypi.org/project/fastforge-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/fastforge-cli)](https://pypi.org/project/fastforge-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+FastForge generates a **ready-to-run, production-grade FastAPI project** with SOLID architecture, structured logging, Docker containerization, and async CRUD — all in under 30 seconds.
+
+## Quick Start
+
+```bash
+pip install fastforge-cli
+fastforge
+```
+
+That's it. Answer a few prompts and you get a running application.
+
+## What You Get (Basic Mode)
+
+| Feature | Implementation |
+|---|---|
+| **SOLID Architecture** | Repository pattern + Service layer + Dependency Injection |
+| **Async CRUD API** | FastAPI with full Create/Read/Update/Delete |
+| **Structured Logging** | structlog with JSON output, request IDs, duration tracking |
+| **Docker** | Multi-stage Dockerfile, docker-compose, health checks |
+| **Security** | Security headers middleware, CORS, non-root container |
+| **Testing** | pytest + pytest-asyncio, 80%+ coverage out of the box |
+| **Code Quality** | ruff linting, pre-commit hooks |
+
+## CLI Flow
+
+```
+$ fastforge
+
+  ___         _   ___
+ | __| _ _ __| |_| __|__ _ _ __ _ ___
+ | _/ _` (_-<  _| _/ _ \ '_/ _` / -_)
+ |_|\__,_/__/\__|_|\___/_| \__, \___|
+                            |___/
+ Production-grade FastAPI Generator
+
+┌─ Choose your path ───────────────────────────────────┐
+│ Basic mode  → SOLID app, JSON logging, Docker, async │
+│ Advanced    → + Database, Cache, Streaming, Secrets  │
+└──────────────────────────────────────────────────────┘
+
+? Project name: order-service
+? Model name: order
+? Log output: Stdout
+? Include debug compose? No
+? Generate project? Yes
+
+✔ Project created: ./order-service
+```
+
+### Basic Mode (default)
+
+Just 4-5 questions → production-ready app with structured logging, Docker, and CRUD.
+
+### Advanced Mode
+
+Enable with "Enable advanced configuration?" → unlocks:
+
+- **Database** — PostgreSQL, MySQL, SQLite (SQLAlchemy async), MongoDB (Motor)
+- **Cache** — Redis, Memcached, In-memory (cachetools)
+- **Streaming** — Kafka, RabbitMQ, Redis Pub/Sub, NATS (producer + consumer)
+- **Secrets** — HashiCorp Vault, AWS Secrets Manager, Azure Key Vault, GCP Secret Manager
+- **Quality Gate** — SonarQube, SonarCloud, Qodana, CodeClimate
+
+## Generated Project Structure
+
+```
+your-service/
+├── app/
+│   ├── main.py                    # App factory + lifespan
+│   ├── config.py                  # pydantic-settings
+│   ├── dependencies.py            # DI wiring
+│   ├── api/
+│   │   ├── routes/
+│   │   │   ├── health.py          # Health + readiness
+│   │   │   └── orders.py          # CRUD routes
+│   │   └── models/
+│   │       └── order.py           # Pydantic schemas
+│   ├── services/
+│   │   └── order_service.py       # Business logic
+│   ├── repositories/
+│   │   └── order_repository.py    # Data access (interface + impl)
+│   └── middleware/
+│       ├── security_headers.py
+│       └── logging_middleware.py
+├── tests/
+│   └── test_api.py
+├── Dockerfile
+├── docker-compose.yml
+├── pyproject.toml
+└── .pre-commit-config.yaml
+```
+
+## Run Immediately
+
+```bash
+cd your-service
+
+# Option A: Docker
+docker compose up --build
+
+# Option B: Local
+pip install -e ".[dev]"
+uvicorn app.main:app --reload
+pytest
+```
+
+## Extend Your Project
+
+```bash
+fastforge-infra           # Infrastructure (Kafka, Elasticsearch, Vault, DB)
+fastforge-cicd            # CI/CD pipeline
+fastforge-secops          # Security tools
+fastforge-helm            # Helm chart
+fastforge-k8s             # Kubernetes manifests
+fastforge-observability   # Tracing + Metrics
+```
+
+## Requirements
+
+- Python 3.10+
+- pip
+
+## License
+
+MIT

fastforge_cli-0.0.1/fastforge/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"