---
id: wiremock
version: "2.7.0"
license: OSI Approved :: Apache Software License
license_treatment: permissive
maintenance: aging
---

# wiremock — Wiremock Admin API Client

License: permissive · Maintenance: aging · Downloads: 589.1K/mo

## What it is and what it does

Wiremock is a Python client for the WireMock HTTP mocking framework, enabling developers to stub and mock external HTTP services during testing. It works with WireMock running as a standalone Java server or as a containerized service via testcontainers-python, allowing you to define request-response pairs and verify interactions from within your test code.

The library sits between your test code and a WireMock instance, providing a REST API client interface. It supports most major WireMock features for request matching, response templating, and state management, making it useful for unit tests, integration tests, and local development environments where you need to isolate external service dependencies.

Use it for:

- Mock third-party REST APIs in unit tests to avoid external dependencies and network calls.
- Stub microservices during integration testing to simulate various response scenarios and error conditions.
- Run WireMock in a Docker container via testcontainers-python for isolated, repeatable test environments.
- Verify that your application makes correct HTTP requests to external services without calling them.
- Test error handling and retry logic by configuring WireMock to return specific status codes and delays.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client library for interacting with WireMock instances to mock HTTP services in tests, supporting both standalone servers and containerized deployments.

Yes, if you need HTTP service mocking in Python tests. Low install friction, permissive license, and production-stable status make it a solid choice. The 382-day release gap warrants checking whether upstream WireMock features you need are supported, but the package remains widely used and carries no known vulnerabilities.

## Install

pip install wiremock
uv add wiremock
poetry add wiremock

## Installing wiremock

Before you install: Low install friction with only two runtime dependencies (importlib-resources and requests). Package is aging—last release was 382 days ago—but marked production/stable and supports current Python versions (3.7–3.11).

License in practice: Licensed under Apache Software License (permissive), allowing commercial and private use with minimal restrictions. No notable licensing constraints for typical adoption.

Quickstart:

pip install wiremock

from wiremock.client import WireMock

wm = WireMock()
wm.register_stub(request=..., response=...)

Requires a running WireMock server instance (either standalone Java server or via testcontainers-python) to connect to.

Verify before relying:

- Scope and completeness of WireMock feature coverage beyond 'most major' features mentioned in description.
- Whether the 382-day release gap indicates active maintenance or dormancy relative to upstream WireMock changes.
- Specific testcontainers-python integration requirements and version compatibility.

## Package facts

- License: OSI Approved :: Apache Software License (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 589.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

HTTP mocking for tests, WireMock Python client, mock REST API services, test double for web services, HTTP stub server integration, service virtualization testing, testcontainers WireMock, http-mocking, test-doubles, service-virtualization

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