fastapi-spawn 0.4.3__tar.gz → 0.4.6__tar.gz

{fastapi_spawn-0.4.3 → fastapi_spawn-0.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-spawn
-Version: 0.4.3
+Version: 0.4.6
 Summary: A powerful CLI tool to scaffold production-ready FastAPI projects with flexible database, auth, broker, and deployment options.
 Project-URL: Homepage, https://github.com/Bishwajitgarai/fastapi-spawn
 Project-URL: Documentation, https://github.com/Bishwajitgarai/fastapi-spawn#readme
@@ -440,20 +440,73 @@ GraphiQL IDE is enabled in `dev` mode. Subscriptions use `graphql-transport-ws`.
 
 ---
 
-## Add Features to Existing Projects
+## 🧩 Add Features to Existing Projects (Incremental Scaffolding)
+
+Did you generate a minimal project and now realize you need WebSockets, AWS S3, or OpenAI? **No problem.** 
+
+`fastapi-spawn add` allows you to incrementally scale your project. Instead of re-generating your entire project or copying boilerplate manually, you can inject production-ready modules into your existing codebase.
+
+```bash
+fastapi-spawn add [FEATURE]
+```
+
+### How it works:
+1. **Generates the Module**: It creates the necessary file (e.g., `app/core/ai.py` or `app/api/v1/ws/router.py`) tailored to your project structure.
+2. **Environment Variables**: It prompts you with the exact environment variables you need to append to your `.env` and `config.py`.
+3. **Integration Guide**: It outputs a step-by-step UI snippet telling you *exactly* where to import and mount the new feature in your `main.py` or `router.py`.
+
+### All Possibilities you can `add`:
+
+You can run any of the following commands inside an existing project:
 
 ```bash
-fastapi-spawn add sentry       # Sentry error tracking
+# Infrastructure & Deployment
+fastapi-spawn add docker       # Dockerfile and docker-compose.yml
+fastapi-spawn add helm         # Helm chart in infra/helm/
+fastapi-spawn add terraform    # Terraform in infra/terraform/
+fastapi-spawn add github-actions # CI/CD pipeline (.github/workflows/tests.yml)
+
+# AI & Vector DBs
 fastapi-spawn add openai       # OpenAI async client
-fastapi-spawn add alembic      # Alembic async migrations
-fastapi-spawn add s3           # AWS S3 / MinIO storage
+fastapi-spawn add anthropic    # Anthropic Claude async client
+fastapi-spawn add gemini       # Google Generative AI client
+fastapi-spawn add qdrant       # Qdrant vector DB
+fastapi-spawn add chroma       # ChromaDB local vector DB
+fastapi-spawn add pinecone     # Pinecone cloud vector DB
+fastapi-spawn add meilisearch  # Meilisearch typo-tolerant search
+fastapi-spawn add ocr          # PDF & OCR data extraction pipeline
+
+# Payments & Identity
+fastapi-spawn add stripe       # Stripe payments & webhooks
+fastapi-spawn add sso          # FastAPI SSO (Google/GitHub login)
+
+# Messaging & Async Workers
 fastapi-spawn add celery       # Celery worker + tasks/
+fastapi-spawn add arq          # Arq async job queues using Redis
 fastapi-spawn add websockets   # WebSocket connection manager
+fastapi-spawn add sse          # Server-Sent Events streaming
+
+# Storage, APIs, Seeding & Monitoring
+fastapi-spawn add s3           # AWS S3 / MinIO storage
 fastapi-spawn add graphql      # Strawberry GraphQL schema
-fastapi-spawn add qdrant       # Qdrant vector DB
-fastapi-spawn add chroma       # ChromaDB local vector DB
-fastapi-spawn add helm         # Helm chart in infra/helm/
-fastapi-spawn add terraform    # Terraform in infra/terraform/
+fastapi-spawn add alembic      # Alembic async migrations
+fastapi-spawn add seed         # Faker database seeding script
+fastapi-spawn add resend       # Resend modern email client
+fastapi-spawn add sentry       # Sentry APM integration
+fastapi-spawn add prometheus   # Prometheus metrics
+```
+
+*Example:*
+```bash
+$ fastapi-spawn add websockets
+
+✓ Created app/core/ws_manager.py
+✓ Created app/api/v1/ws/router.py
+
+👉 Next Steps:
+1. Mount the router in app/api/v1/router.py:
+   from app.api.v1.ws.router import router as ws_router
+   router.include_router(ws_router)
 ```
 
 ---

{fastapi_spawn-0.4.3 → fastapi_spawn-0.4.6}/README.md

@@ -399,20 +399,73 @@ GraphiQL IDE is enabled in `dev` mode. Subscriptions use `graphql-transport-ws`.
 
 ---
 
-## Add Features to Existing Projects
+## 🧩 Add Features to Existing Projects (Incremental Scaffolding)
+
+Did you generate a minimal project and now realize you need WebSockets, AWS S3, or OpenAI? **No problem.** 
+
+`fastapi-spawn add` allows you to incrementally scale your project. Instead of re-generating your entire project or copying boilerplate manually, you can inject production-ready modules into your existing codebase.
+
+```bash
+fastapi-spawn add [FEATURE]
+```
+
+### How it works:
+1. **Generates the Module**: It creates the necessary file (e.g., `app/core/ai.py` or `app/api/v1/ws/router.py`) tailored to your project structure.
+2. **Environment Variables**: It prompts you with the exact environment variables you need to append to your `.env` and `config.py`.
+3. **Integration Guide**: It outputs a step-by-step UI snippet telling you *exactly* where to import and mount the new feature in your `main.py` or `router.py`.
+
+### All Possibilities you can `add`:
+
+You can run any of the following commands inside an existing project:
 
 ```bash
-fastapi-spawn add sentry       # Sentry error tracking
+# Infrastructure & Deployment
+fastapi-spawn add docker       # Dockerfile and docker-compose.yml
+fastapi-spawn add helm         # Helm chart in infra/helm/
+fastapi-spawn add terraform    # Terraform in infra/terraform/
+fastapi-spawn add github-actions # CI/CD pipeline (.github/workflows/tests.yml)
+
+# AI & Vector DBs
 fastapi-spawn add openai       # OpenAI async client
-fastapi-spawn add alembic      # Alembic async migrations
-fastapi-spawn add s3           # AWS S3 / MinIO storage
+fastapi-spawn add anthropic    # Anthropic Claude async client
+fastapi-spawn add gemini       # Google Generative AI client
+fastapi-spawn add qdrant       # Qdrant vector DB
+fastapi-spawn add chroma       # ChromaDB local vector DB
+fastapi-spawn add pinecone     # Pinecone cloud vector DB
+fastapi-spawn add meilisearch  # Meilisearch typo-tolerant search
+fastapi-spawn add ocr          # PDF & OCR data extraction pipeline
+
+# Payments & Identity
+fastapi-spawn add stripe       # Stripe payments & webhooks
+fastapi-spawn add sso          # FastAPI SSO (Google/GitHub login)
+
+# Messaging & Async Workers
 fastapi-spawn add celery       # Celery worker + tasks/
+fastapi-spawn add arq          # Arq async job queues using Redis
 fastapi-spawn add websockets   # WebSocket connection manager
+fastapi-spawn add sse          # Server-Sent Events streaming
+
+# Storage, APIs, Seeding & Monitoring
+fastapi-spawn add s3           # AWS S3 / MinIO storage
 fastapi-spawn add graphql      # Strawberry GraphQL schema
-fastapi-spawn add qdrant       # Qdrant vector DB
-fastapi-spawn add chroma       # ChromaDB local vector DB
-fastapi-spawn add helm         # Helm chart in infra/helm/
-fastapi-spawn add terraform    # Terraform in infra/terraform/
+fastapi-spawn add alembic      # Alembic async migrations
+fastapi-spawn add seed         # Faker database seeding script
+fastapi-spawn add resend       # Resend modern email client
+fastapi-spawn add sentry       # Sentry APM integration
+fastapi-spawn add prometheus   # Prometheus metrics
+```
+
+*Example:*
+```bash
+$ fastapi-spawn add websockets
+
+✓ Created app/core/ws_manager.py
+✓ Created app/api/v1/ws/router.py
+
+👉 Next Steps:
+1. Mount the router in app/api/v1/router.py:
+   from app.api.v1.ws.router import router as ws_router
+   router.include_router(ws_router)
 ```
 
 ---

{fastapi_spawn-0.4.3 → fastapi_spawn-0.4.6}/fastapi_spawn/__init__.py

@@ -1,6 +1,6 @@
 """fastapi-spawn — Production-ready FastAPI project scaffolding CLI."""
 
-__version__ = "0.4.3"
+__version__ = "0.4.6"
 __author__ = "Bishwajit Garai"
 __email__ = "bishwajitgarai@gmail.com"
 __license__ = "MIT"

{fastapi_spawn-0.4.3 → fastapi_spawn-0.4.6}/fastapi_spawn/cli.py

@@ -277,14 +277,21 @@ _ADDABLE_FEATURES = {
     "sendgrid":    "SendGrid email",
     "smtp":        "SMTP email (fastapi-mail)",
     "ses":         "AWS SES email",
+    "resend":      "Resend email client (modern React/HTML emails)",
     "slack":       "Slack webhook notifications",
     "discord":     "Discord webhook notifications",
     "qdrant":      "Qdrant vector database",
     "chroma":      "ChromaDB local vector database",
     "pinecone":    "Pinecone managed vector database",
     "elasticsearch": "Elasticsearch KNN search",
+    "meilisearch": "Meilisearch ultra-fast typo-tolerant search",
     "websockets":  "WebSocket connection manager + endpoints",
+    "sse":         "Server-Sent Events (SSE) streaming endpoint",
     "graphql":     "Strawberry GraphQL schema + subscriptions",
+    "stripe":      "Stripe payments & webhook signature validation",
+    "sso":         "FastAPI SSO (Login with Google / GitHub)",
+    "seed":        "Database seeding script using Faker",
+    "ocr":         "PDF & OCR data pipeline (PyMuPDF / Tesseract)",
     "docker":      "Dockerfile + docker-compose.yml",
     "ci":          "GitHub Actions CI/CD workflows",
     "helm":        "Helm chart (infra/helm/)",
@@ -339,14 +346,21 @@ def _feature_guidance(feature: str, _project_dir: Path) -> None:
         "sendgrid":  ["Add dep: sendgrid>=6.11.0", "Create app/core/email.py", "Add to .env: SENDGRID_API_KEY, SENDGRID_FROM_EMAIL"],
         "smtp":      ["Add dep: fastapi-mail>=1.4.1", "Create app/core/email.py", "Add to .env: SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, SMTP_FROM_EMAIL"],
         "ses":       ["Add dep: boto3>=1.34.0", "Create app/core/email.py", "Add to .env: AWS_* credentials, SES_FROM_EMAIL"],
+        "resend":    ["Add dep: resend>=2.1.0", "Create app/core/email.py (Resend client)", "Add to .env: RESEND_API_KEY"],
         "slack":     ["No extra dep (uses httpx)", "Create app/core/notifications.py", "Add to .env: SLACK_WEBHOOK_URL=https://hooks.slack.com/services/..."],
         "discord":   ["No extra dep (uses httpx)", "Create app/core/notifications.py", "Add to .env: DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/..."],
         "qdrant":    ["Add dep: qdrant-client[fastembed]>=1.9.0", "Create app/core/vector_db.py", "Add to .env: QDRANT_HOST=localhost, QDRANT_PORT=6333, QDRANT_API_KEY= (blank for local)"],
         "chroma":    ["Add dep: chromadb>=0.5.0", "Create app/core/vector_db.py (persistent local client)", "No env vars needed — data stored in ./chroma_data"],
         "pinecone":  ["Add dep: pinecone-client>=3.2.0", "Create app/core/vector_db.py", "Add to .env: PINECONE_API_KEY, PINECONE_INDEX_NAME"],
         "elasticsearch": ["Add dep: elasticsearch[async]>=8.13.0", "Create app/core/vector_db.py (kNN search)", "Add to .env: ELASTICSEARCH_HOST, ELASTICSEARCH_PORT, ELASTICSEARCH_API_KEY"],
-        "websockets":["No extra dep (built into FastAPI)", "Create app/core/ws_manager.py (ConnectionManager)", "Create app/api/v1/ws.py — /ws/connect, /ws/connect/{room_id}"],
+        "meilisearch": ["Add dep: meilisearch>=0.30.0", "Create app/core/search.py (Meilisearch client)", "Add to .env: MEILISEARCH_HOST=http://localhost:7700, MEILISEARCH_API_KEY"],
+        "websockets":["No extra dep (built into FastAPI)", "Create app/core/ws_manager.py (ConnectionManager)", "Create app/api/v1/ws/router.py — /ws/connect, /ws/connect/{room_id}"],
+        "sse":       ["Add dep: sse-starlette>=2.1.0", "Create app/api/v1/streaming/router.py", "Return EventSourceResponse(async_generator)"],
         "graphql":   ["Add dep: strawberry-graphql[fastapi]>=0.227.0", "Create app/api/graphql.py (Query + Mutation + Subscription)", "Mount: app.include_router(graphql_router, prefix='/graphql')"],
+        "stripe":    ["Add dep: stripe>=9.0.0", "Create app/api/v1/payments/router.py (webhook endpoint)", "Add to .env: STRIPE_API_KEY, STRIPE_WEBHOOK_SECRET"],
+        "sso":       ["Add dep: fastapi-sso>=0.14.0", "Create app/api/v1/auth/sso.py (GoogleSSO / GithubSSO)", "Add to .env: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET"],
+        "seed":      ["Add dep: faker>=25.0.0", "Create db/seed.py (generate 100 mock users/posts)", "Run: uv run python db/seed.py"],
+        "ocr":       ["Add deps: pymupdf>=1.24.0, pytesseract>=0.3.10", "Create app/core/ocr.py (PDF parsing pipeline)", "Install system deps: sudo apt install tesseract-ocr"],
         "docker":    ["Create Dockerfile (multi-stage, uv-based)", "Create docker-compose.yml with all selected services", "Create .dockerignore"],
         "ci":        ["Create .github/workflows/tests.yml (matrix: 3.10, 3.11, 3.12)", "Create .github/workflows/publish.yml (v* tags → PyPI)", "Add PYPI_API_TOKEN to GitHub repo secrets"],
         "helm":      ["Create infra/helm/Chart.yaml", "Create infra/helm/values.yaml (replicas, image, resources)", "Run: helm install my-release ./infra/helm"],

{fastapi_spawn-0.4.3 → fastapi_spawn-0.4.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fastapi-spawn"
-version = "0.4.3"
+version = "0.4.6"
 description = "A powerful CLI tool to scaffold production-ready FastAPI projects with flexible database, auth, broker, and deployment options."
 readme = "README.md"
 license = { text = "MIT" }

fastapi_spawn-0.4.3/CHANGELOG.md

@@ -1,36 +0,0 @@
-# Changelog
-
-All notable changes to `fastapi-spawn` will be documented here.
-
-Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
-Versioning follows [Semantic Versioning](https://semver.org/).
-
----
-
-## [0.1.0] — 2026-05-10
-
-### Added
-- Interactive TUI with questionary + Rich styling
-- Database support: PostgreSQL, MySQL, MongoDB, SQLite
-- ORM support: SQLAlchemy 2.x (async), Tortoise ORM, Beanie
-- Migration support: Alembic (async-compatible), Aerich
-- Auth: JWT, OAuth2, API Key
-- Message brokers: Redis (Celery), RabbitMQ (Celery), Kafka (aiokafka)
-- Cache layer: Redis, Memcached
-- File storage: AWS S3 (boto3) with presigned URLs
-- AI integration: OpenAI (chat + embeddings, custom base URL), Anthropic Claude
-- Root-level `main.py` entry point (`uv run main.py`)
-- Root-level `tasks/` directory for Celery workers
-- Individual env fields per service with `@property` URL assembly
-- `OPENAI_BASE_URL` support for Azure, LM Studio, local endpoints
-- `--dry-run` flag with rich tree preview
-- `--force` flag to overwrite existing projects
-- Stack options: minimal, standard, full (Helm + Terraform)
-- CI/CD: GitHub Actions, GitLab CI
-- Logging: loguru, structlog, standard library
-- Docker: multi-service compose with health checks
-- infra/: docker/, helm/, terraform/ structure
-- `uv`-compatible `pyproject.toml` with `[tool.uv]`
-- `list-templates` and `validate` subcommands
-- `ENVIRONMENT=dev` style env naming
-- Professional README, CHANGELOG, CONTRIBUTING