Pact-Rust

Pact implementation written in Rust.

This project provides a Pact implementation written in Rust. It supports the V3 Pact specification and V4 Pact specification and provides shared libraries that can be used in other languages via foreign function interfaces (FFI).

pact-derive crate

This is currently a placeholder crate

Note: Versions prior to 0.4.0, contain code which has now migrated to the codas crate.

Ecosystem

The ecosystem is built up of multiple different crates, each which serve a different purpose.

All active crates are listed below.

Core

pact_models

This is a library that provides the Pact models and functions for reading and writing pact files.

pact_matching

This is a library that provides the Pact functions for matching requests and responses.

pact_mock_server

This is a library that implements the in-process mock server for matching HTTP requests and generating responses from a pact file. It implements the V3 Pact specification and V4 Pact specification

Library Consumers

pact_consumer

This is a library that provides the Pact consumer test support and DSL for use in Rust projects.

pact_verifier

This library provides support for verifying a provider against pact files.

External Consumers

FFI

pact_ffi

This is a library that implements exported functions using C bindings for use in foreign languages.

CLI

pact_mock_server_cli

A command line application that provides both a restful web api and command line interface to run pact mock servers and is able to manage multiple mock servers. The lifecycle of each mock server can be controlled by the restful web api or through the command line interface. It implements the V4 Pact specification.

pact_verifier_cli

Command line executable that uses the pact_verifier to be able to verify a running provider against pact files.

Plugins

pact-plugin-driver

A support library that provides an interface for interacting with Pact plugins

pact-plugin-cli

Command line executable to manage and install Pact plugins.

Satellite

pact-stub-server

Command line executable that provides a server that can generate responses based on pact files. It implements the V4 Pact specification.

Contributing

See CONTRIBUTING (PRs are always welcome!).

Documentation

Rust crate documentation is published to the Rust documentation site.

• pact_matching
• pact_models
• pact_mock_server
• pact_consumer
• pact_verifier
• pact_ffi
• pact_mock_server_cli
• pact_verifier_cli
• pact-plugin-driver
• pact-plugin-cli
• pact-stub-server

Additional documentation can be found at the main Pact website.

Contact

Join us in slack:

or

• Twitter: @pact_up
• Stack Overflow: stackoverflow.com/questions/tagged/pact

Licensing

The code in this project is licensed under a MIT license. See LICENSE.