requests-mock-flask 2025.1.13

Helpers to use requests_mock and responses with a Flask test client.

requests-mock-flask

requests-mock-flask helps with testing Flask applications with httpretty, responses or requests-mock.

• Installation

• Usage example

• Use cases

• Full documentation

Installation

Requires Python 3.12+.

pip install requests-mock-flask

Usage example

"""
Examples of using requests-mock-flask with responses, requests-mock
and httpretty.
"""

from http import HTTPStatus

import flask
import httpretty  # pyright: ignore[reportMissingTypeStubs]
import requests
import requests_mock
import responses

from requests_mock_flask import add_flask_app_to_mock

app = flask.Flask(import_name="test_app")


@app.route(rule="/")
def _() -> str:
    """Return a simple message."""
    return "Hello, World!"


@responses.activate
def test_responses_decorator() -> None:
    """
    It is possible to use the helper with a ``responses`` decorator.
    """
    add_flask_app_to_mock(
        mock_obj=responses,
        flask_app=app,
        base_url="http://www.example.com",
    )

    response = requests.get(url="http://www.example.com", timeout=30)

    assert response.status_code == HTTPStatus.OK
    assert response.text == "Hello, World!"


def test_responses_context_manager() -> None:
    """
    It is possible to use the helper with a ``responses`` context manager.
    """
    with responses.RequestsMock(
        assert_all_requests_are_fired=False,
    ) as resp_m:
        add_flask_app_to_mock(
            mock_obj=resp_m,
            flask_app=app,
            base_url="http://www.example.com",
        )

        response = requests.get(url="http://www.example.com", timeout=30)

        assert response.status_code == HTTPStatus.OK
        assert response.text == "Hello, World!"


def test_requests_mock_context_manager() -> None:
    """
    It is possible to use the helper with a ``requests_mock`` context
    manager.
    """
    with requests_mock.Mocker() as resp_m:
        add_flask_app_to_mock(
            mock_obj=resp_m,
            flask_app=app,
            base_url="http://www.example.com",
        )

        response = requests.get(url="http://www.example.com", timeout=30)

    assert response.status_code == HTTPStatus.OK
    assert response.text == "Hello, World!"


def test_requests_mock_adapter() -> None:
    """
    It is possible to use the helper with a ``requests_mock`` fixture.
    """
    session = requests.Session()
    adapter = requests_mock.Adapter()
    session.mount(prefix="mock", adapter=adapter)

    add_flask_app_to_mock(
        mock_obj=adapter,
        flask_app=app,
        base_url="mock://www.example.com",
    )

    response = session.get(url="mock://www.example.com", timeout=30)

    assert response.status_code == HTTPStatus.OK
    assert response.text == "Hello, World!"


def test_httpretty_context_manager() -> None:
    """
    It is possible to use the helper with a ``httpretty`` context
    manager.
    """
    with httpretty.core.httprettized():  # type: ignore[no-untyped-call]
        add_flask_app_to_mock(
            mock_obj=httpretty,
            flask_app=app,
            base_url="http://www.example.com",
        )

        response = requests.get(url="http://www.example.com", timeout=30)

    assert response.status_code == HTTPStatus.OK
    assert response.text == "Hello, World!"

Use cases

• Use requests or other Python APIs for testing Flask applications.

• Create a test suite which can test a Flask application as well as a live web application, to make a verified fake.

• Test a service which calls a Flask application that you have the source code for.

Full documentation

See the full documentation for more information including how to contribute.