Senko-san
58b98ab5ed
Adds nullable storage fields + availability column on tracks, remote source/source_id identity on albums/artists, TrackRepository.materialize() and get_or_create_remote() repos — groundwork for on-demand YTM library (placeholders saved without audio, materialized in-place on first play). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
65 lines
1.5 KiB
Python
65 lines
1.5 KiB
Python
"""Track request/response schemas."""
|
|
|
|
import datetime as dt
|
|
import uuid
|
|
|
|
from pydantic import BaseModel
|
|
|
|
|
|
class TrackOut(BaseModel):
|
|
id: uuid.UUID
|
|
title: str
|
|
artist_id: uuid.UUID
|
|
artist_name: str
|
|
album_id: uuid.UUID | None
|
|
album_title: str | None
|
|
duration_seconds: int | None
|
|
file_format: str | None
|
|
file_size: int | None
|
|
genre: str | None
|
|
year: int | None
|
|
track_number: int | None
|
|
metadata_status: str
|
|
metadata_error: str | None
|
|
enriched_at: dt.datetime | None
|
|
availability: str
|
|
source: str
|
|
has_cover: bool
|
|
created_at: dt.datetime
|
|
|
|
|
|
class TrackUpdate(BaseModel):
|
|
title: str | None = None
|
|
genre: str | None = None
|
|
year: int | None = None
|
|
|
|
|
|
class MetadataMatch(BaseModel):
|
|
"""One AcoustID candidate for the metadata editor's match picker (§A7)."""
|
|
|
|
acoustid: str
|
|
score: float
|
|
recording_mbid: str | None
|
|
release_group_mbid: str | None
|
|
title: str | None
|
|
artist: str | None
|
|
album: str | None
|
|
year: int | None
|
|
|
|
|
|
class MetadataMatchesOut(BaseModel):
|
|
items: list[MetadataMatch]
|
|
|
|
|
|
class MetadataApply(BaseModel):
|
|
"""Manual edits / accepted match applied via ``PUT /tracks/{id}/metadata``.
|
|
|
|
Sets ``metadata_status = manual`` (never overwritten by auto-enrichment)."""
|
|
|
|
title: str | None = None
|
|
artist_name: str | None = None
|
|
album_title: str | None = None
|
|
year: int | None = None
|
|
genre: str | None = None
|
|
track_number: int | None = None
|