fastapi-fullstack 0.1.2__py3-none-any.whl

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/api/routes/v1/items.py

@@ -0,0 +1,275 @@
+{%- if cookiecutter.include_example_crud and cookiecutter.use_database %}
+# ruff: noqa: I001 - Imports structured for Jinja2 template conditionals
+"""Item CRUD routes - example API endpoints.
+
+This module demonstrates a complete CRUD API for the Item entity.
+You can use it as a template for creating your own endpoints.
+
+The endpoints are:
+- GET /items - List all items (with pagination if enabled)
+- POST /items - Create a new item
+- GET /items/{item_id} - Get a single item by ID
+- PATCH /items/{item_id} - Update an item
+- DELETE /items/{item_id} - Delete an item
+"""
+{%- if cookiecutter.use_postgresql %}
+
+from uuid import UUID
+{%- endif %}
+
+from fastapi import APIRouter, status
+{%- if cookiecutter.enable_pagination and cookiecutter.use_postgresql %}
+from fastapi_pagination import Page
+from fastapi_pagination.ext.sqlalchemy import paginate
+from sqlalchemy import select
+{%- elif cookiecutter.enable_pagination and cookiecutter.use_sqlite %}
+from fastapi_pagination import Page
+from fastapi_pagination.ext.sqlalchemy import paginate
+from sqlalchemy import select
+{%- endif %}
+
+{%- if cookiecutter.use_mongodb %}
+from app.api.deps import ItemSvc
+{%- elif cookiecutter.enable_pagination %}
+from app.api.deps import DBSession, ItemSvc
+{%- else %}
+from app.api.deps import ItemSvc
+{%- endif %}
+{%- if cookiecutter.enable_pagination and (cookiecutter.use_postgresql or cookiecutter.use_sqlite) %}
+from app.db.models.item import Item
+{%- endif %}
+from app.schemas.item import ItemCreate, ItemRead, ItemUpdate
+
+router = APIRouter()
+
+
+{%- if cookiecutter.use_postgresql %}
+
+{%- if cookiecutter.enable_pagination %}
+
+
+@router.get("", response_model=Page[ItemRead])
+async def list_items(db: DBSession):
+    """List all items with pagination.
+
+    Returns a paginated list of items. Use query parameters
+    `page` and `size` to control pagination.
+    """
+    return await paginate(db, select(Item))
+{%- else %}
+
+
+@router.get("", response_model=list[ItemRead])
+async def list_items(
+    item_service: ItemSvc,
+    skip: int = 0,
+    limit: int = 100,
+):
+    """List all items.
+
+    Returns a list of items with offset-based pagination.
+    """
+    return await item_service.get_multi(skip=skip, limit=limit)
+{%- endif %}
+
+
+@router.post("", response_model=ItemRead, status_code=status.HTTP_201_CREATED)
+async def create_item(
+    item_in: ItemCreate,
+    item_service: ItemSvc,
+):
+    """Create a new item.
+
+    Creates an item with the provided title and optional description.
+    """
+    return await item_service.create(item_in)
+
+
+@router.get("/{item_id}", response_model=ItemRead)
+async def get_item(
+    item_id: UUID,
+    item_service: ItemSvc,
+):
+    """Get a single item by ID.
+
+    Raises 404 if the item does not exist.
+    """
+    return await item_service.get_by_id(item_id)
+
+
+@router.patch("/{item_id}", response_model=ItemRead)
+async def update_item(
+    item_id: UUID,
+    item_in: ItemUpdate,
+    item_service: ItemSvc,
+):
+    """Update an item.
+
+    Supports partial updates - only provided fields are updated.
+    Raises 404 if the item does not exist.
+    """
+    return await item_service.update(item_id, item_in)
+
+
+@router.delete("/{item_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_item(
+    item_id: UUID,
+    item_service: ItemSvc,
+):
+    """Delete an item.
+
+    Raises 404 if the item does not exist.
+    """
+    await item_service.delete(item_id)
+
+
+{%- elif cookiecutter.use_sqlite %}
+
+{%- if cookiecutter.enable_pagination %}
+
+
+@router.get("", response_model=Page[ItemRead])
+def list_items(db: DBSession):
+    """List all items with pagination.
+
+    Returns a paginated list of items. Use query parameters
+    `page` and `size` to control pagination.
+    """
+    return paginate(db, select(Item))
+{%- else %}
+
+
+@router.get("", response_model=list[ItemRead])
+def list_items(
+    item_service: ItemSvc,
+    skip: int = 0,
+    limit: int = 100,
+):
+    """List all items.
+
+    Returns a list of items with offset-based pagination.
+    """
+    return item_service.get_multi(skip=skip, limit=limit)
+{%- endif %}
+
+
+@router.post("", response_model=ItemRead, status_code=status.HTTP_201_CREATED)
+def create_item(
+    item_in: ItemCreate,
+    item_service: ItemSvc,
+):
+    """Create a new item.
+
+    Creates an item with the provided title and optional description.
+    """
+    return item_service.create(item_in)
+
+
+@router.get("/{item_id}", response_model=ItemRead)
+def get_item(
+    item_id: str,
+    item_service: ItemSvc,
+):
+    """Get a single item by ID.
+
+    Raises 404 if the item does not exist.
+    """
+    return item_service.get_by_id(item_id)
+
+
+@router.patch("/{item_id}", response_model=ItemRead)
+def update_item(
+    item_id: str,
+    item_in: ItemUpdate,
+    item_service: ItemSvc,
+):
+    """Update an item.
+
+    Supports partial updates - only provided fields are updated.
+    Raises 404 if the item does not exist.
+    """
+    return item_service.update(item_id, item_in)
+
+
+@router.delete("/{item_id}", status_code=status.HTTP_204_NO_CONTENT)
+def delete_item(
+    item_id: str,
+    item_service: ItemSvc,
+):
+    """Delete an item.
+
+    Raises 404 if the item does not exist.
+    """
+    item_service.delete(item_id)
+
+
+{%- elif cookiecutter.use_mongodb %}
+
+
+@router.get("", response_model=list[ItemRead])
+async def list_items(
+    item_service: ItemSvc,
+    skip: int = 0,
+    limit: int = 100,
+):
+    """List all items.
+
+    Returns a list of items with offset-based pagination.
+    """
+    return await item_service.get_multi(skip=skip, limit=limit)
+
+
+@router.post("", response_model=ItemRead, status_code=status.HTTP_201_CREATED)
+async def create_item(
+    item_in: ItemCreate,
+    item_service: ItemSvc,
+):
+    """Create a new item.
+
+    Creates an item with the provided title and optional description.
+    """
+    return await item_service.create(item_in)
+
+
+@router.get("/{item_id}", response_model=ItemRead)
+async def get_item(
+    item_id: str,
+    item_service: ItemSvc,
+):
+    """Get a single item by ID.
+
+    Raises 404 if the item does not exist.
+    """
+    return await item_service.get_by_id(item_id)
+
+
+@router.patch("/{item_id}", response_model=ItemRead)
+async def update_item(
+    item_id: str,
+    item_in: ItemUpdate,
+    item_service: ItemSvc,
+):
+    """Update an item.
+
+    Supports partial updates - only provided fields are updated.
+    Raises 404 if the item does not exist.
+    """
+    return await item_service.update(item_id, item_in)
+
+
+@router.delete("/{item_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_item(
+    item_id: str,
+    item_service: ItemSvc,
+):
+    """Delete an item.
+
+    Raises 404 if the item does not exist.
+    """
+    await item_service.delete(item_id)
+
+
+{%- endif %}
+{%- else %}
+"""Item routes - not configured."""
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/api/routes/v1/oauth.py

@@ -0,0 +1,205 @@
+{%- if cookiecutter.enable_oauth %}
+"""OAuth2 authentication routes."""
+
+from urllib.parse import urlencode
+
+from fastapi import APIRouter, Request
+from fastapi.responses import RedirectResponse
+
+from app.api.deps import UserSvc
+from app.core.oauth import oauth
+from app.core.security import create_access_token, create_refresh_token
+
+router = APIRouter()
+
+# Frontend URL for OAuth callback redirect
+FRONTEND_URL = "http://localhost:{{ cookiecutter.frontend_port }}"
+
+{%- if cookiecutter.enable_oauth_google %}
+
+
+@router.get("/google/login")
+async def google_login(request: Request):
+    """Redirect to Google OAuth2 login page."""
+    from app.core.config import settings
+
+    redirect_uri = settings.GOOGLE_REDIRECT_URI
+    return await oauth.google.authorize_redirect(request, redirect_uri)
+
+
+{%- if cookiecutter.use_postgresql %}
+
+
+@router.get("/google/callback")
+async def google_callback(request: Request, user_service: UserSvc):
+    """Handle Google OAuth2 callback.
+
+    Creates a new user if one doesn't exist with the Google email,
+    or returns tokens for existing user. Redirects to frontend with tokens.
+    """
+    try:
+        token = await oauth.google.authorize_access_token(request)
+        user_info = token.get("userinfo")
+
+        if not user_info:
+            params = urlencode({"error": "Failed to get user info from Google"})
+            return RedirectResponse(url=f"{FRONTEND_URL}/login?{params}")
+
+        email = user_info.get("email")
+        google_id = user_info.get("sub")
+        full_name = user_info.get("name")
+
+        # Try to find existing user by OAuth ID
+        user = await user_service.get_by_oauth("google", google_id)
+
+        if not user:
+            # Try to find by email (link existing account)
+            user = await user_service.get_by_email(email)
+            if user:
+                # Link OAuth to existing account
+                user = await user_service.link_oauth(user.id, "google", google_id)
+            else:
+                # Create new user
+                user = await user_service.create_oauth_user(
+                    email=email,
+                    full_name=full_name,
+                    oauth_provider="google",
+                    oauth_id=google_id,
+                )
+
+        access_token = create_access_token(subject=str(user.id))
+        refresh_token = create_refresh_token(subject=str(user.id))
+
+        # Redirect to frontend with tokens
+        params = urlencode({
+            "access_token": access_token,
+            "refresh_token": refresh_token,
+        })
+        return RedirectResponse(url=f"{FRONTEND_URL}/auth/callback?{params}")
+
+    except Exception as e:
+        params = urlencode({"error": str(e)})
+        return RedirectResponse(url=f"{FRONTEND_URL}/login?{params}")
+
+
+{%- elif cookiecutter.use_mongodb %}
+
+
+@router.get("/google/callback")
+async def google_callback(request: Request, user_service: UserSvc):
+    """Handle Google OAuth2 callback.
+
+    Creates a new user if one doesn't exist with the Google email,
+    or returns tokens for existing user. Redirects to frontend with tokens.
+    """
+    try:
+        token = await oauth.google.authorize_access_token(request)
+        user_info = token.get("userinfo")
+
+        if not user_info:
+            params = urlencode({"error": "Failed to get user info from Google"})
+            return RedirectResponse(url=f"{FRONTEND_URL}/login?{params}")
+
+        email = user_info.get("email")
+        google_id = user_info.get("sub")
+        full_name = user_info.get("name")
+
+        # Try to find existing user by OAuth ID
+        user = await user_service.get_by_oauth("google", google_id)
+
+        if not user:
+            # Try to find by email (link existing account)
+            user = await user_service.get_by_email(email)
+            if user:
+                # Link OAuth to existing account
+                user = await user_service.link_oauth(str(user.id), "google", google_id)
+            else:
+                # Create new user
+                user = await user_service.create_oauth_user(
+                    email=email,
+                    full_name=full_name,
+                    oauth_provider="google",
+                    oauth_id=google_id,
+                )
+
+        access_token = create_access_token(subject=str(user.id))
+        refresh_token = create_refresh_token(subject=str(user.id))
+
+        # Redirect to frontend with tokens
+        params = urlencode({
+            "access_token": access_token,
+            "refresh_token": refresh_token,
+        })
+        return RedirectResponse(url=f"{FRONTEND_URL}/auth/callback?{params}")
+
+    except Exception as e:
+        params = urlencode({"error": str(e)})
+        return RedirectResponse(url=f"{FRONTEND_URL}/login?{params}")
+
+
+{%- elif cookiecutter.use_sqlite %}
+
+
+@router.get("/google/callback")
+def google_callback(request: Request, user_service: UserSvc):
+    """Handle Google OAuth2 callback.
+
+    Creates a new user if one doesn't exist with the Google email,
+    or returns tokens for existing user. Redirects to frontend with tokens.
+    """
+    import asyncio
+
+    try:
+        # Run async OAuth in sync context
+        loop = asyncio.new_event_loop()
+        token = loop.run_until_complete(oauth.google.authorize_access_token(request))
+        loop.close()
+
+        user_info = token.get("userinfo")
+
+        if not user_info:
+            params = urlencode({"error": "Failed to get user info from Google"})
+            return RedirectResponse(url=f"{FRONTEND_URL}/login?{params}")
+
+        email = user_info.get("email")
+        google_id = user_info.get("sub")
+        full_name = user_info.get("name")
+
+        # Try to find existing user by OAuth ID
+        user = user_service.get_by_oauth("google", google_id)
+
+        if not user:
+            # Try to find by email (link existing account)
+            user = user_service.get_by_email(email)
+            if user:
+                # Link OAuth to existing account
+                user = user_service.link_oauth(user.id, "google", google_id)
+            else:
+                # Create new user
+                user = user_service.create_oauth_user(
+                    email=email,
+                    full_name=full_name,
+                    oauth_provider="google",
+                    oauth_id=google_id,
+                )
+
+        access_token = create_access_token(subject=user.id)
+        refresh_token = create_refresh_token(subject=user.id)
+
+        # Redirect to frontend with tokens
+        params = urlencode({
+            "access_token": access_token,
+            "refresh_token": refresh_token,
+        })
+        return RedirectResponse(url=f"{FRONTEND_URL}/auth/callback?{params}")
+
+    except Exception as e:
+        params = urlencode({"error": str(e)})
+        return RedirectResponse(url=f"{FRONTEND_URL}/login?{params}")
+
+
+{%- endif %}
+{%- endif %}
+{%- else %}
+"""OAuth routes - not configured."""
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/api/routes/v1/sessions.py

@@ -0,0 +1,168 @@
+{%- if cookiecutter.enable_session_management and cookiecutter.use_jwt %}
+"""Session management routes."""
+
+from fastapi import APIRouter, status
+{%- if cookiecutter.use_postgresql %}
+from uuid import UUID
+{%- endif %}
+
+from app.api.deps import CurrentUser, SessionSvc
+from app.schemas.session import LogoutAllResponse, SessionListResponse, SessionRead
+
+router = APIRouter()
+
+
+{%- if cookiecutter.use_postgresql %}
+
+
+@router.get("", response_model=SessionListResponse)
+async def list_sessions(
+    current_user: CurrentUser,
+    session_service: SessionSvc,
+):
+    """Get all active sessions for the current user."""
+    sessions = await session_service.get_user_sessions(current_user.id)
+    return SessionListResponse(
+        sessions=[
+            SessionRead(
+                id=s.id,
+                device_name=s.device_name,
+                device_type=s.device_type,
+                ip_address=s.ip_address,
+                is_current=False,  # TODO: compare with current session
+                created_at=s.created_at,
+                last_used_at=s.last_used_at,
+            )
+            for s in sessions
+        ],
+        total=len(sessions),
+    )
+
+
+@router.delete("/{session_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def logout_session(
+    session_id: UUID,
+    current_user: CurrentUser,
+    session_service: SessionSvc,
+):
+    """Logout a specific session."""
+    await session_service.logout_session(session_id, current_user.id)
+
+
+@router.delete("", response_model=LogoutAllResponse)
+async def logout_all_sessions(
+    current_user: CurrentUser,
+    session_service: SessionSvc,
+):
+    """Logout from all sessions (logout from all devices)."""
+    count = await session_service.logout_all_sessions(current_user.id)
+    return LogoutAllResponse(
+        message="Successfully logged out from all sessions",
+        sessions_logged_out=count,
+    )
+
+
+{%- elif cookiecutter.use_mongodb %}
+
+
+@router.get("", response_model=SessionListResponse)
+async def list_sessions(
+    current_user: CurrentUser,
+    session_service: SessionSvc,
+):
+    """Get all active sessions for the current user."""
+    sessions = await session_service.get_user_sessions(str(current_user.id))
+    return SessionListResponse(
+        sessions=[
+            SessionRead(
+                id=str(s.id),
+                device_name=s.device_name,
+                device_type=s.device_type,
+                ip_address=s.ip_address,
+                is_current=False,
+                created_at=s.created_at,
+                last_used_at=s.last_used_at,
+            )
+            for s in sessions
+        ],
+        total=len(sessions),
+    )
+
+
+@router.delete("/{session_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def logout_session(
+    session_id: str,
+    current_user: CurrentUser,
+    session_service: SessionSvc,
+):
+    """Logout a specific session."""
+    await session_service.logout_session(session_id, str(current_user.id))
+
+
+@router.delete("", response_model=LogoutAllResponse)
+async def logout_all_sessions(
+    current_user: CurrentUser,
+    session_service: SessionSvc,
+):
+    """Logout from all sessions (logout from all devices)."""
+    count = await session_service.logout_all_sessions(str(current_user.id))
+    return LogoutAllResponse(
+        message="Successfully logged out from all sessions",
+        sessions_logged_out=count,
+    )
+
+
+{%- elif cookiecutter.use_sqlite %}
+
+
+@router.get("", response_model=SessionListResponse)
+def list_sessions(
+    current_user: CurrentUser,
+    session_service: SessionSvc,
+):
+    """Get all active sessions for the current user."""
+    sessions = session_service.get_user_sessions(current_user.id)
+    return SessionListResponse(
+        sessions=[
+            SessionRead(
+                id=s.id,
+                device_name=s.device_name,
+                device_type=s.device_type,
+                ip_address=s.ip_address,
+                is_current=False,
+                created_at=s.created_at,
+                last_used_at=s.last_used_at,
+            )
+            for s in sessions
+        ],
+        total=len(sessions),
+    )
+
+
+@router.delete("/{session_id}", status_code=status.HTTP_204_NO_CONTENT)
+def logout_session(
+    session_id: str,
+    current_user: CurrentUser,
+    session_service: SessionSvc,
+):
+    """Logout a specific session."""
+    session_service.logout_session(session_id, current_user.id)
+
+
+@router.delete("", response_model=LogoutAllResponse)
+def logout_all_sessions(
+    current_user: CurrentUser,
+    session_service: SessionSvc,
+):
+    """Logout from all sessions (logout from all devices)."""
+    count = session_service.logout_all_sessions(current_user.id)
+    return LogoutAllResponse(
+        message="Successfully logged out from all sessions",
+        sessions_logged_out=count,
+    )
+
+
+{%- endif %}
+{%- else %}
+"""Session routes - not configured."""
+{%- endif %}