Async email sending in Flask - Step-by-Step Execution

Concept Flow - Async email sending

User triggers email send

↓

Start async task

↓

Email sending runs in background

↓

Main app continues running

↓

Email sent successfully or error handled

↓

Async task ends

This flow shows how an email send request starts an asynchronous task that runs in the background, letting the main app continue without waiting.

Execution Sample

Flask

from flask import Flask
from threading import Thread

app = Flask(__name__)

def send_email():
    print('Email sent!')

@app.route('/send-email')
def trigger_email():
    thread = Thread(target=send_email)
    thread.start()
    return 'Email sending started!'

#if __name__ == '__main__':
#    app.run(debug=True)

This code defines a Flask app, a simple send_email function, and a /send-email route that starts it asynchronously using a background thread.

Execution Table

Step	Action	Thread State	Main App State	Output
1	User calls /send-email route	Not started	Waiting for response	No output yet
2	Start new thread for send_email()	Started	Returns response immediately	No output yet
3	Main app continues processing other requests	Running in background	Ready for new requests	No output yet
4	send_email() function runs in thread	Running	Independent	Prints 'Email sent!'
5	send_email() completes	Finished	Main app unaffected	Email sent! printed
6	Thread ends	Stopped	Main app still running	No further output

💡 Thread finishes after sending email; main app never waits for it.

Variable Tracker

Variable	Start	After Step 2	After Step 4	Final
Thread	None	Thread started	Thread running	Thread finished
Main App	Running	Running	Running	Running

Key Moments - 3 Insights

Why doesn't the main app wait for the email to send?

Because the email sending runs in a separate thread (see Step 2 and 3 in execution_table), the main app returns the response immediately without waiting.

What happens if the email sending takes a long time?

The main app is unaffected and continues serving other requests because the email sending runs asynchronously in the background thread (Step 3).

How do we know the email was sent?

The send_email function prints 'Email sent!' when it runs (Step 4), showing the async task completed.

Visual Quiz - 3 Questions

Look at the execution table, at which step does the main app return a response to the user?

A Step 2

B Step 4

C Step 5

D Step 6

💡 Hint

Check the 'Main App State' column for when it returns response immediately.

At which step does the email sending function print 'Email sent!'?

A Step 3

B Step 4

C Step 5

D Step 6

💡 Hint

Look at the 'Output' column for when 'Email sent!' is printed.

If we did not use a thread, what would happen to the main app during email sending?

A It would crash

B It would continue immediately without waiting

C It would wait until email sending finishes

D It would send multiple emails

💡 Hint

Think about synchronous vs asynchronous behavior in the 'Main App State' column.

Concept Snapshot

Async email sending in Flask:
- Use a background thread to send email
- Main app returns response immediately
- Email sending runs independently
- Prevents blocking user requests
- Use threading.Thread(target=send_email).start()

Full Transcript

This visual execution shows how Flask can send emails asynchronously using threads. When a user triggers the email send, the app starts a new thread to run the send_email function. The main app immediately returns a response without waiting. The email sending happens in the background thread, printing 'Email sent!' when done. This keeps the app responsive and prevents delays. Variables like the thread state and main app state change step-by-step, showing how the async task runs separately. Key moments clarify why the main app doesn't wait and how the email send completes. Quiz questions test understanding of when the response returns and when the email is sent.