Sending simple emails in Flask - Performance & Optimization

Performance: Sending simple emails

MEDIUM IMPACT

This affects the server response time and user experience during email sending operations.

Sending an email when a user submits a form

Flask

import threading
from flask import Flask, request
from flask_mail import Mail, Message

app = Flask(__name__)
app.config.update(
    MAIL_SERVER='smtp.example.com',
    MAIL_PORT=587,
    MAIL_USE_TLS=True,
    MAIL_USERNAME='[e-mail]',
    MAIL_PASSWORD='password'
)
mail = Mail(app)

def send_async_email(app, msg):
    with app.app_context():
        mail.send(msg)

@app.route('/send', methods=['POST'])
def send_email():
    msg = Message('Hello', sender='[e-mail]', recipients=['[e-mail]'])
    msg.body = 'This is a test email'
    thread = threading.Thread(target=send_async_email, args=(app, msg))
    thread.start()  # asynchronous call
    return 'Email sending started!'

Sending email in a separate thread frees the server to respond immediately, improving user experience.

📈 Performance GainNon-blocking response, reduces INP by hundreds of milliseconds to seconds.

Sending an email when a user submits a form

Flask

from flask import Flask, request
from flask_mail import Mail, Message

app = Flask(__name__)
app.config.update(
    MAIL_SERVER='smtp.example.com',
    MAIL_PORT=587,
    MAIL_USE_TLS=True,
    MAIL_USERNAME='[e-mail]',
    MAIL_PASSWORD='password'
)
mail = Mail(app)

@app.route('/send', methods=['POST'])
def send_email():
    msg = Message('Hello', sender='[e-mail]', recipients=['[e-mail]'])
    msg.body = 'This is a test email'
    mail.send(msg)  # synchronous call
    return 'Email sent!'

The mail.send() call blocks the server until the email is sent, delaying the HTTP response and making the user wait.

📉 Performance CostBlocks server response for 500ms to several seconds depending on SMTP latency, increasing INP.

Performance Comparison

Pattern	Server Blocking	Response Delay	User Interaction Delay	Verdict
Synchronous email sending	Blocks server thread	Delays response by 500ms+	High INP, user waits	[X] Bad
Asynchronous email sending with threading	Non-blocking	Immediate response	Low INP, smooth UX	[OK] Good

Rendering Pipeline

Email sending in Flask affects server-side processing before response is sent. Synchronous sending blocks the server, delaying response and user interaction. Asynchronous sending offloads email sending to a background thread, allowing faster response.

→Server Processing

→Response Time

→User Interaction

⚠️ BottleneckServer Processing during synchronous email sending

Core Web Vital Affected

INP

This affects the server response time and user experience during email sending operations.

Optimization Tips

1Avoid synchronous email sending in request handlers to prevent blocking server response.

2Use background threads or task queues to send emails asynchronously.

3Monitor server response times in DevTools Network tab to detect blocking operations.

Performance Quiz - 3 Questions

What is the main performance problem with sending emails synchronously in a Flask route?

A It causes layout shifts on the page

B It increases CSS rendering time

C It blocks the server response, increasing user wait time

D It reduces the size of the email

DevTools: Network

How to check: Open DevTools, go to Network tab, submit the form that triggers email sending, and observe the response time of the request.

What to look for: Long response time indicates synchronous blocking; short response time with background email sending indicates good performance.

Practice

1. What is the main purpose of the Message object in Flask-Mail when sending emails?

easy

A. To configure the mail server settings

B. To hold the email's subject, sender, recipients, and body content

C. To start the Flask application

D. To receive incoming emails

Solution

1. Step 1: Understand the role of Message object

   The Message object is designed to store the email details like subject, sender, recipients, and body.

2. Step 2: Differentiate from other components

   Mail server settings are configured separately, and Flask app startup is unrelated to Message. Receiving emails is not handled by Message.

3. Final Answer:

   To hold the email's subject, sender, recipients, and body content -> Option B

4. Quick Check:

   Message object = email content holder [OK]

Hint: Message object stores email details like subject and body [OK]

Common Mistakes:

• Confusing Message with mail server configuration
• Thinking Message starts the Flask app
• Assuming Message receives emails

2. Which of the following is the correct way to send an email using Flask-Mail after creating a Message object named msg?

easy

A. mail.send(msg)

B. mail.send_message(msg)

C. send.mail(msg)

D. msg.send()

Solution

1. Step 1: Recall Flask-Mail send syntax

   The correct method to send an email is mail.send(msg), where mail is the Mail instance and msg is the Message object.

2. Step 2: Identify incorrect method names

   Options like mail.send_message, send.mail, and msg.send() are not valid Flask-Mail methods.

3. Final Answer:

   mail.send(msg) -> Option A

4. Quick Check:

   Send email = mail.send(msg) [OK]

Hint: Use mail.send() with Message object to send email [OK]

Common Mistakes:

• Using incorrect method names like send_message
• Calling send on the Message object
• Reversing mail and send order

3. Given the following Flask-Mail code snippet, what will be the output or result?

from flask_mail import Message
msg = Message(subject='Hello', sender='[e-mail]', recipients=['[e-mail]'], body='Hi there!')
mail.send(msg)

medium

A. An email with subject 'Hello' is sent from [e-mail] to [e-mail] with body 'Hi there!'

B. SyntaxError because Message requires a different parameter order

C. No email sent because body is missing

D. NameError because mail is not defined

Solution

1. Step 1: Check code completeness

   The snippet uses mail.send(msg) but does not show the mail object being created or initialized.

2. Step 2: Understand Flask-Mail usage

   Without initializing mail with Flask app and configuration, calling mail.send() will cause a NameError because mail is undefined.

3. Final Answer:

   NameError because mail is not defined -> Option D

4. Quick Check:

   Undefined mail object = NameError [OK]

Hint: Ensure mail is initialized before calling mail.send() [OK]

Common Mistakes:

• Assuming mail is auto-created
• Thinking parameter order causes syntax error
• Ignoring missing body error

4. Identify the error in this Flask-Mail email sending code:

msg = Message('Greetings', sender='[e-mail]', recipients='[e-mail]', body='Welcome!')
mail.send(msg)

medium

A. The recipients parameter should be a list, not a string

B. The sender email is missing '@' symbol

C. The Message subject must be passed as a keyword argument

D. mail.send() requires two arguments

Solution

1. Step 1: Check recipients parameter type

   The recipients argument must be a list of email addresses, but here it is a string.

2. Step 2: Validate other parameters

   The sender email is valid, subject can be positional, and mail.send() takes one argument (the Message object).

3. Final Answer:

   The recipients parameter should be a list, not a string -> Option A

4. Quick Check:

   Recipients must be list = The recipients parameter should be a list, not a string [OK]

Hint: Recipients must always be a list, even for one email [OK]

Common Mistakes:

• Passing recipients as a string
• Misplacing subject argument
• Expecting mail.send() to take multiple arguments

5. You want to send an email with Flask-Mail only if the recipient list is not empty and the body text is not empty. Which code snippet correctly implements this check before sending?

hard

A. msg = Message(subject='Hi', sender='[e-mail]', recipients=recipients, body=body)
mail.send(msg)

B. if recipients or body:
msg = Message(subject='Hi', sender='[e-mail]', recipients=recipients, body=body)
mail.send(msg)

C. if recipients and body:
msg = Message(subject='Hi', sender='[e-mail]', recipients=recipients, body=body)
mail.send(msg)

D. if not recipients and not body:
msg = Message(subject='Hi', sender='[e-mail]', recipients=recipients, body=body)
mail.send(msg)

Solution

1. Step 1: Understand the condition logic

   We want to send email only if both recipients and body are not empty, so use if recipients and body:.

2. Step 2: Analyze each option

   if recipients and body: msg = Message(subject='Hi', sender='[e-mail]', recipients=recipients, body=body) mail.send(msg) uses correct and condition. if recipients or body: msg = Message(subject='Hi', sender='[e-mail]', recipients=recipients, body=body) mail.send(msg) uses or which sends email if either is present. if not recipients and not body: msg = Message(subject='Hi', sender='[e-mail]', recipients=recipients, body=body) mail.send(msg) sends email if both are empty (wrong). msg = Message(subject='Hi', sender='[e-mail]', recipients=recipients, body=body) mail.send(msg) sends email unconditionally.

3. Final Answer:

   if recipients and body: msg = Message(subject='Hi', sender='[e-mail]', recipients=recipients, body=body) mail.send(msg) -> Option C

4. Quick Check:

   Send only if both present = if recipients and body: msg = Message(subject='Hi', sender='[e-mail]', recipients=recipients, body=body) mail.send(msg) [OK]

Hint: Use 'and' to check both recipients and body before sending [OK]

Common Mistakes:

• Using 'or' instead of 'and' for condition
• Sending email without any checks
• Checking for empty strings incorrectly