Migrating to async Flask - Mini Project: Build & Apply

Migrating to async Flask

📖 Scenario: You have a simple Flask web app that handles requests synchronously. To improve performance and handle multiple requests efficiently, you want to migrate your Flask routes to use asynchronous functions.

🎯 Goal: Convert a basic synchronous Flask route into an asynchronous route using async def and await syntax, while keeping the app functional.

📋 What You'll Learn

Create a Flask app with a synchronous route

Add an async helper function to simulate an async task

Convert the route handler to an async function using async def

Use await to call the async helper inside the route

Run the Flask app with async support

💡 Why This Matters

🌍 Real World

Modern web apps often need to handle many requests efficiently. Using async Flask routes helps improve performance by not blocking the server while waiting for slow operations like network calls or database queries.

💼 Career

Understanding how to migrate synchronous Flask apps to async is valuable for backend developers working on scalable web services and APIs.

1

Create a basic synchronous Flask app

Create a Flask app by importing Flask from flask and instantiate it as app. Then define a synchronous route handler function called hello for the path "/" that returns the string "Hello, World!".

Flask

# Your code here

Hint

Start by importing Flask and creating an app instance. Then use @app.route("/") to define the route and a normal def function to return the greeting.

2

Add an async helper function

Add an asynchronous helper function called async_task that uses async def and inside it, use import asyncio and await asyncio.sleep(1) to simulate a 1-second async delay. The function should then return the string "Async task complete".

Flask

from flask import Flask

app = Flask(__name__)

@app.route("/")
def hello():
    return "Hello, World!"

# Your code here

Hint

Define an async def function and use await asyncio.sleep(1) to simulate waiting asynchronously.

3

Convert the route handler to async and call the async helper

Change the hello route handler to an asynchronous function by replacing def with async def. Inside it, call the async_task function using await and store the result in a variable called message. Then return the message variable.

Flask

from flask import Flask
import asyncio

app = Flask(__name__)

@app.route("/")
# Convert this function to async and call async_task
# Your code here

async def async_task():
    await asyncio.sleep(1)
    return "Async task complete"

Hint

Change the route function to async def and use await async_task() to get the message.

4

Run the Flask app with async support

Add the standard Flask app runner code under if __name__ == '__main__': to run the app with app.run(debug=True). This will start the Flask development server supporting async routes.

Flask

from flask import Flask
import asyncio

app = Flask(__name__)

@app.route("/")
async def hello():
    message = await async_task()
    return message

async def async_task():
    await asyncio.sleep(1)
    return "Async task complete"

# Your code here

Hint

Add the usual Flask app runner block to start the server.

Practice

1. What is the main benefit of migrating a Flask route to use async def functions?

easy

A. It disables synchronous routes in the app.

B. It automatically fixes all bugs in the Flask app.

C. It makes the app use less memory by default.

D. It allows the app to handle multiple tasks at the same time, improving speed.

Solution

1. Step 1: Understand async function purpose in Flask

   Async functions let Flask handle multiple requests or tasks without waiting for each to finish, improving concurrency.

2. Step 2: Identify the benefit of concurrency

   Handling tasks concurrently means faster response times and better resource use.

3. Final Answer:

   It allows the app to handle multiple tasks at the same time, improving speed. -> Option D

4. Quick Check:

   Async = concurrency = better speed [OK]

Hint: Async means handling many tasks at once for faster apps [OK]

Common Mistakes:

• Thinking async fixes bugs automatically
• Believing async reduces memory without changes
• Assuming async disables sync routes

2. Which of the following is the correct way to define an async route in Flask?

easy

A. async def async_route(): return 'Hello'

B. def async_route(): return 'Hello'

C. async def async_route(): await return 'Hello'

D. def async_route(): await 'Hello'

Solution

1. Step 1: Recall async function syntax

   Async functions start with async def and can use await inside.

2. Step 2: Check each option

   async def async_route(): return 'Hello' correctly defines an async function returning a string. def async_route(): return 'Hello' is sync. async def async_route(): await return 'Hello' misuses await with return. def async_route(): await 'Hello' uses await outside async.

3. Final Answer:

   async def async_route(): return 'Hello' -> Option A

4. Quick Check:

   Async function = async def [OK]

Hint: Async routes start with 'async def' keyword [OK]

Common Mistakes:

• Using await outside async functions
• Trying to await a return statement
• Defining async routes without async def

3. Given this async Flask route, what will be the output when accessed?

from flask import Flask
import asyncio
app = Flask(__name__)

@app.route('/')
async def home():
    await asyncio.sleep(0.1)
    return 'Done'

medium

A. The route crashes because Flask does not support async.

B. The route returns immediately with 'Done'.

C. The route returns 'Done' after a short delay.

D. The route causes a syntax error due to await usage.

Solution

1. Step 1: Understand async route behavior

   The route uses await asyncio.sleep(0.1) which pauses the function asynchronously for 0.1 seconds.

2. Step 2: Predict output after await

   After the short async pause, the route returns the string 'Done'. So the client sees 'Done' after a slight delay.

3. Final Answer:

   The route returns 'Done' after a short delay. -> Option C

4. Quick Check:

   Await sleep delays then returns [OK]

Hint: Await pauses async route before returning result [OK]

Common Mistakes:

• Thinking await causes syntax error
• Expecting immediate return ignoring await
• Assuming Flask can't run async routes

4. What is wrong with this async Flask route code?

from flask import Flask
app = Flask(__name__)

@app.route('/')
async def index():
    return 'Hello'

medium

A. Flask version might not support async routes causing runtime error.

B. Nothing is wrong; this is valid async Flask code.

C. Missing await keyword before return statement.

D. Async functions cannot return strings directly.

Solution

1. Step 1: Check Flask async support requirements

   Async routes require Flask 2.0+; older versions do not support async and cause errors.

2. Step 2: Analyze code correctness vs environment

   The code syntax is correct, but if Flask version is old, it will fail at runtime.

3. Final Answer:

   Flask version might not support async routes causing runtime error. -> Option A

4. Quick Check:

   Async needs Flask 2.0+ [OK]

Hint: Check Flask version supports async before using async routes [OK]

Common Mistakes:

• Assuming all Flask versions support async
• Thinking await is always required before return
• Believing async can't return strings

5. You want to migrate a Flask app to async and have a route that calls an async database query function async def fetch_data(). Which is the correct way to write the route?

hard

A. def data(): result = fetch_data(); return result

B. async def data(): result = await fetch_data(); return result

C. async def data(): result = fetch_data(); return result

D. def data(): result = await fetch_data(); return result

Solution

1. Step 1: Understand async function calls

   To call an async function like fetch_data(), you must use await inside an async function.

2. Step 2: Match route definition with async call

   The route must be async to use await. async def data(): result = await fetch_data(); return result correctly defines async route and awaits the async call.

3. Final Answer:

   async def data(): result = await fetch_data(); return result -> Option B

4. Quick Check:

   Async route + await async call = correct [OK]

Hint: Use async def and await for async calls inside routes [OK]

Common Mistakes:

• Calling async function without await
• Using await in sync functions
• Defining sync route for async calls