Files
FabledCurator/backend/app/api/artists.py
T
bvandeusen 87d53db0cb
CI / lint (push) Successful in 3s
CI / frontend-build (push) Successful in 21s
CI / backend-lint-and-test (push) Successful in 32s
CI / integration (push) Successful in 3m35s
feat(artist): editable display name + rename surface; drop name-uniqueness (#130 step 1)
First step of decoupling artist identity/storage/display. migration 0077 drops
uq_artist_name so the display name is free text (two genuinely different creators
can share a name); the slug stays the immutable, unique storage/identity key (the
on-disk path component — untouched, so nothing moves). ArtistService.rename +
PATCH /api/artists/<id> change the name ONLY. Frontend: inline pencil-edit on the
artist header (mirrors TagCard), slug/route unaffected so no navigation. Fixes the
operator's 'no surface to rename an artist' + the name-collision fragility.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CDgx8bQS5YrGRK76v8HUnM
2026-07-04 22:04:20 -04:00

102 lines
3.7 KiB
Python

"""FC-3a: plural /api/artists endpoints — POST (find-or-create) +
autocomplete. FC-3f: GET /api/artists/directory (cursor-paginated
browse grid). The slug-routed singular /api/artist/<slug> blueprint
stays separate and unmodified."""
from quart import Blueprint, jsonify, request
from ..extensions import get_session
from ..services.artist_directory_service import ArtistDirectoryService
from ..services.artist_service import ArtistService
from ..services.source_service import KNOWN_PLATFORMS
artists_bp = Blueprint("artists", __name__, url_prefix="/api/artists")
@artists_bp.route("", methods=["POST"])
async def create_or_get():
body = await request.get_json()
if not isinstance(body, dict):
return jsonify({"error": "invalid_body"}), 400
name = body.get("name", "")
async with get_session() as session:
svc = ArtistService(session)
try:
artist, created = await svc.find_or_create(name)
except ValueError as exc:
return jsonify({"error": "empty_name", "detail": str(exc)}), 400
return jsonify({
"id": artist.id, "name": artist.name, "slug": artist.slug,
"created": created,
}), 201
@artists_bp.route("/<int:artist_id>", methods=["PATCH"])
async def rename(artist_id: int):
"""Rename an artist's DISPLAY NAME (#130). Name only — the slug and every
on-disk path stay put, so this is instant and safe. Name is non-unique."""
body = await request.get_json()
if not isinstance(body, dict) or not isinstance(body.get("name"), str):
return jsonify({"error": "invalid_body"}), 400
async with get_session() as session:
svc = ArtistService(session)
try:
artist = await svc.rename(artist_id, body["name"])
except ValueError as exc:
return jsonify({"error": "empty_name", "detail": str(exc)}), 400
if artist is None:
return jsonify({"error": "not_found"}), 404
return jsonify({"id": artist.id, "name": artist.name, "slug": artist.slug})
@artists_bp.route("/autocomplete", methods=["GET"])
async def autocomplete():
q = request.args.get("q") or ""
try:
limit = int(request.args.get("limit", "20"))
except ValueError:
return jsonify({"error": "invalid_limit"}), 400
if limit < 1 or limit > 100:
return jsonify({"error": "invalid_limit"}), 400
async with get_session() as session:
rows = await ArtistService(session).autocomplete(q, limit=limit)
return jsonify([
{"id": a.id, "name": a.name, "slug": a.slug} for a in rows
])
@artists_bp.route("/directory", methods=["GET"])
async def directory():
"""FC-3f: cursor-paginated artists directory.
Mirrors /api/tags/directory shape: { cards: [...], next_cursor }.
"""
args = request.args
cursor = args.get("cursor") or None
q = args.get("q") or None
platform = args.get("platform") or None
limit_raw = args.get("limit", "60")
try:
limit = int(limit_raw)
except ValueError:
return jsonify({"error": "invalid_limit"}), 400
if limit < 1 or limit > 200:
return jsonify({"error": "invalid_limit"}), 400
if platform is not None and platform not in KNOWN_PLATFORMS:
return jsonify({"error": "unknown_platform"}), 400
async with get_session() as session:
svc = ArtistDirectoryService(session)
try:
page = await svc.list_artists(
q=q, platform=platform, cursor=cursor, limit=limit,
)
except ValueError:
# Service raises only on bad cursor (limit was validated above).
return jsonify({"error": "invalid_cursor"}), 400
return jsonify({"cards": page.cards, "next_cursor": page.next_cursor})