PUT HTTP Request Method

 PUT HTTP Request Method

  • Used to update data
  • PUT can have a body that has additional information (like POST) that GET does not have
  • Example of body:
    • {"title": "Title Six", "author": "Author Two", "category": "science"}

Code and Result:

# This code is to create the api endpoint for providing list of books as result to user whenever a link is clicked.
from fastapi import Body, FastAPI

app = FastAPI() # allow uvicorn to identify the application is created by using FastAPI and it is the entry point for the application.
# This is the first API endpoint that will be created to return a simple message.


BOOKS = [
    {'title': 'Title one', 'author': 'Author one', 'category': 'science'},
    {'title': 'Title two', 'author': 'Author two', 'category': 'science'},
    {'title': 'Title three', 'author': 'Author three', 'category': 'history'},
    {'title': 'Title four', 'author': 'Author four', 'category': 'math'},
    {'title': 'Title five', 'author': 'Author five', 'category': 'math'}
]
@app.get("/api-endpoint") # It is a decorator that tells FastAPI that this function is an API endpoint and will call the function below when a GET request is made to the specified path.
async def first_api():
    return {"message": "Hello Puneet!"}

@app.get("/books") # Static path parameter is used here.
async def read_all_books():
    """
    This function returns the list of books.
    """
    return BOOKS

@app.get("/books/mybooks") # Static path parameter is used here.
async def read_all_books():
    """
    This function returns the list of books.
    """
    return {'book_title': 'My Favorite Book!'}

@app.get("/books/{book_title}") # Dynamic path parameter is used here.
async def read_book(book_title: str):
    """
    This function returns the book details based on the book title.
    """
    for book in BOOKS:
        if book.get('title').casefold() == book_title.casefold():
            # casefold() is used to make the comparison case-insensitive
            return book


"""
@app.get("/books/{dynamic_param}") # General one to just show what is passed in dynamic path parameter.
async def read_all_books(dynamic_param: str):
"""
"""
    This function returns the list of books based on the dynamic parameter.
"""
"""
    return {"dynamic_param": dynamic_param}
"""


@app.get("/book/") # Here fastapi will understand that this path is not using dynamic parameter but using query parameter.
async def read_category_by_query(category: str):
    """
    This function returns the list of books based on the category.
    """
    book_to_return = []
    for book in BOOKS:
        if book.get('category').casefold() == category.casefold():
            book_to_return.append(book)
    return book_to_return

@app.get("/book/{book_author}/")
async def read_books_by_author_category_query(book_author: str, category: str = None):
    """
    This function returns the list of books based on the author.
    """
    book_to_return = []
    for book in BOOKS:
        if (book.get('author').casefold() == book_author.casefold()) and (category is None or book.get('category').casefold() == category.casefold()):
            book_to_return.append(book)
    return book_to_return


@app.post("/books/create_book") # This is a POST request to create a new book.
async def create_book(new_book=Body()):
    """
    This function creates a new book and adds it to the list of books.
    """
    BOOKS.append(new_book)
    return {"message": "Book created successfully!", "book": new_book, "total_books": len(BOOKS), "all_books": BOOKS}


@app.put("/books/update_book") # This is a PUT request to update an existing book.
async def update_book(updated_book=Body()):
    """
    This function updates an existing book in the list of books.
    """
    for i in range(len(BOOKS)):
        if BOOKS[i].get('title').casefold() == updated_book.get('title').casefold():
            BOOKS[i] = updated_book
            return {"message": "Book updated successfully!", "book": updated_book, "total_books": len(BOOKS), "all_books": BOOKS}
    return {"message": "Book not found!"}




Comments

Post a Comment

Popular posts from this blog

Post Request with Pydantic usage (input validator)

Image
Post Request by using Pydantic Pydantic Python library that is used for data modeling, data parsing and has efficient error handling. Pydantics is commonly used as a resource for data validation and how to handle data coming to our FastAPI application. Pydantic implementation mechanism Create a different request model for data validation Field data validation on each variable/element BaseModel is the Pydantics BaseModel class which will provide facility to validate data. Field is the keyword to do it. As it will help to provide constraints for data validation. sample class BookRequest(BaseModel):     id: int = Field(gt=0)     title: str = Field(min_length=3)     author: str = Field(min_length=1)     description: str = Field(min_length=1, max_length=100)     rating: int = Field(gt=0, lt=5) Book Request and Book Conversion We will convert the Pydantic Request into a Book Example for post request method @app.post("/create_book") async def c...
Read more

Code Scalability and Routing

Image
 Creating Authentication file As we need to keep authentication part separate from our main application working so that we will not mess-up with our main application logic and it's security settings and authentication criteria as well as logics. auth.py - Basic authentication code stub. # This file is to define authenticator and authorization for the Todo application. from fastapi import FastAPI , status app = FastAPI () @ app . get ( "/auth" , status_code = status . HTTP_200_OK ) async def get_user ():     return { 'user' : 'authenticated_user' } Create Routers Package Here we want to use both and auth.py and main.py file to run together and to allow routers to run smoothly and want to scale the project code. To make this possible we need to use router facility or FastAPI. Here we are going to have a main file is a route of our application and routes will sit on this main file and will help in performing the tasks on call from main file. To make i...
Read more

CRUD Assignment

Image
 CRUD Assignment 1. Create a new API Endpoint that can fetch all books from a specific author using either Path Parameters or Query Parameters. Code and Result: As async is implemented by FastAPI itself hence ignored it. from fastapi import FastAPI app = FastAPI () BOOKS = [         { "title" : "Book One" , "author" : "Author A" , "category" : "Fiction" },         { "title" : "Book Two" , "author" : "Author B" , "category" : "Non-Fiction" },         { "title" : "Book Three" , "author" : "Author A" , "category" : "Biography" },         { "title" : "Book Four" , "author" : "Author A" , "category" : "Historical" },         { "title" : "Book Five" , "author" : "Author A" , "category" : "Romanc...
Read more