WireMock ORG

WireMock - flexible open source tool for building mock APIs and testing your client apps. Join us on Slack and GitHub!

74 repos
188 followers
0 following

Java 43%
Kotlin 18%
HTML 8%
JavaScript 6%
Shell 6%

WireMock - flexible, open source API mocking --- WireMock open source is supported by WireMock Cloud . Please consider trying it out if your team needs advanced capabilities such as…

WireMock - flexible, open source API mocking

---

WireMock open source is supported by WireMock Cloud. Please consider trying it out if your team needs advanced capabilities such as OpenAPI, dynamic state, data sources and more.

---

WireMock is the popular open source tool for API mocking, with over 6 million downloads per month,
and powers WireMock Cloud.

It can help you to create stable test and development environments,
isolate yourself from flaky 3rd parties and simulate APIs that don’t exist yet.

Started in 2011 as a Java library by Tom Akehurst,
now WireMock spans across multiple programming languages and technology stacks.
It can run as a library or client wrapper in many languages, or as a standalone server.
There is a big community behind the project and its ecosystem.

WireMock supports several approaches for creating mock APIs -
in code, via its REST API, as JSON files and by recording HTTP traffic proxied to another destination.
WireMock has a rich matching system, allowing any part of an incoming request to be matched against complex and precise criteria.
Responses of any complexity can be dynamically generated via the Handlebars based templating system.
Finally, WireMock is easy to integrate into any workflow due to its numerous extension points and comprehensive APIs.

Key Features

WireMock can run in unit tests, as a standalone process or a container.
Key features include:

HTTP response stubbing, matchable on URL, header and body content patterns
Configuration via a fluent Java API, JSON files and JSON over HTTP
Record/playback of stubs
Request verification
Fault and response delays injection
Per-request conditional proxying
Browser proxying for request inspection and replacement
Stateful behaviour simulation
Extensibility

Full documentation can be found at wiremock.org/docs.

Questions and Issues

If you have a question about WireMock, or are experiencing a problem you're not sure is a bug please post a message to the
WireMock Community Slack in the #help channel.

On the other hand if you're pretty certain you've found a bug please open an issue.

Log4j Notice

WireMock only uses log4j in its test dependencies. Neither the thin nor standalone JAR depends on or embeds log4j, so
you can continue to use WireMock 2.32.0 and above without any risk of exposure to the recently discovered vulnerability.

Breaking-change report

A japicmp-based report compares the
current build against the last 3.x release and lists binary-incompatible changes to
classes annotated @PublishedAPI.

If you have Claude Code installed, run the report and produce
a filtered summary in one step:

/breaking-change-report

To generate the raw report without Claude Code (which will included classes not intended to be part of the published DSL/API):

bash
./gradlew :wiremock-core:japicmp

Reports are written to wiremock-core/build/reports/japicmp/:

| File | Contents |
|------|----------|
| breaking-changes.html | Full report (all public classes) |
| breaking-changes.txt | Same, plain text |
| breaking-changes-published-api.md | Filtered to @PublishedAPI classes only (produced by the skill) |

Contributing

WireMock exists and continues to thrive due to the efforts of contributors.
Regardless of your expertise and time you could dedicate,
there're opportunities to participate and help the project!

See the [Contributing Guide](./CONTRIBUTING.md) for more information.

All public repos (74)

Show forks Show archived