From the Pact website:
The Pact family of frameworks provide support for Consumer Driven Contracts testing.
A Contract is a collection of agreements between a client (Consumer) and an API (Provider) that describes the interactions that can take place between them.
Consumer Driven Contracts is a pattern that drives the development of the Provider from its Consumers point of view.
Pact is a testing tool that guarantees those Contracts are satisfied.
Read Getting started with Pact for more information on how to get going.
First install the package from NPM:
npm install --save-dev @pact-foundation/karma-pact @pact-foundation/pact-node
Pact-node must be installed as a peer dependency of karma-pact, as to allow developers to have more freedom to use any version of pact-node. Then, on your Karma Configuration file, add the below:
pact option can be configured using a single object to spin up a single service, or can be passed an array of objects which will spin up multiple pact services, representing each of your various provider services.
Please be sure not to have the same port number between options as they will conflict with each other. All options are passed directly into Pact Node, which has the full list of available options.
It is recommended, however, to specify the port number, consumer and provider at a minimum to prevent common issues.
karma folder under Pact JS for examples with Mocha and Jasmine.
Running multiple Pact Mock Servers
In some situations it may be useful to run multiple Pact Mock Servers. For instance, when running tests with karma, if a consumer defines contracts for several providers, the generated Pact contracts may be mixed up. A solution to solve this is to run one Pact Mock Server per provider.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Add some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request
The vision is to have a compatible
Pact implementation in all the commonly used languages, your help would be greatly appreciated!
Please search for potential answers or post question on our official Pact StackOverflow.