Skip to content

Latest commit

 

History

History
92 lines (67 loc) · 2.32 KB

CONTRIBUTING.adoc

File metadata and controls

92 lines (67 loc) · 2.32 KB

Event Service Contributing Guide

This guide is for engineers who are working on {project-display-name}

PRs are always welcome!

For details on the V4 Pact specification, refer to https://github.com/pact-foundation/pact-specification/tree/version-4

For details on the Pact plugin framework, refer to https://github.com/pact-foundation/pact-plugins

Raising defects

Before raising an issue, make sure you have checked the open and closed issues to see if an answer is provided there. There may also be an answer to your question on stackoverflow.

Please provide the following information with your issue to enable us to respond as quickly as possible.

  1. The relevant versions of the packages you are using (plugin and Pact versions).

  2. The steps to recreate your issue.

  3. An executable code example where possible.

New features / changes

  1. Fork it

  2. Create your feature branch (git checkout -b my-new-feature)

  3. Commit your changes (git commit -am 'feat: Add some feature')

  4. Push to the branch (git push origin my-new-feature)

  5. Create new Pull Request

Commit messages

We follow the Conventional Changelog message conventions. Please ensure you follow the guidelines.

Building the plugin

To build the plugin, you need a working JVM environment (version 11+).

The build tool used is SBT and you can build the plugin by running sbt universal:stage. This will compile the plugin and put the generated files in modules/plugin/target/stage. The contents of this directory and this will need to be copied into the Pact plugin directory. See the installation instructions on {doc-url}.

Running the tests

Unit tests
sbt plugin/test
Consumer tests
sbt consumer/test
Run Pact broker
docker compose -f docker-compose.yml up -d
Upload Consumer Pact
./scripts/pact-publish.sh
Provider tests
sbt provider/test
Stop Pact broker
docker compose -f docker-compose.yml down