Files
Aurora-Core/app/schemas/common.py
T
NixReaperandClaude Sonnet 5 340cadd99d
CI / lint (push) Canceled after 0s
CI / typecheck (push) Canceled after 0s
CI / unit-tests (push) Canceled after 0s
CI / integration-tests (push) Canceled after 0s
CI / container-build (push) Canceled after 0s
CI / dependency-audit (push) Canceled after 0s
Add GET /genres directory endpoint
GET /movies and GET /series accept a genre filter (an Aurora genre id),
but nothing exposed what those ids actually are -- genres otherwise
only ever appear embedded in a movie/series response's own genres
list. This is the resolve-by-name-first-then-filter step the frontend
needs to build real genre browsing.

No filter, no sort_by -- always alphabetical by name, same pattern as
collections/companies (genres have no categorical field or popularity/
date to sort by). page_size defaults to 50 (max 200) rather than the
20/50 used elsewhere, since genres are a small, fixed reference set
(TMDb has ~19-20 total) a client typically wants in full for a filter
dropdown, not paginated like a catalog of millions of movies.

Also fixed two stale "behind Traefik" mentions in app/main.py's module
docstring while touching this file, left over from the earlier
cPanel/host-webserver deployment change.

Co-Authored-By: Claude Sonnet 5 <[email protected]>
2026-09-06 00:05:10 -05:00

122 lines
2.4 KiB
Python

"""Shared response building blocks used across entity schemas.
These are hand-written Pydantic models, never SQLAlchemy models serialized
directly — see section 18 of the build spec.
"""
from __future__ import annotations
from datetime import date
from pydantic import BaseModel, ConfigDict
class ORMModel(BaseModel):
"""Base for schemas built from ORM rows via `model_validate(obj)`."""
model_config = ConfigDict(from_attributes=True)
class GenreOut(ORMModel):
id: str
name: str
class GenreListOut(BaseModel):
page: int
page_size: int
total_results: int
total_pages: int
results: list[GenreOut] = []
class KeywordOut(ORMModel):
id: str
name: str
class ArtworkOut(BaseModel):
id: str
type: str
language: str | None = None
width: int | None = None
height: int | None = None
aspect_ratio: float | None = None
url: str
provider: str | None = None
is_primary: bool = False
vote_average: float | None = None
class ImagesOut(BaseModel):
posters: list[ArtworkOut] = []
backdrops: list[ArtworkOut] = []
logos: list[ArtworkOut] = []
class VideoOut(BaseModel):
id: str
type: str
site: str | None = None
url: str
language: str | None = None
country: str | None = None
is_official: bool = False
published_at: date | None = None
provider: str | None = None
class ExternalIDsOut(BaseModel):
"""Provider slug -> native ID, e.g. {"tmdb": "550", "imdb": "tt0137523"}."""
model_config = ConfigDict(extra="allow")
class PersonBriefOut(BaseModel):
id: str
name: str
profile_path: str | None = None
class CastCreditOut(BaseModel):
id: str
person: PersonBriefOut
character: str | None = None
billing_order: int | None = None
episode_count: int | None = None
class CrewCreditOut(BaseModel):
id: str
person: PersonBriefOut
department: str
job: str | None = None
episode_count: int | None = None
class CreditsOut(BaseModel):
cast: list[CastCreditOut] = []
crew: list[CrewCreditOut] = []
class CompanyBriefOut(BaseModel):
id: str
name: str
company_type: str
logo_path: str | None = None
class CollectionBriefOut(BaseModel):
id: str
name: str
poster_path: str | None = None
class ErrorDetail(BaseModel):
code: str
message: str
class ErrorResponse(BaseModel):
error: ErrorDetail