pytest_httpserver

What it is and what it does

pytest-httpserver provides a pytest fixture and standalone context manager that starts a local HTTP server to intercept and respond to client requests during tests. Instead of mocking individual HTTP calls, you define expectations—matching on URI, method, headers, query strings, and request body—and specify what response the server should send back. The server can handle permanent expectations (served repeatedly), one-shot expectations (served once), and ordered expectations (served in strict sequence). Responses can be raw data, JSON, Werkzeug Response objects, or custom functions.

The package is built on Werkzeug for HTTP parsing and request/response handling. It works both as a pytest fixture (automatically started and stopped around each test) and as a standalone context manager for non-pytest code. This approach lets you test HTTP clients in isolation without external network calls, making tests faster and more reliable.

Use it for

• Test an HTTP client library by mocking server responses without running a real server.
• Verify that your code sends the correct HTTP method, headers, and body to an API.
• Test ordered sequences of requests in a single test, ensuring your client makes calls in the right order.
• Run integration tests in CI/CD pipelines where external HTTP services may be unavailable.
• Use the standalone context manager in non-pytest code to set up temporary HTTP server expectations.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

pytest-httpserver on PyPI

Before you install

Low friction install with a single runtime dependency (Werkzeug). Actively maintained with recent commits and steady releases since 2018.

Requires Python 3.10 or later.

License in practice

License status is unclear—no SPDX identifier or raw license text is declared in the package metadata, so you should verify the actual license terms before use in proprietary or restricted contexts.

Quickstart

pip install pytest-httpserver

import pytest
from pytest_httpserver import HTTPServer

def test_client(httpserver):
    httpserver.expect_request("/foobar").respond_with_json({"foo": "bar"})
    # Your HTTP client code here
    assert requests.get(httpserver.url_for("/foobar")).json() == {"foo": "bar"}

Package facts

Evidence: pytest_httpserver-1.1.5-py3-none-any.whl

Tags

More Python Modules packages

See also pytest-httpx2 · pytest-localserver · pytest-responses · pytest-httpbin · responses · urllib3-mock · aiointercept · pytest-subprocess · mocket · httmock