openapi-mock

Serve an OpenAPI spec as a mock with HTTPX2, respx or responses.

Installation

uv pip install openapi-mock

Or with pip:

pip install openapi-mock

Usage

With HTTPX2

"""Example usage with HTTPX2."""

from http import HTTPStatus

import httpx2

from openapi_mock import create_httpx2_transport

spec = {
    "openapi": "3.0.0",
    "paths": {"/pets": {"get": {"responses": {"200": {"description": "OK"}}}}},
}
transport = create_httpx2_transport(
    spec=spec,
    base_url="https://api.example.com",
)
with httpx2.Client(transport=transport) as client:
    response = client.get(url="https://api.example.com/pets")
assert response.status_code == HTTPStatus.OK

With respx (httpx)

"""Example usage with respx."""

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(url="https://api.example.com/pets")
assert response.status_code == HTTPStatus.OK

With responses (requests)

"""Example usage with responses."""

from http import HTTPStatus

import requests
import responses

from openapi_mock import add_openapi_to_responses

spec = {
    "openapi": "3.0.0",
    "paths": {"/pets": {"get": {"responses": {"200": {"description": "OK"}}}}},
}
with responses.RequestsMock() as rsps:
    add_openapi_to_responses(spec=spec, base_url="https://api.example.com", mock=rsps)
    response = requests.get(url="https://api.example.com/pets", timeout=30)
assert response.status_code == HTTPStatus.OK

Metadata

Release files for openapi-mock 2026.10.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openapi-mock 2026.10.9
File	Size	Uploaded
openapi_mock-2026.10.9.tar.gz	135.9 kB	Oct 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for openapi-mock 2026.10.9
File	Interpreter	ABI	Platform	Reset
openapi_mock-2026.10.9-py3-none-any.whl 8.1 kB Oct 9, 2026	Python 3	none	any	Details

Total release size: 144.0 kB

Release files / openapi_mock-2026.10.9.tar.gz

Download URL	openapi_mock-2026.10.9.tar.gz
Size	135.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`cfba53282ede8a534e4f6c068ca77e06f060e01fda2b23caebe0e491142cbdff`
BLAKE2b-256 checksum How to use checksums	`294dd36ed592d24a914066ab1e9bb1a8ec3cc0dd6e7d73b272adc9089181d76b`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/adamtheturtle/openapi-mock
Publishing commit: github.com/adamtheturtle/openapi-mock/tree/69f3589745b453078c7f5a60b1f206a506493b35

Workflow

Publishing configuration: github.com/adamtheturtle/openapi-mock/blob/69f3589745b453078c7f5a60b1f206a506493b35/.github/workflows/release.yml
Publishing logs: github.com/adamtheturtle/openapi-mock/actions/runs/37957323560/attempts/1

Artifact

Subject: openapi_mock-2026.10.9.tar.gz
SHA-256 checksum: cfba53282ede8a534e4f6c068ca77e06f060e01fda2b23caebe0e491142cbdff Verifying attestations

Release files / openapi_mock-2026.10.9-py3-none-any.whl

Download URL	openapi_mock-2026.10.9-py3-none-any.whl
Size	8.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`058ba43b1d455f263d50c5e66ba0fb861a32e083efeefcf64767cbfdeef373eb`
BLAKE2b-256 checksum How to use checksums	`e1e537903c2a9466a697a0e9aef548c5c87c68255f621bc0d1f1ebeba82c5f0a`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/adamtheturtle/openapi-mock
Publishing commit: github.com/adamtheturtle/openapi-mock/tree/69f3589745b453078c7f5a60b1f206a506493b35

Workflow

Publishing configuration: github.com/adamtheturtle/openapi-mock/blob/69f3589745b453078c7f5a60b1f206a506493b35/.github/workflows/release.yml
Publishing logs: github.com/adamtheturtle/openapi-mock/actions/runs/37957323560/attempts/1

Artifact

Subject: openapi_mock-2026.10.9-py3-none-any.whl
SHA-256 checksum: 058ba43b1d455f263d50c5e66ba0fb861a32e083efeefcf64767cbfdeef373eb Verifying attestations