Pact Reference Implementation

Reference implementations for the Pact Specification written in Rust

This project contains a reference implementation of the Pact specification written in Rust, often referred to as the Pact Core.

Usage

Rust

For Rust projects, you can use the Rust crates from this library in your project directly. Refer to the Rust project readme. Requires minimum Rust 1.71.0.

Other languages

FFI

This project contains dynamic libraries that expose the core functionality through FFI (Foreign Function Interface).

For examples:

• C - Consumer
• C - Provider
• Various Languages

For implementations:

Ecosystem graph

• Javascript via pact-js-core
• Ruby via pact-ruby-ffi
• PHP via pact-php
• GoLang via pact-go
• .NET via pact-net
• Swift via pact-swift
• Dart via pact-dart
• C++ via pact-cplusplus
• Python via pact-python

CLI

This project contains code to support exposing the core functionality through CLI (Command Line Interface).

• pact_mock_server_cli
• pact_verifier_cli
• pact-stub-server-cli

They are distributed in binary & Docker formats.

Building

To build the libraries in this project, you need a working Rust environment. Requires minimum Rust 1.59.0. Refer to the Rust Guide.

The build tool used is cargo.

cd rust
cargo build

This will compile all the libraries and put the generated files in rust/target/debug.

Contributing

See CONTRIBUTING (PRs are always welcome!).

Documentation

Rust library documentation is published to the Rust documentation site. Refer to the Rust project README.

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.