pytest-httpbin

What it is and what it does

pytest-httpbin is a pytest plugin that injects a fixture providing a local HTTP server running httpbin—a service designed to test HTTP client libraries. Instead of making test requests to a remote httpbin.org service, your tests run against a server started in a separate thread on your machine, eliminating network latency and external dependencies.

You use it by accepting the httpbin fixture in your test function and accessing its URL property to make requests. The package supports both HTTP and HTTPS (with its own CA certificate included), and integrates seamlessly with pytest's fixture injection model. It's built on httpbin, which provides endpoints for testing GET, POST, headers, redirects, status codes, and other HTTP behaviors.

Use it for:

• Test HTTP client code without relying on external services or network connectivity.
• Verify your application's HTTP request handling against a predictable local server.
• Run fast, isolated test suites that don't depend on httpbin.org availability.
• Test HTTPS endpoints and certificate handling using the included CA certificate.
• Develop and validate HTTP client libraries in CI/CD pipelines without network calls.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a pytest fixture that runs a local httpbin server in a test thread, eliminating the need for remote HTTP service calls during testing.

Yes. This is a stable, actively maintained testing utility with minimal dependencies and no known vulnerabilities. If you test HTTP client code and want to avoid remote service calls, it directly solves that problem with a clean pytest integration. The low install friction and permissive license make adoption straightforward.

Install

pytest-httpbin on PyPI

pip install pytest-httpbin

uv add pytest-httpbin

poetry add pytest-httpbin

Installing pytest-httpbin

Before you install

Low friction install with a single runtime dependency (httpbin). Actively maintained with recent commits and stable production status across Python 3.8–3.11.

License in practice

MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects.

Quickstart

pip install pytest-httpbin

# In your test file:
def test_http_get(httpbin):
    response = httpbin.url + '/get'
    assert response is not None

Verify before relying

• Whether the included CA certificate works with standard HTTPS validation workflows without additional configuration.

Package facts

Evidence: pytest_httpbin-2.1.0-py3-none-any.whl

Keywords: pytest-httpbin, testing, pytest, httpbin

Tags

More Libraries packages