Async Programming

Learn the fundamentals of async programming in FastAPI.

🎯 Core Concept

Async/await enables FastAPI to handle thousands of concurrent requests efficiently. Unlike blocking I/O that waits for network/database responses, async operations free the event loop to process other requests while waiting.

📖 What You'll Learn

In this section, you'll understand:

• Async functions with `async def` and `await`

• Concurrency vs. parallelism

• Async I/O operations (database, HTTP calls)

• Mixing sync and async code

• Performance benefits of async

💡 Async Endpoint Example

from fastapi import FastAPI
import asyncio

app = FastAPI()

@app.get("/fast")
async def fast_endpoint():
    # This runs quickly without blocking
    return {"status": "fast"}

@app.get("/slow")
async def slow_endpoint():
    # This simulates I/O operation (database call, API request, etc.)
    await asyncio.sleep(1)
    return {"status": "done", "waited": "1 second"}

Async Database Calls

from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine

@app.get("/users/{user_id}")
async def get_user(user_id: int, db: AsyncSession = Depends(get_async_db)):
    # Non-blocking database query
    result = await db.execute(
        select(User).filter(User.id == user_id)
    )
    user = result.scalars().first()
    return user

Async HTTP Requests

import aiohttp

@app.get("/fetch-data")
async def fetch_external_data():
    async with aiohttp.ClientSession() as session:
        async with session.get("https://api.example.com/data") as response:
            data = await response.json()
            return data

Concurrent Operations

import asyncio

async def process_payment(order_id: int):
    await asyncio.sleep(1)
    return {"order": order_id, "status": "paid"}

async def send_confirmation_email(order_id: int):
    await asyncio.sleep(0.5)
    return {"email_sent": True}

@app.post("/checkout")
async def checkout(order: Order):
    # Run both operations concurrently
    payment, email = await asyncio.gather(
        process_payment(order.id),
        send_confirmation_email(order.id)
    )
    return {"payment": payment, "email": email}

Real-World Usage

Async is essential for:

• **I/O Operations**: Database queries, API calls, file operations

• **Scalability**: Handle 1000s of concurrent requests with single server

• **Responsiveness**: Multiple requests don't block each other

• **Resource Efficiency**: Less overhead than threading or multiprocessing

• **Production APIs**: Standard practice for modern web APIs

🔑 Key Takeaways

• ✅ Understand the purpose of async programming

• ✅ Know when to apply this pattern

• ✅ Recognize its benefits in real-world scenarios

• ✅ Be prepared to use it in your projects

Ready to explore more? Check out the advanced section for production patterns and edge cases.