fastapi-spawn 0.4.23__tar.gz → 0.4.25__tar.gz

{fastapi_spawn-0.4.23 → fastapi_spawn-0.4.25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-spawn
-Version: 0.4.23
+Version: 0.4.25
 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
@@ -72,6 +72,11 @@ uv pip install fastapi-spawn
 # Interactive TUI — guided step-by-step
 fastapi-spawn new my-api
 
+# Or use a preset template (New in 0.4.24!)
+fastapi-spawn start basic my-api
+fastapi-spawn start full-local my-api
+fastapi-spawn start full my-api
+
 # Full stack one-liner
 fastapi-spawn new my-api \
   --db postgresql \

{fastapi_spawn-0.4.23 → fastapi_spawn-0.4.25}/README.md

@@ -31,6 +31,11 @@ uv pip install fastapi-spawn
 # Interactive TUI — guided step-by-step
 fastapi-spawn new my-api
 
+# Or use a preset template (New in 0.4.24!)
+fastapi-spawn start basic my-api
+fastapi-spawn start full-local my-api
+fastapi-spawn start full my-api
+
 # Full stack one-liner
 fastapi-spawn new my-api \
   --db postgresql \

{fastapi_spawn-0.4.23 → fastapi_spawn-0.4.25}/fastapi_spawn/cli.py

@@ -219,6 +219,120 @@ def new(
     if not dry_run:
         console.print(f"\n[bold green]✓ Project created:[/bold green] {project_path.resolve()}")
         _print_next_steps(config)
+@app.command("start", help="Create a project using a preset template.")
+def start(
+    preset: Optional[str] = typer.Argument(None, help="Preset name (basic, full-local, full)"),
+    project_name: Optional[str] = typer.Argument(None, help="Name of the new project"),
+    output: Path = typer.Option(Path("."), "--output", "-o", help="Output directory"),
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing directory"),
+) -> None:
+    _print_banner()
+    
+    if not preset:
+        import questionary
+        from fastapi_spawn.interactive import SPAWN_STYLE
+        preset = questionary.select(
+            "Which preset do you want to use?",
+            choices=["basic", "full-local", "full"],
+            style=SPAWN_STYLE,
+        ).unsafe_ask()
+        
+    if not project_name:
+        import questionary
+        from fastapi_spawn.interactive import SPAWN_STYLE
+        from fastapi_spawn.validators import questionary_validator, validate_project_name
+        project_name = questionary.text(
+            "Project name:",
+            validate=questionary_validator(validate_project_name),
+            style=SPAWN_STYLE,
+        ).unsafe_ask()
+    
+    if preset == "basic":
+        config = ProjectConfig(
+            project_name=project_name,
+            db=Database.sqlite,
+            orm=ORM.sqlalchemy,
+            migration=MigrationTool.alembic,
+            auth=AuthType.jwt,
+            broker=Broker.none,
+            cache=Cache.none,
+            storage=Storage.local,
+            ai=AIProvider.none,
+            api_extra=APIExtra.none,
+            monitoring=MonitoringProvider.none,
+            log_lib=LogLibrary.loguru,
+            log_dest=LogDestination.local,
+            email=EmailProvider.none,
+            notify=NotificationProvider.none,
+            vector_db=VectorDB.none,
+            stack=Stack.minimal,
+            ci=CIProvider.none,
+            include_docker=True,
+            include_tests=True,
+            force=force,
+        )
+    elif preset == "full-local":
+        config = ProjectConfig(
+            project_name=project_name,
+            db=Database.postgresql,
+            orm=ORM.sqlalchemy,
+            migration=MigrationTool.alembic,
+            auth=AuthType.jwt,
+            broker=Broker.none,
+            cache=Cache.none,
+            storage=Storage.local,
+            ai=AIProvider.none,
+            api_extra=APIExtra.none,
+            monitoring=MonitoringProvider.none,
+            log_lib=LogLibrary.loguru,
+            log_dest=LogDestination.local,
+            email=EmailProvider.none,
+            notify=NotificationProvider.none,
+            vector_db=VectorDB.chroma,
+            stack=Stack.standard,
+            ci=CIProvider.none,
+            include_docker=True,
+            include_tests=True,
+            force=force,
+        )
+    elif preset == "full":
+        config = ProjectConfig(
+            project_name=project_name,
+            db=Database.postgresql,
+            orm=ORM.sqlalchemy,
+            migration=MigrationTool.alembic,
+            auth=AuthType.jwt,
+            broker=Broker.redis,
+            cache=Cache.redis,
+            storage=Storage.s3,
+            ai=AIProvider.openai,
+            api_extra=APIExtra.websockets,
+            monitoring=MonitoringProvider.both,
+            log_lib=LogLibrary.loguru,
+            log_dest=LogDestination.local,
+            email=EmailProvider.none,
+            notify=NotificationProvider.none,
+            vector_db=VectorDB.qdrant,
+            stack=Stack.full,
+            ci=CIProvider.github,
+            include_docker=True,
+            include_tests=True,
+            force=force,
+        )
+    else:
+        rprint(f"[bold red]✗ Error:[/bold red] Unknown preset '{preset}'. Available presets: basic, full-local, full")
+        raise typer.Exit(1)
+
+    _print_summary(config)
+
+    try:
+        generator = ProjectGenerator(config, output)
+        project_path = generator.generate()
+        rprint(f"\n[bold green]✓ Project created:[/bold green] {project_path.resolve()}")
+        _print_next_steps(config)
+    except Exception as exc:
+        rprint(f"\n[bold red]✗ Generation failed:[/bold red] {exc}")
+        raise typer.Exit(1) from exc
 
 
 # ── `list-templates` command ───────────────────────────────────────────────────

{fastapi_spawn-0.4.23 → fastapi_spawn-0.4.25}/fastapi_spawn/interactive.py

@@ -19,6 +19,10 @@ from fastapi_spawn.constants import (
     ORM,
     ORM_DB_COMPAT,
     Stack,
+    Storage,
+    AIProvider,
+    MonitoringProvider,
+    VectorDB,
 )
 from fastapi_spawn.validators import questionary_validator, validate_project_name
 
@@ -47,8 +51,8 @@ def prompt_project_name(default: str = "") -> str:
 
 def prompt_database() -> Database:
     choices = [
-        questionary.Choice(title=label, value=db)
-        for db, label in DB_LABELS.items()
+        questionary.Choice(title=f"{i}) {label}", value=db)
+        for i, (db, label) in enumerate(DB_LABELS.items(), 1)
     ]
     return questionary.select(
         "Database backend:",
@@ -68,7 +72,7 @@ def prompt_orm(db: Database) -> ORM:
         orm for orm in ORM
         if db in ORM_DB_COMPAT.get(orm, compatible)
     ]
-    choices = [questionary.Choice(title=o.value, value=o) for o in valid_orms]
+    choices = [questionary.Choice(title=f"{i}) {o.value}", value=o) for i, o in enumerate(valid_orms, 1)]
     if not choices:
         return ORM.none
     return questionary.select(
@@ -80,8 +84,8 @@ def prompt_orm(db: Database) -> ORM:
 
 def prompt_auth() -> AuthType:
     choices = [
-        questionary.Choice(title=label, value=auth)
-        for auth, label in AUTH_LABELS.items()
+        questionary.Choice(title=f"{i}) {label}", value=auth)
+        for i, (auth, label) in enumerate(AUTH_LABELS.items(), 1)
     ]
     return questionary.select(
         "Authentication strategy:",
@@ -92,8 +96,8 @@ def prompt_auth() -> AuthType:
 
 def prompt_broker() -> Broker:
     choices = [
-        questionary.Choice(title=label, value=broker)
-        for broker, label in BROKER_LABELS.items()
+        questionary.Choice(title=f"{i}) {label}", value=broker)
+        for i, (broker, label) in enumerate(BROKER_LABELS.items(), 1)
     ]
     return questionary.select(
         "Message broker:",
@@ -104,8 +108,8 @@ def prompt_broker() -> Broker:
 
 def prompt_cache() -> Cache:
     choices = [
-        questionary.Choice(title=c.value, value=c)
-        for c in Cache
+        questionary.Choice(title=f"{i}) {c.value}", value=c)
+        for i, c in enumerate(Cache, 1)
     ]
     return questionary.select(
         "Cache layer:",
@@ -116,8 +120,8 @@ def prompt_cache() -> Cache:
 
 def prompt_stack() -> Stack:
     choices = [
-        questionary.Choice(title=f"{s.value}  —  {STACK_DESCRIPTIONS[s]}", value=s)
-        for s in Stack
+        questionary.Choice(title=f"{i}) {s.value}  —  {STACK_DESCRIPTIONS[s]}", value=s)
+        for i, s in enumerate(Stack, 1)
     ]
     return questionary.select(
         "Deployment stack:",
@@ -128,8 +132,8 @@ def prompt_stack() -> Stack:
 
 def prompt_ci() -> CIProvider:
     choices = [
-        questionary.Choice(title=c.value, value=c)
-        for c in CIProvider
+        questionary.Choice(title=f"{i}) {c.value}", value=c)
+        for i, c in enumerate(CIProvider, 1)
     ]
     return questionary.select(
         "CI/CD provider:",
@@ -140,8 +144,8 @@ def prompt_ci() -> CIProvider:
 
 def prompt_log_lib() -> LogLibrary:
     choices = [
-        questionary.Choice(title=l.value, value=l)
-        for l in LogLibrary
+        questionary.Choice(title=f"{i}) {l.value}", value=l)
+        for i, l in enumerate(LogLibrary, 1)
     ]
     return questionary.select(
         "Logging library:",
@@ -150,6 +154,74 @@ def prompt_log_lib() -> LogLibrary:
     ).unsafe_ask()
 
 
+def prompt_storage() -> Storage:
+    use_storage = questionary.confirm(
+        "Do you need file storage?", default=False, style=SPAWN_STYLE
+    ).unsafe_ask()
+    if not use_storage:
+        return Storage.none
+    choices = [
+        questionary.Choice(title=f"{i}) {s.value}", value=s)
+        for i, s in enumerate(Storage, 1) if s != Storage.none
+    ]
+    return questionary.select(
+        "Storage provider:",
+        choices=choices,
+        style=SPAWN_STYLE,
+    ).unsafe_ask()
+
+
+def prompt_ai() -> AIProvider:
+    use_ai = questionary.confirm(
+        "Do you need AI/LLM integration?", default=False, style=SPAWN_STYLE
+    ).unsafe_ask()
+    if not use_ai:
+        return AIProvider.none
+    choices = [
+        questionary.Choice(title=f"{i}) {a.value}", value=a)
+        for i, a in enumerate(AIProvider, 1) if a != AIProvider.none
+    ]
+    return questionary.select(
+        "AI provider:",
+        choices=choices,
+        style=SPAWN_STYLE,
+    ).unsafe_ask()
+
+
+def prompt_vector_db() -> VectorDB:
+    use_vdb = questionary.confirm(
+        "Do you need a Vector Database?", default=False, style=SPAWN_STYLE
+    ).unsafe_ask()
+    if not use_vdb:
+        return VectorDB.none
+    choices = [
+        questionary.Choice(title=f"{i}) {v.value}", value=v)
+        for i, v in enumerate(VectorDB, 1) if v != VectorDB.none
+    ]
+    return questionary.select(
+        "Vector database:",
+        choices=choices,
+        style=SPAWN_STYLE,
+    ).unsafe_ask()
+
+
+def prompt_monitoring() -> MonitoringProvider:
+    use_mon = questionary.confirm(
+        "Do you need Monitoring?", default=False, style=SPAWN_STYLE
+    ).unsafe_ask()
+    if not use_mon:
+        return MonitoringProvider.none
+    choices = [
+        questionary.Choice(title=f"{i}) {m.value}", value=m)
+        for i, m in enumerate(MonitoringProvider, 1) if m != MonitoringProvider.none
+    ]
+    return questionary.select(
+        "Monitoring provider:",
+        choices=choices,
+        style=SPAWN_STYLE,
+    ).unsafe_ask()
+
+
 def prompt_flags() -> tuple[bool, bool]:
     """Returns (include_docker, include_tests)."""
     include_docker = questionary.confirm(
@@ -175,6 +247,10 @@ def run_interactive_flow(project_name: str = "") -> dict:
     stack = prompt_stack()
     ci = prompt_ci()
     log_lib = prompt_log_lib()
+    storage = prompt_storage()
+    ai = prompt_ai()
+    vector_db = prompt_vector_db()
+    monitoring = prompt_monitoring()
     include_docker, include_tests = prompt_flags()
 
     return {
@@ -187,6 +263,10 @@ def run_interactive_flow(project_name: str = "") -> dict:
         "stack": stack,
         "ci": ci,
         "log_lib": log_lib,
+        "storage": storage,
+        "ai": ai,
+        "vector_db": vector_db,
+        "monitoring": monitoring,
         "include_docker": include_docker,
         "include_tests": include_tests,
     }

{fastapi_spawn-0.4.23 → fastapi_spawn-0.4.25}/fastapi_spawn/templates/app/api/v1/router.py.j2

@@ -7,6 +7,12 @@ from app.api.v1.auth.router import router as auth_router
 {% if has_websockets %}
 from app.api.v1.ws.router import router as ws_router
 {% endif %}
+{% if "rbac" in extras %}
+from app.api.v1.permissions.router import router as permissions_router
+{% endif %}
+{% if "uploads" in extras %}
+from app.api.v1.uploads.router import router as uploads_router
+{% endif %}
 
 
 router = APIRouter()
@@ -18,3 +24,9 @@ router.include_router(auth_router)
 {% if has_websockets %}
 router.include_router(ws_router)
 {% endif %}
+{% if "rbac" in extras %}
+router.include_router(permissions_router)
+{% endif %}
+{% if "uploads" in extras %}
+router.include_router(uploads_router)
+{% endif %}

{fastapi_spawn-0.4.23 → fastapi_spawn-0.4.25}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fastapi-spawn"
-version = "0.4.23"
+version = "0.4.25"
 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" }