pact-jvm
JVM implementation of the consumer driven contract library pact
From the Ruby Pact website:
Define a pact between service consumers and providers, enabling "consumer driven contract" testing.
Pact provides an RSpec DSL for service consumers to define the HTTP requests they will make to a service provider and the HTTP responses they expect back. These expectations are used in the consumers specs to provide a mock service provider. The interactions are recorded, and played back in the service provider specs to ensure the service provider actually does provide the response the consumer expects.
This allows testing of both sides of an integration point using fast unit tests.
This gem is inspired by the concept of "Consumer driven contracts". See http://martinfowler.com/articles/consumerDrivenContracts.html for more information.
Contact
- Twitter: @pact_up
- Google users group: https://groups.google.com/forum/#!forum/pact-support
Links
- For an example of using pact-jvm with spring boot, have a look at https://github.com/mstine/microservices-pact
Documentation
Additional documentation can be found in the Pact Wiki, and in the Pact-JVM wiki.
Note about artifact names and versions
Pact-JVM is partially written in Scala. As Scala does not provide binary compatibility between major versions, all the Pact-JVM artifacts have the version of Scala they were built with in the artifact name. So, for example, the pact-jvm-consumer-junit module has a Jar file named pact-jvm-consumer_2.10. The full name of the file is pact-jvm-consumer_2.10-2.0.x.jar.
3.x branch
3.x branch drops support for JDK 6 and 7 as well as Scala 2.10. It will be cross-compiled with Scala 2.12 when that is released, but is currently build against Scala 2.11. All Groovy code is compiled with Invoke Dynamic instruction turned on (indy version).
2.x branch
2.x versions of pact support JDK 6 and Scala 2.10. We currently cross-compile all the artifacts against 2.10 and 2.11 versions of Scala, except for the SBT modules.
Service Consumers
Pact-JVM has a number of ways you can write your service consumer tests.
I Use Scala and Specs 2
You want to look at: pact-jvm-consumer-specs2
I Use Java
You want to look at: pact-jvm-consumer-junit
I Use Groovy or Grails
You want to look at: pact-jvm-consumer-groovy or pact-jvm-consumer-junit
(Use Clojure I)
Clojure can call out to Java, so have a look at pact-jvm-consumer-junit. For an example look at example_clojure_consumer_pact_test.clj.
I Use some other jvm language or test framework
You want to look at: Pact Consumer
My Consumer interacts with a Message Queue
As part of the V3 pact specification, we have defined a new pact file for interactions with message queues. For an implementation of a Groovy consumer test with a message pact, have a look at pact-jvm-consumer-groovy-v3.
Service Providers
Once you have run your consumer tests, you will have generated some Pact files. You can then verify your service providers with these files.
I am writing a provider and want to ...
verify pacts with SBT
You want to look at: pact sbt plugin
verify pacts with Gradle
You want to look at: pact gradle plugin
verify pacts with Maven [version 2.1.9+]
You want to look at: pact maven plugin
For publishing pacts to a pact broker, have a look at https://github.com/warmuuh/pactbroker-maven-plugin
verify pacts with JUnit tests [version 2.3.3+, 3.1.3+]
You want to look at: junit provider support
verify pacts with Leiningen [version 2.2.14+, 3.0.3+]
You want to look at: pact leiningen plugin
verify pacts with Specs2
Have a look at writing specs to validate a provider
verify pacts with a Spring MVC project
Have a look at Spring MVC Pact Test Runner
I want to verify pacts but don't want to use sbt or gradle or leiningen
You want to look at: pact-jvm-provider
verify interactions with a message queue
As part of the V3 pact specification, we have defined a new pact file for interactions with message queues. The Gradle pact plugin supports a mechanism where you can verify V3 message pacts, have a look at pact gradle plugin.
I Use Ruby or Go or something else
The pact-jvm libraries are pure jvm technologies and do not have any native dependencies.
However if you have a ruby provider, the json produced by this library is compatible with the ruby pact library. You'll want to look at: Ruby Pact.
For .Net, there is Pact-net.
For Go, there is Pact-go.
Have a look at implementations in other languages.
I Use something completely different
There's a limit to how much we can help, however check out pact-jvm-server
How do I transport my pacts from consumers to providers?
You want to look at: Pact Broker
Which is a project that aims at providing tooling to coordinate pact generation and delivery between projects.