openapi-mock 2026.3.1

Serve an OpenAPI spec as a mock with respx.

Serve an OpenAPI spec as a mock with respx.

Installation

uv pip install openapi-mock

Or with pip:

pip install openapi-mock

Usage

from http import HTTPStatus

import httpx
import respx

from openapi_mock import add_openapi_to_respx

spec = {
    "openapi": "3.0.0",
    "paths": {"/pets": {"get": {"responses": {"200": {"description": "OK"}}}}},
}
with respx.mock(base_url="https://api.example.com", assert_all_called=False) as m:
    add_openapi_to_respx(mock_obj=m, spec=spec, base_url="https://api.example.com")
    response = httpx.get("https://api.example.com/pets")
assert response.status_code == HTTPStatus.OK