Celery integration overview in Flask

Introduction

Celery helps your Flask app do tasks in the background. This means your app stays fast and doesn't wait for slow jobs to finish.

You want to send emails without making users wait.

You need to process large files without slowing down the app.

You want to run tasks regularly, like cleaning up old data.

You want to handle tasks that take time, like image resizing.

You want to keep your app responsive while doing heavy work.

Syntax

Flask

from celery import Celery

celery_app = Celery('app_name', broker='redis://localhost:6379/0')

@celery_app.task
def background_task():
    # your code here
    pass

The broker is where Celery gets tasks from, often Redis or RabbitMQ.

Use @celery_app.task to mark functions as background tasks.

Examples

This example creates a simple task that adds two numbers in the background.

Flask

from celery import Celery

celery_app = Celery('myapp', broker='redis://localhost:6379/0')

@celery_app.task
def add(x, y):
    return x + y

Shows how to connect Celery with a Flask app and define a task to send emails.

Flask

from flask import Flask
from celery import Celery

app = Flask(__name__)
celery_app = Celery(app.name, broker='redis://localhost:6379/0')

@celery_app.task
def send_email(email):
    print(f"Sending email to {email}")

Sample Program

This Flask app has a route to reverse text in the background using Celery. When you send a POST request with JSON {"text": "hello"}, it starts the task and returns a task ID immediately.

Flask

from flask import Flask, request, jsonify
from celery import Celery

app = Flask(__name__)
celery_app = Celery(app.name, broker='redis://localhost:6379/0')

@celery_app.task
def reverse_text(text):
    return text[::-1]

@app.route('/reverse', methods=['POST'])
def reverse():
    data = request.json
    task = reverse_text.delay(data['text'])
    return jsonify({'task_id': task.id}), 202

Important Notes

Make sure Redis or your broker is running before starting Celery.

Use task.delay() to run tasks asynchronously.

Check task results with Celery's result backend if needed.

Summary

Celery lets Flask apps run slow tasks in the background.

Use a broker like Redis to manage tasks.

Mark functions with @celery_app.task to make them background jobs.

Practice

1. What is the main purpose of integrating Celery with a Flask application?

easy

A. To run tasks in the background without blocking the main app

B. To create HTML templates for the Flask app

C. To handle user authentication and sessions

D. To serve static files like images and CSS

Solution

1. Step 1: Understand Celery's role

   Celery is designed to run tasks asynchronously, meaning it handles work in the background.

2. Step 2: Connect to Flask app purpose

   Flask apps use Celery to keep the app responsive by offloading long tasks.

3. Final Answer:

   To run tasks in the background without blocking the main app -> Option A

4. Quick Check:

   Celery = background tasks [OK]

Hint: Celery = background task runner in Flask apps [OK]

Common Mistakes:

• Thinking Celery manages templates
• Confusing Celery with user login features
• Assuming Celery serves static files

2. Which of the following is the correct way to define a Celery task in a Flask app?

easy

A. @celery_app.task\ndef add(x, y): return x + y

B. celery_app.run_task(add)

C. @app.route('/task')\ndef task(): pass

D. def task(): pass

Solution

1. Step 1: Identify Celery task decorator

   Celery tasks are defined using the @celery_app.task decorator.

2. Step 2: Check syntax correctness

   @celery_app.task\ndef add(x, y): return x + y correctly decorates a function to become a Celery task.

3. Final Answer:

   @celery_app.task\ndef add(x, y): return x + y -> Option A

4. Quick Check:

   Celery task = @celery_app.task decorator [OK]

Hint: Use @celery_app.task to define tasks [OK]

Common Mistakes:

• Forgetting the @celery_app.task decorator
• Using Flask route decorators for tasks
• Calling celery_app.run_task which is invalid

3. Given this code snippet in a Flask app with Celery:

@celery_app.task
def multiply(x, y):
    return x * y

result = multiply.delay(3, 4)
print(result.get())

What will be printed?

medium

A. A task object reference

B. null

C. 12

D. An error because delay() is not valid

Solution

1. Step 1: Understand delay() usage

   Calling multiply.delay(3, 4) sends the task to Celery to run asynchronously.

2. Step 2: Using get() to wait for result

   result.get() waits for the task to finish and returns the output, which is 3 * 4 = 12.

3. Final Answer:

   12 -> Option C

4. Quick Check:

   delay() runs task, get() returns result [OK]

Hint: delay() runs task, get() fetches result [OK]

Common Mistakes:

• Thinking delay() returns the result immediately
• Confusing task object with result value
• Assuming delay() is invalid in Celery

4. You wrote this Celery task in your Flask app:

@celery_app.task
def add(x, y):
return x + y

But when you call add.delay(2, 3), it raises an IndentationError. What is the problem?

medium

A. delay() cannot be called on tasks

B. The function body is not indented properly

C. You forgot to import Celery

D. The decorator syntax is incorrect

Solution

1. Step 1: Check function indentation

   Python requires the function body to be indented under the def line.

2. Step 2: Identify error cause

   Here, return x + y is not indented, causing IndentationError.

3. Final Answer:

   The function body is not indented properly -> Option B

4. Quick Check:

   Python needs indented function bodies [OK]

Hint: Indent function body under def line [OK]

Common Mistakes:

• Ignoring Python indentation rules
• Assuming delay() is invalid
• Thinking decorator syntax is wrong

5. You want to integrate Celery with Flask using Redis as the broker. Which steps correctly describe the setup process?

hard

A. Install Celery only, define tasks without decorator, call tasks directly, no broker needed

B. Install Flask-Login, configure Celery with SQLite, define tasks with @app.route, call tasks with run()

C. Install Redis, configure Flask routes for tasks, use delay() without decorator, run Redis server

D. Install Redis, configure Celery with Redis URL, define tasks with @celery_app.task, call tasks with delay()

Solution

1. Step 1: Setup Redis broker

   Redis must be installed and running as the message broker for Celery.

2. Step 2: Configure Celery and define tasks

   Celery is configured with Redis URL, tasks use @celery_app.task, and are called with delay().

3. Final Answer:

   Install Redis, configure Celery with Redis URL, define tasks with @celery_app.task, call tasks with delay() -> Option D

4. Quick Check:

   Redis + @celery_app.task + delay() = correct setup [OK]

Hint: Use Redis broker, @celery_app.task, and delay() calls [OK]

Common Mistakes:

• Using wrong broker like SQLite
• Defining tasks without decorator
• Calling tasks with run() or no broker