wiremock-mock 2026.9.7

requests with responses

"""Use WireMock stubs with requests and responses."""

from http import HTTPStatus
from typing import Any

import requests
import responses

from wiremock_mock import add_wiremock_to_responses

stubs: dict[str, Any] = {
    "mappings": [
        {
            "request": {"method": "GET", "urlPath": "/v1/pages"},
            "response": {
                "status": 200,
                "jsonBody": {"object": "list", "results": []},
            },
        },
    ],
}
with responses.RequestsMock(assert_all_requests_are_fired=False) as m:
    add_wiremock_to_responses(
        mock_obj=m, stubs=stubs, base_url="http://notion-mock.test"
    )
    response = requests.get(url="http://notion-mock.test/v1/pages", timeout=1)
    assert response.status_code == HTTPStatus.OK  # noqa: S101

The standard responses decorator workflow is also supported by passing responses.mock while @responses.activate is active.

httpx with respx

"""Use WireMock stubs with httpx and respx."""

from http import HTTPStatus
from typing import Any

import httpx
import respx

from wiremock_mock import add_wiremock_to_respx

stubs: dict[str, Any] = {
    "mappings": [
        {
            "request": {"method": "GET", "urlPath": "/v1/pages"},
            "response": {
                "status": 200,
                "jsonBody": {"object": "list", "results": []},
            },
        },
    ],
}
with respx.mock(
    base_url="http://notion-mock.test", assert_all_called=False
) as m:
    add_wiremock_to_respx(
        mock_obj=m, stubs=stubs, base_url="http://notion-mock.test"
    )
    response = httpx.get(url="http://notion-mock.test/v1/pages")
    assert response.status_code == HTTPStatus.OK  # noqa: S101

HTTPX2 with a native mock transport

"""Use WireMock stubs with HTTPX2."""

from http import HTTPStatus
from typing import Any

import httpx2

from wiremock_mock import create_httpx2_transport

stubs: dict[str, Any] = {
    "mappings": [
        {
            "request": {"method": "GET", "urlPath": "/v1/pages"},
            "response": {
                "status": 200,
                "jsonBody": {"object": "list", "results": []},
            },
        },
    ],
}
transport = create_httpx2_transport(
    stubs=stubs, base_url="http://notion-mock.test"
)
with httpx2.Client(transport=transport) as client:
    response = client.get(url="http://notion-mock.test/v1/pages")
assert response.status_code == HTTPStatus.OK  # noqa: S101

These integrations let you use existing WireMock stub files (e.g. from the WireMock Admin API import format) without running WireMock in Docker. HTTP traffic is mocked through responses for requests clients, respx for httpx clients, or a native mock transport for httpx2 clients. To load stubs from a JSON file, use json.loads(path.read_text()).