Request context in Flask

Introduction

The request context in Flask helps your app know details about the current web request, like the URL or form data. It makes it easy to access this info anywhere while handling that request.

When you want to get information about the current web request, like headers or form inputs.

When you need to access the current user's session data during a request.

When writing functions that depend on request details but are not directly inside a route.

When you want to safely use request data in background tasks triggered by a request.

Syntax

Flask

from flask import Flask, request

app = Flask(__name__)

# Access request data inside a route
@app.route('/example', methods=['GET', 'POST'])
def example():
    user_agent = request.headers.get('User-Agent')
    form_data = request.form.get('name')
    return f"User agent: {user_agent}, Name: {form_data}"

The request object is available only when Flask is handling a request.

Flask uses the request context to keep track of the current request data behind the scenes.

Examples

Get the visitor's IP address from the request context.

Flask

from flask import Flask, request

app = Flask(__name__)

@app.route('/')
def home():
    ip = request.remote_addr
    return f"Your IP is {ip}"

Access form data sent by the user in a POST request.

Flask

from flask import Flask, request

app = Flask(__name__)

@app.route('/submit', methods=['POST'])
def submit():
    username = request.form.get('username')
    return f"Hello, {username}!"

Read the User-Agent header from the request to know the browser info.

Flask

from flask import Flask, request

app = Flask(__name__)

@app.route('/agent')
def agent():
    agent = request.headers.get('User-Agent')
    return f"Your browser is {agent}"

Sample Program

This Flask app has one route /greet. It reads the name from URL query parameters or form data. It also reads the browser info from the request headers. Then it returns a greeting message including both.

Flask

from flask import Flask, request

app = Flask(__name__)

@app.route('/greet', methods=['GET', 'POST'])
def greet():
    name = request.args.get('name') or request.form.get('name') or 'Guest'
    user_agent = request.headers.get('User-Agent')
    return f"Hello, {name}! Your browser is {user_agent}."

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

Important Notes

The request object only works inside a request context, like inside route functions.

Trying to use request outside a request (like at app startup) will cause errors.

You can use with app.test_request_context(): to create a request context for testing.

Summary

The request context holds info about the current web request.

Use request to get data like headers, form inputs, and client IP.

It works only while handling a request, inside route functions or similar.

Practice

1. What does the Flask request object represent during a web request?

easy

A. The server configuration settings

B. The database connection for the app

C. The template rendering engine

D. Information about the current web request like headers and form data

Solution

1. Step 1: Understand the role of request in Flask

   The request object holds data about the current HTTP request, such as headers, form inputs, and client IP.

2. Step 2: Differentiate from other Flask components

   Database connections, server settings, and template engines are separate from the request context and not part of request.

3. Final Answer:

   Information about the current web request like headers and form data -> Option D

4. Quick Check:

   Request object = current web request info [OK]

Hint: Request object holds current HTTP request info [OK]

Common Mistakes:

• Confusing request with server or database objects
• Thinking request exists outside a web request
• Assuming request holds app config

2. Which of the following is the correct way to import the request object in a Flask app?

easy

A. from flask import request

B. from flask import Request

C. import flask.request

D. from flask.request import request

Solution

1. Step 1: Recall Flask import conventions

   Flask provides request as a lowercase object to import directly from flask.

2. Step 2: Check each option's syntax

   from flask import request uses correct lowercase import. from flask import Request wrongly capitalizes. import flask.request is invalid syntax. from flask.request import request tries to import from a submodule that doesn't exist.

3. Final Answer:

   from flask import request -> Option A

4. Quick Check:

   Correct import is lowercase 'request' [OK]

Hint: Import request lowercase from flask [OK]

Common Mistakes:

• Using uppercase 'Request' instead of 'request'
• Trying to import from flask.request submodule
• Using incorrect import syntax

3. Given this Flask route code, what will print(request.method) output when a user visits /hello in a browser?

from flask import Flask, request
app = Flask(__name__)

@app.route('/hello')
def hello():
    print(request.method)
    return 'Hi'

medium

A. GET

B. POST

C. PUT

D. DELETE

Solution

1. Step 1: Identify default HTTP method for browser visits

   When a user visits a URL in a browser, the request method is usually GET.

2. Step 2: Check route method defaults

   The route does not specify methods, so it accepts GET by default.

3. Final Answer:

   GET -> Option A

4. Quick Check:

   Browser visit = GET method [OK]

Hint: Browser visits use GET method by default [OK]

Common Mistakes:

• Assuming POST is default method
• Confusing route methods with request methods
• Not knowing default HTTP methods

4. What is the error in this Flask code snippet?

from flask import Flask, request
app = Flask(__name__)

@app.route('/data')
def data():
    user_agent = request.headers['User-Agent']
    return user_agent

print(request.method)

medium

A. Route decorator syntax is wrong

B. Missing import for request

C. Accessing request outside request context causes error

D. Headers attribute does not exist on request

Solution

1. Step 1: Identify where request.method is accessed

   The last line tries to print request.method outside any route or request handling function.

2. Step 2: Understand Flask request context rules

   The request object only works inside a request context, such as inside route functions. Accessing it outside causes a runtime error.

3. Final Answer:

   Accessing request outside request context causes error -> Option C

4. Quick Check:

   Request only valid inside route functions [OK]

Hint: Use request only inside route functions [OK]

Common Mistakes:

• Trying to use request globally
• Assuming request is always available
• Confusing import errors with context errors

5. You want to log the client's IP address for every request in your Flask app. Which code correctly accesses the IP using the request context inside a route?

from flask import Flask, request
app = Flask(__name__)

@app.route('/log')
def log_ip():
    # Fill in the blank
    client_ip = _____
    print(f'Client IP: {client_ip}')
    return 'Logged'

hard

A. request.client_ip

B. request.remote_addr

C. request.ip_address

D. request.headers['Client-IP']

Solution

1. Step 1: Recall how Flask exposes client IP

   Flask provides the client IP via request.remote_addr.

2. Step 2: Check other options for validity

   request.client_ip and request.ip_address do not exist. request.headers['Client-IP'] may not be set reliably.

3. Final Answer:

   request.remote_addr -> Option B

4. Quick Check:

   Client IP = request.remote_addr [OK]

Hint: Use request.remote_addr for client IP inside routes [OK]

Common Mistakes:

• Using non-existent attributes like client_ip
• Trying to get IP from headers directly
• Accessing request outside route