https://github.com/pact-foundation/pact-python
Python version of Pact. Enables consumer driven contract testing, providing a mock service and DSL for the consumer project, and interaction playback and verification for the service provider project.
https://github.com/pact-foundation/pact-python
apis contract-testing hacktoberfest pact smartbear-supported
Last synced: 12 days ago
JSON representation
Python version of Pact. Enables consumer driven contract testing, providing a mock service and DSL for the consumer project, and interaction playback and verification for the service provider project.
- Host: GitHub
- URL: https://github.com/pact-foundation/pact-python
- Owner: pact-foundation
- License: mit
- Created: 2017-03-22T08:57:34.000Z (about 9 years ago)
- Default Branch: main
- Last Pushed: 2025-06-16T04:28:37.000Z (11 months ago)
- Last Synced: 2025-06-16T05:29:50.507Z (11 months ago)
- Topics: apis, contract-testing, hacktoberfest, pact, smartbear-supported
- Language: Python
- Homepage: https://pact-foundation.github.io/pact-python/
- Size: 13.6 MB
- Stars: 609
- Watchers: 21
- Forks: 143
- Open Issues: 46
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-python-testing - pact-python - Python version of Pact. Enables consumer driven contract testing, providing a mock service and DSL for the consumer project, and interaction playback and verification for the service provider project. (Design by Contract)
- awesome-specification-driven-development - Pact Python - Python version of Pact enabling consumer driven contract testing.  (Contract Testing / Pact Ecosystem)
README
# Pact Python
Fast, easy and reliable testing for your APIs and microservices.
Package
CI/CD
Meta
Community
Pact is the de-facto API contract testing tool. Replace expensive and brittle end-to-end integration tests with fast, reliable and easy to debug unit tests.
- ⚡ Lightning fast
- 🎈 Effortless full-stack integration testing - from the front-end to the back-end
- 🔌 Supports HTTP/REST and event-driven systems
- 🛠️ Configurable mock server
- 😌 Powerful matching rules prevents brittle tests
- 🤝 Integrates with Pact Broker / PactFlow for powerful CI/CD workflows
- 🔡 Supports 12+ languages
Why use Pact? Contract testing with Pact lets you:
- ⚡ Test locally
- 🚀 Deploy faster
- ⬇️ Reduce the lead time for change
- 💰 Reduce the cost of API integration testing
- 💥 Prevent breaking changes
- 🔎 Understand your system usage
- 📃 Document your APIs for free
- 🗄 Remove the need for complex data fixtures
- 🤷♂️ Reduce the reliance on complex test environments
Watch our series on the problems with end-to-end integrated tests, and how contract testing can help.
## Documentation
This readme provides a high-level overview of the Pact Python library. For detailed documentation, please refer to the [full Pact Python documentation](https://pact-foundation.github.io/pact-python). For a more general overview of Pact and the rest of the ecosystem, please refer to the [Pact documentation](https://docs.pact.io).
- [Installation](#installation)
- [Consumer testing](docs/consumer.md)
- [Provider testing](docs/provider.md)
- [Examples](examples/README.md)
Documentation for the API is generated from the docstrings in the code which you can view at [`pact-foundation.github.io/pact-python/pact`](https://pact-foundation.github.io/pact-python/api).
### Need Help
- [Join](https://slack.pact.io) our community [slack workspace][Pact Foundation Slack].
- [Stack Overflow](https://stackoverflow.com/questions/tagged/pact) is a great place to ask questions.
- Say 👋 on Twitter: [@pact_up](https://twitter.com/pact_up)
- Join a discussion 💬 on [GitHub Discussions]
- [Raise an issue][GitHub Issues] on GitHub
[Pact Foundation Slack]: https://pact-foundation.slack.com/
[GitHub Discussions]: https://github.com/pact-foundation/pact-python/discussions
[GitHub Issues]: https://github.com/pact-foundation/pact-python/issues
## Installation
The latest version of Pact Python can be installed from PyPi:
```console
pip install pact-python
# 🚀 now write some tests!
```
### Requirements
Pact Python tries to support all versions of Python that are still supported by the Python Software Foundation. Older version of Python may work, but are not officially supported.
In order to support the broadest range of use cases, Pact Python tries to impose the least restrictions on the versions of libraries that it uses.
### Telemetry
In order to get better statistics as to who is using Pact, we collect some anonymous telemetry. The only things we [record](https://docs.pact.io/metrics) are your type of OS, and the version information for the package. No personally identifiable information is sent as part of this request. You can disable telemetry by setting the environment variable `PACT_DO_NOT_TRACK=1`:
## Contributing
We welcome contributions to the Pact Python library in many forms. There are many ways to help, from writing code, to providing new examples, to writing documentation, to testing the library and providing feedback. For more information, see the [contributing guide](CONTRIBUTING.md).
[](https://github.com/pact-foundation/pact-python/graphs/contributors)