---
id: pytest-httpbin
version: "2.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# pytest-httpbin — Easily test your HTTP library against a local copy of httpbin

License: permissive · Maintenance: active · Downloads: 157.7K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 157.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

local httpbin testing, pytest http mock server, test http endpoints locally, pytest fixture httpbin, http library testing, mock http requests pytest, pytest-plugin, http-testing, test-fixtures

[View on SkillFed](https://skillfed.io/packages/pytest-httpbin) · [View on PyPI](https://pypi.org/project/pytest-httpbin/)