Reads the active media server and mirrors it into video.db, adapting the music scan pattern (ask the server, upsert, prune what's gone) — isolated from music. - core/video/scanner.py: server-agnostic VideoLibraryScanner. Consumes a media source (duck-typed) yielding normalized dicts; upserts movies + show trees, prunes removed items, reports progress/state. Skips pruning when a scan returns nothing (transient-failure safety). Background thread + scan_sync. - core/video/sources.py: Plex + Jellyfin adapters that REUSE the shared connected clients (MediaServerEngine) but own all video-section logic; produce normalized dicts. (Validated against a live server by design; scanner itself is fully unit-tested with a fake source.) - api/video/scan.py: POST /api/video/scan/request, GET /api/video/scan/status. - .gitignore: video_library.db + sidecars (mirrors music); tests inject a tmp DB so none is ever created in the repo. Tests: scan populate/prune/empty-safety/no-source-error, isolation guard (core/video imports nothing from music), scan routes registered. 101 green.
45 lines
1.4 KiB
Python
45 lines
1.4 KiB
Python
"""SoulSync — VIDEO side API package (isolated).
|
|
|
|
A SEPARATE Flask blueprint from the music API (api_v1). It reads only
|
|
database/video_library.db via VideoDatabase and imports nothing from the music
|
|
API or music database layer. Registered in web_server.py with a single additive
|
|
line at url_prefix '/api/video', so music routing is untouched.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import threading
|
|
|
|
from flask import Blueprint
|
|
|
|
from utils.logging_config import get_logger
|
|
|
|
logger = get_logger("video_api")
|
|
|
|
# Lazily-created, process-wide VideoDatabase handle. VideoDatabase itself guards
|
|
# schema init once-per-path, so this just avoids re-opening the wrapper.
|
|
_video_db = None
|
|
_video_db_lock = threading.Lock()
|
|
|
|
|
|
def get_video_db():
|
|
"""Return the shared VideoDatabase instance (created on first use)."""
|
|
global _video_db
|
|
if _video_db is None:
|
|
with _video_db_lock:
|
|
if _video_db is None:
|
|
from database.video_database import VideoDatabase
|
|
_video_db = VideoDatabase()
|
|
return _video_db
|
|
|
|
|
|
def create_video_blueprint() -> Blueprint:
|
|
"""Build the isolated /api/video blueprint with all video sub-routes."""
|
|
bp = Blueprint("video_api", __name__)
|
|
|
|
from .dashboard import register_routes as reg_dashboard
|
|
from .scan import register_routes as reg_scan
|
|
reg_dashboard(bp)
|
|
reg_scan(bp)
|
|
|
|
return bp
|