from fastapi import FastAPI
from scalar_fastapi import get_scalar_api_reference

from app.routes import discovery, reviews, stats

DESCRIPTION = """
Hi, this is a read-only API exposing 20+ years of my personal media reviews of movies, books,
and television since 2001.

## What this API does

This API provides structured access to a personal media review database. Every
review includes a date, category, title, creator, genre, rating, and optional
written commentary.

## Rating scale

Ratings use a **-3.0 to 3.0** scale:

| Rating | Meaning |
|--------|---------|
| 3.0 | Masterpiece, tears flowed |
| 2.0 | Great, I was glowing for a day |
| 1.0 | Good enough use of my time |
| 0.0 | Meh, a void of space |
| -1.0 | Below average, should have spent this time knitting |
| -2.0 | Bad, I want someone to pay me for this |
| -3.0 | Terrible, I felt like I needed to use toilet paper after  |

## Getting started

- Browse available categories, genres, and creators via the **Discovery**
  endpoints
- Fetch reviews with filtering and pagination via **GET /reviews**
- Explore aggregate statistics via the **Statistics** endpoints
- Get a surprise recommendation via **GET /reviews/random**

## About

This API is a portfolio project demonstrating API design and documentation
skills. Built with [FastAPI](https://fastapi.tiangolo.com/) and documented
with [Scalar](https://scalar.com/).
"""

CUSTOM_CSS="""
.darklight-reference-promo { display: none !important; }
"""

app = FastAPI(
    title="Reviews API",
    description=DESCRIPTION,
    version="1.0.0",
    docs_url=None,
    redoc_url=None,
)


@app.get("/docs", include_in_schema=False)
async def scalar_docs():
    return get_scalar_api_reference(
        openapi_url=app.openapi_url,
        title=app.title,
        force_dark_mode_state="light",
        hide_dark_mode_toggle=True,
        default_open_all_tags=False,
        custom_css=CUSTOM_CSS,
    )

app.include_router(reviews.router)
app.include_router(discovery.router)
app.include_router(stats.router)

@app.get("/health", tags=["System"])
def health_check():
    """Verify the API is running."""
    return {"status": "ok"}