RESPX
Mock HTTPX with awesome request patterns and response side effects.
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.