fastapi-fullstack 0.1.7__py3-none-any.whl

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/schemas/__init__.py

@@ -0,0 +1,50 @@
+"""Pydantic schemas."""
+{%- set schemas = [] %}
+{%- if cookiecutter.use_jwt or cookiecutter.include_example_crud or cookiecutter.enable_conversation_persistence or cookiecutter.enable_webhooks %}
+# ruff: noqa: I001, RUF022 - Imports structured for Jinja2 template conditionals
+{%- endif %}
+{%- if cookiecutter.use_jwt %}
+{%- set _ = schemas.extend(["UserCreate", "UserRead", "UserUpdate", "Token", "TokenPayload"]) %}
+
+from app.schemas.token import Token, TokenPayload
+from app.schemas.user import UserCreate, UserRead, UserUpdate
+{%- endif %}
+{%- if cookiecutter.enable_session_management and cookiecutter.use_jwt %}
+{%- set _ = schemas.extend(["SessionRead", "SessionListResponse", "LogoutAllResponse"]) %}
+
+from app.schemas.session import SessionRead, SessionListResponse, LogoutAllResponse
+{%- endif %}
+{%- if cookiecutter.include_example_crud and cookiecutter.use_database %}
+{%- set _ = schemas.extend(["ItemCreate", "ItemRead", "ItemUpdate"]) %}
+
+from app.schemas.item import ItemCreate, ItemRead, ItemUpdate
+{%- endif %}
+{%- if cookiecutter.enable_conversation_persistence and cookiecutter.use_database %}
+{%- set _ = schemas.extend(["ConversationCreate", "ConversationRead", "ConversationUpdate", "MessageCreate", "MessageRead", "ToolCallRead"]) %}
+
+from app.schemas.conversation import (
+    ConversationCreate,
+    ConversationRead,
+    ConversationUpdate,
+    MessageCreate,
+    MessageRead,
+    ToolCallRead,
+)
+{%- endif %}
+{%- if cookiecutter.enable_webhooks and cookiecutter.use_database %}
+{%- set _ = schemas.extend(["WebhookCreate", "WebhookRead", "WebhookUpdate", "WebhookDeliveryRead", "WebhookListResponse", "WebhookDeliveryListResponse", "WebhookTestResponse"]) %}
+
+from app.schemas.webhook import (
+    WebhookCreate,
+    WebhookRead,
+    WebhookUpdate,
+    WebhookDeliveryRead,
+    WebhookListResponse,
+    WebhookDeliveryListResponse,
+    WebhookTestResponse,
+)
+{%- endif %}
+{%- if schemas %}
+
+__all__ = {{ schemas }}
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/schemas/base.py

@@ -0,0 +1,57 @@
+"""Base Pydantic schemas."""
+
+from datetime import datetime
+from typing import Any
+from zoneinfo import ZoneInfo
+
+from pydantic import BaseModel, ConfigDict
+
+
+def serialize_datetime(dt: datetime) -> str:
+    """Serialize datetime to ISO format with timezone.
+
+    Ensures all datetimes have explicit timezone (defaults to UTC).
+    """
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=ZoneInfo("UTC"))
+    return dt.isoformat()
+
+
+class BaseSchema(BaseModel):
+    """Base schema with common configuration."""
+
+    model_config = ConfigDict(
+        from_attributes=True,
+        populate_by_name=True,
+        str_strip_whitespace=True,
+        json_encoders={datetime: serialize_datetime},
+    )
+
+    def serializable_dict(self, **kwargs: Any) -> dict[str, Any]:
+        """Return a dict with only JSON-serializable fields."""
+        from fastapi.encoders import jsonable_encoder
+
+        return jsonable_encoder(self.model_dump(**kwargs))
+
+
+class TimestampSchema(BaseModel):
+    """Schema with timestamp fields."""
+
+    created_at: datetime
+    updated_at: datetime | None = None
+
+
+class BaseResponse(BaseModel):
+    """Standard API response."""
+
+    success: bool = True
+    message: str | None = None
+
+
+class ErrorResponse(BaseModel):
+    """Standard error response."""
+
+    success: bool = False
+    error: str
+    detail: str | None = None
+    code: str | None = None

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/schemas/conversation.py

@@ -0,0 +1,192 @@
+{%- if cookiecutter.enable_conversation_persistence %}
+"""Conversation schemas for AI chat persistence.
+
+This module contains Pydantic schemas for Conversation, Message, and ToolCall entities.
+"""
+
+from datetime import datetime
+from typing import Literal
+
+{%- if cookiecutter.use_postgresql %}
+from uuid import UUID
+{%- endif %}
+
+from pydantic import Field
+
+from app.schemas.base import BaseSchema, TimestampSchema
+
+
+# =============================================================================
+# Tool Call Schemas
+# =============================================================================
+
+
+class ToolCallBase(BaseSchema):
+    """Base tool call schema."""
+
+    tool_call_id: str = Field(..., description="External tool call ID from AI framework")
+    tool_name: str = Field(..., max_length=100, description="Name of the tool called")
+    args: dict = Field(default_factory=dict, description="Tool arguments")
+
+
+class ToolCallCreate(ToolCallBase):
+    """Schema for creating a tool call record."""
+
+    started_at: datetime | None = Field(default=None, description="When the tool call started")
+
+
+class ToolCallComplete(BaseSchema):
+    """Schema for completing a tool call."""
+
+    result: str = Field(..., description="Tool execution result")
+    completed_at: datetime | None = Field(default=None, description="When the tool call completed")
+    success: bool = Field(default=True, description="Whether the tool call succeeded")
+
+
+class ToolCallRead(ToolCallBase):
+    """Schema for reading a tool call (API response)."""
+
+{%- if cookiecutter.use_postgresql %}
+    id: UUID
+    message_id: UUID
+{%- else %}
+    id: str
+    message_id: str
+{%- endif %}
+    result: str | None = None
+    status: Literal["pending", "running", "completed", "failed"] = "pending"
+    started_at: datetime
+    completed_at: datetime | None = None
+    duration_ms: int | None = None
+
+
+# =============================================================================
+# Message Schemas
+# =============================================================================
+
+
+class MessageBase(BaseSchema):
+    """Base message schema."""
+
+    role: Literal["user", "assistant", "system"] = Field(..., description="Message role")
+    content: str = Field(..., description="Message content")
+
+
+class MessageCreate(MessageBase):
+    """Schema for creating a message."""
+
+    model_name: str | None = Field(default=None, max_length=100, description="AI model used")
+    tokens_used: int | None = Field(default=None, ge=0, description="Token count")
+
+
+class MessageRead(MessageBase, TimestampSchema):
+    """Schema for reading a message (API response)."""
+
+{%- if cookiecutter.use_postgresql %}
+    id: UUID
+    conversation_id: UUID
+{%- else %}
+    id: str
+    conversation_id: str
+{%- endif %}
+    model_name: str | None = None
+    tokens_used: int | None = None
+    tool_calls: list[ToolCallRead] = Field(default_factory=list)
+
+
+class MessageReadSimple(MessageBase, TimestampSchema):
+    """Simplified message schema without tool calls."""
+
+{%- if cookiecutter.use_postgresql %}
+    id: UUID
+    conversation_id: UUID
+{%- else %}
+    id: str
+    conversation_id: str
+{%- endif %}
+    model_name: str | None = None
+    tokens_used: int | None = None
+
+
+# =============================================================================
+# Conversation Schemas
+# =============================================================================
+
+
+class ConversationBase(BaseSchema):
+    """Base conversation schema."""
+
+    title: str | None = Field(default=None, max_length=255, description="Conversation title")
+
+
+class ConversationCreate(ConversationBase):
+    """Schema for creating a conversation."""
+
+{%- if cookiecutter.use_jwt %}
+{%- if cookiecutter.use_postgresql %}
+    user_id: UUID | None = Field(default=None, description="Owner user ID")
+{%- else %}
+    user_id: str | None = Field(default=None, description="Owner user ID")
+{%- endif %}
+{%- endif %}
+    pass
+
+
+class ConversationUpdate(BaseSchema):
+    """Schema for updating a conversation."""
+
+    title: str | None = Field(default=None, max_length=255)
+    is_archived: bool | None = None
+
+
+class ConversationRead(ConversationBase, TimestampSchema):
+    """Schema for reading a conversation (API response)."""
+
+{%- if cookiecutter.use_postgresql %}
+    id: UUID
+{%- if cookiecutter.use_jwt %}
+    user_id: UUID | None = None
+{%- endif %}
+{%- else %}
+    id: str
+{%- if cookiecutter.use_jwt %}
+    user_id: str | None = None
+{%- endif %}
+{%- endif %}
+    is_archived: bool = False
+
+
+class ConversationReadWithMessages(ConversationRead):
+    """Conversation with all messages."""
+
+    messages: list[MessageRead] = Field(default_factory=list)
+
+
+class ConversationList(BaseSchema):
+    """Schema for listing conversations."""
+
+    items: list[ConversationRead]
+    total: int
+
+
+# =============================================================================
+# Aggregated Schemas for API Responses
+# =============================================================================
+
+
+class MessageList(BaseSchema):
+    """Schema for listing messages."""
+
+    items: list[MessageReadSimple]
+    total: int
+
+
+class ConversationWithLatestMessage(ConversationRead):
+    """Conversation with its latest message for list views."""
+
+    latest_message: MessageReadSimple | None = None
+    message_count: int = 0
+
+{%- else %}
+"""Conversation schemas - not configured."""
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/schemas/item.py

@@ -0,0 +1,52 @@
+{%- if cookiecutter.include_example_crud %}
+"""Item schemas - example CRUD entity.
+
+This module demonstrates standard Pydantic schemas for a CRUD entity.
+You can use it as a template for creating your own schemas.
+"""
+
+{%- if cookiecutter.use_postgresql %}
+from uuid import UUID
+{%- endif %}
+
+from pydantic import Field
+
+from app.schemas.base import BaseSchema, TimestampSchema
+
+
+class ItemBase(BaseSchema):
+    """Base item schema with common fields."""
+
+    title: str = Field(max_length=255, description="Item title")
+    description: str | None = Field(default=None, description="Item description")
+
+
+class ItemCreate(ItemBase):
+    """Schema for creating an item."""
+
+    pass
+
+
+class ItemUpdate(BaseSchema):
+    """Schema for updating an item.
+
+    All fields are optional to allow partial updates.
+    """
+
+    title: str | None = Field(default=None, max_length=255)
+    description: str | None = Field(default=None)
+    is_active: bool | None = None
+
+
+class ItemRead(ItemBase, TimestampSchema):
+    """Schema for reading an item (API response)."""
+
+{%- if cookiecutter.use_postgresql %}
+    id: UUID
+{%- else %}
+    id: str
+{%- endif %}
+    is_active: bool = True
+{%- else %}
+"""Item schemas - not configured."""
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/schemas/session.py

@@ -0,0 +1,42 @@
+{%- if cookiecutter.enable_session_management and cookiecutter.use_jwt %}
+"""Session schemas."""
+
+from datetime import datetime
+{%- if cookiecutter.use_postgresql %}
+from uuid import UUID
+{%- endif %}
+
+from pydantic import BaseModel
+
+
+class SessionRead(BaseModel):
+    """Session response schema."""
+
+{%- if cookiecutter.use_postgresql %}
+    id: UUID
+{%- else %}
+    id: str
+{%- endif %}
+    device_name: str | None = None
+    device_type: str | None = None
+    ip_address: str | None = None
+    is_current: bool = False
+    created_at: datetime
+    last_used_at: datetime
+
+
+class SessionListResponse(BaseModel):
+    """Response for list of sessions."""
+
+    sessions: list[SessionRead]
+    total: int
+
+
+class LogoutAllResponse(BaseModel):
+    """Response for logout all sessions."""
+
+    message: str
+    sessions_logged_out: int
+{%- else %}
+"""Session schemas - not configured."""
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/schemas/token.py

@@ -0,0 +1,31 @@
+{%- if cookiecutter.use_jwt %}
+"""Token schemas."""
+
+from typing import Literal
+
+from pydantic import BaseModel
+
+
+class Token(BaseModel):
+    """OAuth2 token response with refresh token."""
+
+    access_token: str
+    refresh_token: str
+    token_type: str = "bearer"
+
+
+class TokenPayload(BaseModel):
+    """JWT token payload."""
+
+    sub: str | None = None
+    exp: int | None = None
+    type: Literal["access", "refresh"] | None = None
+
+
+class RefreshTokenRequest(BaseModel):
+    """Request body for token refresh."""
+
+    refresh_token: str
+{%- else %}
+"""Token schemas - not configured."""
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/schemas/user.py

@@ -0,0 +1,64 @@
+{%- if cookiecutter.use_jwt %}
+"""User schemas."""
+
+from enum import Enum
+from uuid import UUID
+
+from pydantic import EmailStr, Field
+
+from app.schemas.base import BaseSchema, TimestampSchema
+
+
+class UserRole(str, Enum):
+    """User role enumeration for API schemas."""
+
+    ADMIN = "admin"
+    USER = "user"
+
+
+class UserBase(BaseSchema):
+    """Base user schema."""
+
+    email: EmailStr = Field(max_length=255)
+    full_name: str | None = Field(default=None, max_length=255)
+    is_active: bool = True
+
+
+class UserCreate(BaseSchema):
+    """Schema for creating a user."""
+
+    email: EmailStr = Field(max_length=255)
+    password: str = Field(min_length=8, max_length=128)
+    full_name: str | None = Field(default=None, max_length=255)
+    role: UserRole = UserRole.USER
+
+
+class UserUpdate(BaseSchema):
+    """Schema for updating a user."""
+
+    email: EmailStr | None = Field(default=None, max_length=255)
+    password: str | None = Field(default=None, min_length=8, max_length=128)
+    full_name: str | None = Field(default=None, max_length=255)
+    is_active: bool | None = None
+    role: UserRole | None = None
+
+
+class UserRead(UserBase, TimestampSchema):
+    """Schema for reading a user."""
+
+{%- if cookiecutter.use_postgresql %}
+    id: UUID
+{%- elif cookiecutter.use_sqlite or cookiecutter.use_mongodb %}
+    id: str
+{%- endif %}
+    is_superuser: bool = False
+    role: UserRole = UserRole.USER
+
+
+class UserInDB(UserRead):
+    """User schema with hashed password (internal use)."""
+
+    hashed_password: str
+{%- else %}
+"""User schemas - not configured."""
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/schemas/webhook.py

@@ -0,0 +1,89 @@
+{%- if cookiecutter.enable_webhooks and cookiecutter.use_database %}
+"""Webhook schemas."""
+
+from datetime import datetime
+{%- if cookiecutter.use_postgresql %}
+from uuid import UUID
+{%- endif %}
+
+from pydantic import BaseModel, Field, HttpUrl
+
+
+class WebhookCreate(BaseModel):
+    """Schema for creating a webhook."""
+
+    name: str = Field(..., min_length=1, max_length=255)
+    url: HttpUrl
+    events: list[str] = Field(..., min_length=1)
+    description: str | None = None
+
+
+class WebhookUpdate(BaseModel):
+    """Schema for updating a webhook."""
+
+    name: str | None = Field(None, min_length=1, max_length=255)
+    url: HttpUrl | None = None
+    events: list[str] | None = Field(None, min_length=1)
+    is_active: bool | None = None
+    description: str | None = None
+
+
+class WebhookRead(BaseModel):
+    """Schema for reading a webhook."""
+
+{%- if cookiecutter.use_postgresql %}
+    id: UUID
+{%- else %}
+    id: str
+{%- endif %}
+    name: str
+    url: str
+    events: list[str]
+    is_active: bool
+    description: str | None
+    created_at: datetime
+    updated_at: datetime
+
+
+class WebhookDeliveryRead(BaseModel):
+    """Schema for reading a webhook delivery."""
+
+{%- if cookiecutter.use_postgresql %}
+    id: UUID
+    webhook_id: UUID
+{%- else %}
+    id: str
+    webhook_id: str
+{%- endif %}
+    event_type: str
+    response_status: int | None
+    error_message: str | None
+    attempt_count: int
+    success: bool
+    created_at: datetime
+    delivered_at: datetime | None
+
+
+class WebhookListResponse(BaseModel):
+    """Response for list of webhooks."""
+
+    items: list[WebhookRead]
+    total: int
+
+
+class WebhookDeliveryListResponse(BaseModel):
+    """Response for list of webhook deliveries."""
+
+    items: list[WebhookDeliveryRead]
+    total: int
+
+
+class WebhookTestResponse(BaseModel):
+    """Response for webhook test."""
+
+    success: bool
+    status_code: int | None
+    message: str
+{%- else %}
+"""Webhook schemas - not configured."""
+{%- endif %}

fastapi_gen/template/{{cookiecutter.project_slug}}/backend/app/services/__init__.py

@@ -0,0 +1,38 @@
+"""Services layer - business logic.
+
+Services orchestrate business operations, using repositories for data access
+and raising domain exceptions for error handling.
+"""
+{%- set services = [] %}
+{%- if cookiecutter.use_jwt or cookiecutter.include_example_crud or cookiecutter.enable_conversation_persistence or cookiecutter.enable_webhooks %}
+# ruff: noqa: I001, RUF022 - Imports structured for Jinja2 template conditionals
+{%- endif %}
+{%- if cookiecutter.use_jwt %}
+{%- set _ = services.append("UserService") %}
+
+from app.services.user import UserService
+{%- endif %}
+{%- if cookiecutter.enable_session_management and cookiecutter.use_jwt %}
+{%- set _ = services.append("SessionService") %}
+
+from app.services.session import SessionService
+{%- endif %}
+{%- if cookiecutter.include_example_crud and cookiecutter.use_database %}
+{%- set _ = services.append("ItemService") %}
+
+from app.services.item import ItemService
+{%- endif %}
+{%- if cookiecutter.enable_conversation_persistence and cookiecutter.use_database %}
+{%- set _ = services.append("ConversationService") %}
+
+from app.services.conversation import ConversationService
+{%- endif %}
+{%- if cookiecutter.enable_webhooks and cookiecutter.use_database %}
+{%- set _ = services.append("WebhookService") %}
+
+from app.services.webhook import WebhookService
+{%- endif %}
+{%- if services %}
+
+__all__ = {{ services }}
+{%- endif %}