128 lines
4.0 KiB
Python
128 lines
4.0 KiB
Python
"""FastAPI application entrypoint."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
import time
|
|
from contextlib import asynccontextmanager
|
|
|
|
import uvicorn
|
|
from fastapi import FastAPI, Request
|
|
from fastapi.middleware.cors import CORSMiddleware
|
|
|
|
from media_library_viewer_api.auth import require_jwt_auth, validate_auth_settings
|
|
from media_library_viewer_api.config import get_settings
|
|
from media_library_viewer_api.dependencies import get_mail_queue, get_monitoring_poller
|
|
from media_library_viewer_api.logging_utils import configure_logging, describe_settings
|
|
from media_library_viewer_api.routers import backups as backups_router
|
|
from media_library_viewer_api.routers import dashboard, files, jobs, media, monitoring, tasks, users
|
|
from media_library_viewer_api.routers.settings import router as settings_router
|
|
|
|
from .services.backup_poller import get_backup_poller
|
|
from .version import get_backend_version, get_version_info
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
@asynccontextmanager
|
|
async def lifespan(app: FastAPI):
|
|
"""Application lifespan — startup/shutdown."""
|
|
settings = get_settings()
|
|
configure_logging(settings.log_level)
|
|
validate_auth_settings(settings)
|
|
logger.info("Backend startup complete: %s", describe_settings(settings))
|
|
logger.info("Managed known_hosts will be populated lazily on first successful SSH connection")
|
|
mail_queue = get_mail_queue()
|
|
monitoring_poller = get_monitoring_poller()
|
|
backup_poller = get_backup_poller()
|
|
mail_queue.start()
|
|
monitoring_poller.start()
|
|
backup_poller.start()
|
|
yield
|
|
monitoring_poller.stop()
|
|
backup_poller.stop()
|
|
mail_queue.stop()
|
|
logger.info("Backend shutdown complete")
|
|
|
|
|
|
app = FastAPI(
|
|
title="Manage API",
|
|
version=get_backend_version(),
|
|
description=(
|
|
"Manage API for Jellyfin media browsing, SSH file inspection, "
|
|
"server monitoring, and JWT-protected access."
|
|
),
|
|
lifespan=lifespan,
|
|
)
|
|
|
|
# CORS for development (Vite runs on :5173)
|
|
app.add_middleware(
|
|
CORSMiddleware,
|
|
allow_origins=[
|
|
"http://localhost:5173",
|
|
"http://localhost:3000",
|
|
"http://127.0.0.1:5173",
|
|
"http://127.0.0.1:3000",
|
|
],
|
|
allow_credentials=True,
|
|
allow_methods=["*"],
|
|
allow_headers=["*"],
|
|
)
|
|
|
|
@app.middleware("http")
|
|
async def enforce_jwt_auth(request: Request, call_next):
|
|
if request.url.path in {"/api/health", "/api/version"}:
|
|
return await call_next(request)
|
|
return await require_jwt_auth(request, call_next)
|
|
|
|
@app.middleware("http")
|
|
async def log_requests(request: Request, call_next):
|
|
"""Log every API request with timing and outcome."""
|
|
start = time.perf_counter()
|
|
client_host = request.client.host if request.client else "unknown"
|
|
logger.info("request start %s %s client=%s", request.method, request.url.path, client_host)
|
|
try:
|
|
response = await call_next(request)
|
|
except Exception:
|
|
logger.exception("request error %s %s client=%s", request.method, request.url.path, client_host)
|
|
raise
|
|
elapsed_ms = (time.perf_counter() - start) * 1000.0
|
|
logger.info(
|
|
"request end %s %s status=%s elapsed_ms=%.1f",
|
|
request.method,
|
|
request.url.path,
|
|
response.status_code,
|
|
elapsed_ms,
|
|
)
|
|
return response
|
|
|
|
|
|
# Register routers
|
|
app.include_router(dashboard.router)
|
|
app.include_router(monitoring.router)
|
|
app.include_router(media.router)
|
|
app.include_router(files.router)
|
|
app.include_router(jobs.router)
|
|
app.include_router(users.router)
|
|
app.include_router(tasks.router)
|
|
app.include_router(settings_router)
|
|
app.include_router(backups_router.router)
|
|
|
|
|
|
@app.get("/api/health")
|
|
def health_check() -> dict[str, str]:
|
|
"""Simple health check endpoint."""
|
|
logger.debug("health check requested")
|
|
return {"status": "ok"}
|
|
|
|
|
|
@app.get("/api/version")
|
|
def version_info() -> dict[str, str]:
|
|
"""Expose backend version/build metadata for the UI."""
|
|
logger.debug("version requested")
|
|
return get_version_info()
|
|
|
|
|
|
if __name__ == "__main__":
|
|
uvicorn.run(app, host="0.0.0.0", port=8000)
|