bootstrap-python-fastapi/src/http_app/routes/api/books.py at 5d55e6cac61e9fb61468ce9d8ce2b8c42d939eef · OldSchoolCloud/bootstrap-python-fastapi · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
from typing import Iterable

from fastapi import APIRouter, status
from pydantic import BaseModel, ConfigDict

from domains.books import BookService, dto

router_v1 = APIRouter(prefix="/books/v1")
router_v2 = APIRouter(prefix="/books/v2")


class CreateBookResponse(BaseModel):
    book: dto.Book
    model_config = ConfigDict(
        json_schema_extra={
            "example": {
                "title": "The Hitchhiker's Guide to the Galaxy",
                "author_name": "Douglas Adams",
                "book_id": 123,
            }
        }
    )


class ListBooksResponse(BaseModel):
    books: Iterable[dto.Book]
    model_config = ConfigDict(
        json_schema_extra={
            "example": {
                "books": [
                    {
                        "title": "The Hitchhiker's Guide to the Galaxy",
                        "author_name": "Douglas Adams",
                        "book_id": 123,
                    },
                    {
                        "title": "Clean Architecture: "
                        "A Craftsman's Guide to Software Structure and Design",
                        "author_name": "Robert C. 'Uncle Bob' Martin",
                        "book_id": 321,
                    },
                ]
            }
        }
    )


class CreateBookRequest(BaseModel):
    title: str
    author_name: str

    model_config = ConfigDict(
        json_schema_extra={
            "example": {
                "title": "The Hitchhiker's Guide to the Galaxy",
                "author_name": "Douglas Adams",
            }
        }
    )


"""
The views defined here have the functionalities of two components:

- Controller: transforms data coming from the HTTP Request into
              the data model required to use the application logic

- Presenter:  transforms the data coming from the application logic
              into the format needed for the proper HTTP Response
"""


@router_v1.get("/", status_code=status.HTTP_200_OK)
async def list_books() -> ListBooksResponse:
    book_service = BookService()
    books = await book_service.list_books()
    return ListBooksResponse(books=books)


@router_v1.post("/", status_code=status.HTTP_201_CREATED)
async def create_book(
    data: CreateBookRequest,
) -> CreateBookResponse:
    book_service = BookService()
    created_book = await book_service.create_book(
        book=dto.BookData.model_validate(data, from_attributes=True)
    )
    return CreateBookResponse(book=created_book)


@router_v2.post("/", status_code=status.HTTP_201_CREATED)
async def create_book_v2(
    data: CreateBookRequest,
    some_optional_query_param: bool = False,
) -> CreateBookResponse:
    book_service = BookService()
    created_book = await book_service.create_book(
        book=dto.BookData.model_validate(data, from_attributes=True)
    )
    return CreateBookResponse(book=created_book)