# 项目文件：demos/first_routes.py
from typing import Annotated

from fastapi import FastAPI, Path, Query

app = FastAPI(title="第一份书籍接口")
books = {1: {"id": 1, "title": "Python 入门", "finished": False}}


@app.get("/hello")
def hello():
    # 返回字典，FastAPI 将它转换为 JSON 响应。
    return {"message": "书籍服务已启动"}


@app.get("/books/search")
def search(q: Annotated[str, Query(min_length=1)]):
    # 静态路径先注册，避免 search 先被当成 book_id。
    return [book for book in books.values() if q in book["title"]]


@app.get("/books/{book_id}")
def read_book(book_id: Annotated[int, Path(ge=1)]):
    # 此处先观察路径转换；找不到记录交回空值，后面再明确 404。
    return books.get(book_id)


@app.get("/books")
def list_books(
    finished: bool | None = None, limit: Annotated[int, Query(ge=1, le=100)] = 20
):
    selected = list(books.values())
    if finished is not None:
        selected = [book for book in selected if book["finished"] == finished]
    return selected[:limit]