fastapi-spawn 0.4.2__tar.gz → 0.4.4__tar.gz

{fastapi_spawn-0.4.2 → fastapi_spawn-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-spawn
-Version: 0.4.2
+Version: 0.4.4
 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
@@ -110,9 +110,13 @@ my-api/
 │   ├── api/
 │   │   ├── graphql.py           # Strawberry GraphQL schema + IDE (if graphql)
 │   │   └── v1/
-│   │       ├── health.py        # GET /health  /readiness  /liveness
-│   │       ├── auth.py          # POST /auth/login  /auth/refresh
-│   │       └── ws.py            # WebSocket /ws/connect  /ws/connect/{room_id}
+│   │       ├── router.py        # Central API router aggregating sub-routers
+│   │       ├── health/
+│   │       │   └── router.py    # GET /health  /readiness  /liveness
+│   │       ├── auth/
+│   │       │   └── router.py    # POST /auth/login  /auth/refresh (if auth)
+│   │       └── ws/
+│   │           └── router.py    # WebSocket /ws/connect (if websockets)
 │   ├── core/
 │   │   ├── config.py            # Pydantic Settings v2 — individual env fields + @property URLs
 │   │   ├── logger.py            # Context-var logger — request ID, client IP, file rotation
@@ -436,20 +440,64 @@ 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
+
+# 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
+
+# Storage, APIs & 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 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.2 → fastapi_spawn-0.4.4}/README.md

@@ -69,9 +69,13 @@ my-api/
 │   ├── api/
 │   │   ├── graphql.py           # Strawberry GraphQL schema + IDE (if graphql)
 │   │   └── v1/
-│   │       ├── health.py        # GET /health  /readiness  /liveness
-│   │       ├── auth.py          # POST /auth/login  /auth/refresh
-│   │       └── ws.py            # WebSocket /ws/connect  /ws/connect/{room_id}
+│   │       ├── router.py        # Central API router aggregating sub-routers
+│   │       ├── health/
+│   │       │   └── router.py    # GET /health  /readiness  /liveness
+│   │       ├── auth/
+│   │       │   └── router.py    # POST /auth/login  /auth/refresh (if auth)
+│   │       └── ws/
+│   │           └── router.py    # WebSocket /ws/connect (if websockets)
 │   ├── core/
 │   │   ├── config.py            # Pydantic Settings v2 — individual env fields + @property URLs
 │   │   ├── logger.py            # Context-var logger — request ID, client IP, file rotation
@@ -395,20 +399,64 @@ 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
+
+# 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
+
+# Storage, APIs & 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 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.2 → fastapi_spawn-0.4.4}/fastapi_spawn/__init__.py

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

{fastapi_spawn-0.4.2 → fastapi_spawn-0.4.4}/fastapi_spawn/generator.py

@@ -174,11 +174,14 @@ class ProjectGenerator:
         v1.mkdir()
         self._render_to(v1 / "__init__.py", "app/__init__.py.j2")
         self._render_to(v1 / "router.py", "app/api/v1/router.py.j2")
-        self._render_to(v1 / "health.py", "app/api/v1/health.py.j2")
+        (v1 / "health").mkdir()
+        self._render_to(v1 / "health" / "router.py", "app/api/v1/health/router.py.j2")
         if self.config.has_auth:
-            self._render_to(v1 / "auth.py", "app/api/v1/auth.py.j2")
+            (v1 / "auth").mkdir()
+            self._render_to(v1 / "auth" / "router.py", "app/api/v1/auth/router.py.j2")
         if self.config.has_websockets:
-            self._render_to(v1 / "ws.py", "app/api/v1/ws.py.j2")
+            (v1 / "ws").mkdir()
+            self._render_to(v1 / "ws" / "router.py", "app/api/v1/ws/router.py.j2")
             self._render_to(core / "ws_manager.py", "app/core/ws_manager.py.j2")
         if self.config.has_graphql:
             self._render_to(api / "graphql.py", "app/api/graphql.py.j2")
@@ -288,9 +291,13 @@ class ProjectGenerator:
         if cfg.has_s3:         core_items += "  storage.py"
         if cfg.has_ai:         core_items += "  ai.py"
         app.add(f"[blue]core/[/blue]  {core_items}")
-        api = app.add("[blue]api/[/blue]  deps.py")
-        v1 = "health.py" + ("  auth.py" if cfg.has_auth else "")
-        api.add(f"[blue]v1/[/blue]  {v1}")
+        api = app.add("[blue]api/[/blue]  deps.py  [dim]graphql.py[/dim]?")
+        v1 = api.add("[blue]v1/[/blue]  router.py")
+        v1.add("[blue]health/[/blue]  router.py")
+        if cfg.has_auth:
+            v1.add("[blue]auth/[/blue]  router.py")
+        if cfg.has_websockets:
+            v1.add("[blue]ws/[/blue]  router.py")
         if cfg.db.value != "none":
             app.add("[blue]db/[/blue]  session.py")
         for sub in ("models/", "schemas/", "services/", "repositories/"):

{fastapi_spawn-0.4.2 → fastapi_spawn-0.4.4}/fastapi_spawn/templates/app/api/graphql.py.j2

@@ -93,6 +93,6 @@ schema = strawberry.Schema(
 # Mount with: app.include_router(graphql_router, prefix="/graphql")
 graphql_router = GraphQLRouter(
     schema,
-    graphiql=True,          # GraphiQL IDE at /graphql — disable in production
+    graphql_ide="graphiql",
     subscription_protocols=["graphql-transport-ws", "graphql-ws"],
 )

{fastapi_spawn-0.4.2 → fastapi_spawn-0.4.4}/fastapi_spawn/templates/app/api/v1/router.py.j2

@@ -1,14 +1,15 @@
 from fastapi import APIRouter
 
-from app.api.v1.health import router as health_router
+from app.api.v1.health.router import router as health_router
 {% if has_auth %}
-from app.api.v1.auth import router as auth_router
+from app.api.v1.auth.router import router as auth_router
 {% endif %}
 {% if has_websockets %}
-from app.api.v1.ws import router as ws_router
+from app.api.v1.ws.router import router as ws_router
 {% endif %}
 
-router = APIRouter(prefix="/v1", tags=["v1"])
+
+router = APIRouter()
 
 router.include_router(health_router)
 {% if has_auth %}

{fastapi_spawn-0.4.2 → fastapi_spawn-0.4.4}/fastapi_spawn/templates/app/core/config.py.j2

@@ -24,13 +24,15 @@ class Settings(BaseSettings):
     ENVIRONMENT: str = "dev"
     API_V1_PREFIX: str = "/api/v1"
     SECRET_KEY: str = "change-me"
-    CORS_ORIGINS: list[str] = ["http://localhost:3000", "http://localhost:8000"]
+    CORS_ORIGINS: str | list[str] = ["http://localhost:3000", "http://localhost:8000"]
 
     @field_validator("CORS_ORIGINS", mode="before")
     def parse_cors(cls, v: Any) -> list[str]:
         if isinstance(v, str) and not v.startswith("["):
             return [i.strip() for i in v.split(",") if i.strip()]
-        return v
+        if isinstance(v, list):
+            return v
+        return []
 
     @property
     def DEBUG(self) -> bool:

{fastapi_spawn-0.4.2 → fastapi_spawn-0.4.4}/fastapi_spawn/templates/app/main.py.j2

@@ -13,13 +13,11 @@ from app.api.graphql import graphql_router
 {% endif %}
 from app.core.config import settings
 from app.core.exceptions import register_exception_handlers
-from app.core.logging import configure_logging
 
 
 @asynccontextmanager
 async def lifespan(application: FastAPI) -> AsyncGenerator[None, None]:
     """Manage application startup and shutdown lifecycle."""
-    configure_logging()
 {% if has_relational_db and orm == "sqlalchemy" %}
     from app.db.session import engine, Base
     async with engine.begin() as conn:

{fastapi_spawn-0.4.2 → fastapi_spawn-0.4.4}/fastapi_spawn/templates/base/pyproject.toml.j2

@@ -15,6 +15,7 @@ dependencies = [
     "pydantic-settings>=2.2.0",
     "httpx>=0.27.0",
     "slowapi>=0.1.9",             # rate limiting middleware
+    "orjson>=3.9.0",              # fast JSON responses
 
 {% if log_lib == "loguru" %}
     "loguru>=0.7.2",

{fastapi_spawn-0.4.2 → fastapi_spawn-0.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fastapi-spawn"
-version = "0.4.2"
+version = "0.4.4"
 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.2/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