Skip to content

RESPX

Mock HTTPX with awesome request patterns and response side effects.

codecov PyPi Version Python Versions


QuickStart

RESPX is a simple, yet powerful, utility for mocking out the HTTPX, and HTTP Core, libraries.

Start by patching HTTPX, using respx.mock, then add request routes to mock responses.

import httpx
import respx

from httpx import Response


@respx.mock
def test_example():
    my_route = respx.get("https://foo.bar/").mock(return_value=Response(204))
    response = httpx.get("https://foo.bar/")
    assert my_route.called
    assert response.status_code == 204

Read the User Guide for a complete walk-through.

Warning

As of RESPX version 0.15.0, the API has changed, but kept with deprecation warnings, later to be broken for backward compatibility in 0.16.0. Read the Upgrade Guide for an easier transision to latest release.

Installation

Install with pip:

$ pip install respx

Requires Python 3.6+ and HTTPX 0.15+. See Changelog for older HTTPX compatibility.