# @nialloc9/pact-provider

> An abstraction over pact.io's provider tests to hide away any complexities with integrating pact into your pipeline

Latest version **1.1.4** (published 2019-12-19) · ISC license · 0 weekly downloads

## Install

```sh
npm install @nialloc9/pact-provider
pnpm add @nialloc9/pact-provider
yarn add @nialloc9/pact-provider
bun add @nialloc9/pact-provider
```

Provides the command `pact-provider`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.4 |
| Published | 2019-12-19 |
| First published | 2019-12-17 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 11 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Niall O' Connor |
| Maintainers | nialloc9 |
| Keywords | pact, provider, tests, cli |

## Links

- npm: https://www.npmjs.com/package/@nialloc9/pact-provider
- Repository: https://github.com/nialloc9/pact-provider
- Homepage: https://github.com/nialloc9/pact-provider#readme
- Issues: https://github.com/nialloc9/pact-provider/issues
- npm.io page: https://npm.io/package/@nialloc9/pact-provider

## Dependencies (3)

- [jest-cli](https://npm.io/package/jest-cli.md) ^24.9.0
- [minimist](https://npm.io/package/minimist.md) ^1.2.0
- [@pact-foundation/pact](https://npm.io/package/@pact-foundation/pact.md) ^9.5.1

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 1.1.4 (latest) — 2019-12-19
- 1.1.3 — 2019-12-19
- 1.1.2 — 2019-12-18
- 1.1.1 — 2019-12-18
- 1.1.0 — 2019-12-18
- 1.0.2 — 2019-12-17
- 1.0.1 — 2019-12-17
- 1.0.0 — 2019-12-17

## README

# pact-provider

<p align="center">
  <img src="/logo.png" width="200" title="Pact provider logo">
</p>

An abstraction over pact.io's provider tests to hide away any complexities with integrating pact into your pipeline. 

To help with the buy in from other teams and to get them to integrate contract testing it is important to make it as easy as possible. To do this pact-provider is a reusable abstraction over the provider tests to allow data sources to run just 1 function inside their pipeline to run against our consumer contracts in the broker. 

This allows us to update the contract versions without having the data source update their code. Instead we can just ask them to update their version of the package (or have them always install latest).

## Usage CLI
    $ npm i -g @nialloc9/pact-provider

    $ pact-provider --contractName=NameOfContract --pactBrokerUrl=https://MY_BROKER.pact.dius.com.au/ --pactBrokerToken=XXXX

<details><summary>Config CLI Options</summary>

| Parameter                   | Required | Type             | Description                                                                                                                                                                                                                                      |
| --------------------------- | :------: | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `applicationUrl`           |   false   | string           | Running API provider host endpoint. e.g --applicationUrl=XXXX                                                                                                                                                                                                 |
| `contractName`                  |   false   | string           | Name of the provider contract. Overrides global variable PACT_BROKER_CONTRACT_NAME. e.g --contractName=XXXX         
| `pactBrokerUrl`             |  false   | string           | URL of the Pact Broker to retrieve pacts from. Required if not using pactUrls. e.g --pactBrokerUrl=XXXX                                        
| `contractTags`                      |  false   | array of strings | Array of tags, used to filter pacts from the Broker. e.g --contractTags={"dev", "prod"}                                                                                                                                |
| `pactBrokerToken`           |  false   | string           | Bearer token for Pact Broker authentication. If using Pactflow, you likely need this option. e.g --pactBrokerToken=XXXX                                                                                                                                                   |
| `publishVerificationResult` |  false   | boolean          | Publish verification result to Broker --pactBrokerToken=true                                                                                                                                                                                                           | boolean |
| `contractVersion`           |  false   | string           | Provider version, required to publish verification results to a broker --contractVersion=XXXX  

</details>

## Usage Progmatically
    // my-pact-provider-tests.js
    const { onRunPactTests } = require("@nialloc9/pact-provider");

    onRunPactTests();


    $ PACT_BROKER_CONTRACT_NAME=NameOfContract PACT_BROKER_TOKEN=XXXX PACT_BROKER_URL=https://MY_BROKER.pact.dius.com.au/ mocha -t 10000 my-pact-provider-tests.js

The global variables are required.

### Config Progmatically

A config object can also be passed to the pact tests.

    // my-pact-provider-tests.js
    const { onRunPactTests } = require("@nialloc9/pact-provider");
    
    const config = {};

    onRunPactTests(config);

<details><summary>Config Progmatically Options</summary>

| Parameter                   | Required | Type             | Description                                                                                                                                                                                                                                      |
| --------------------------- | :------: | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `applicationUrl`           |   false   | string           | Running API provider host endpoint.                                                                                                                                                                                                    |
| `contractName`                  |   false   | string           | Name of the provider contract. Overrides global variable PACT_BROKER_CONTRACT_NAME.                 
| `pactBrokerUrl`             |  false   | string           | URL of the Pact Broker to retrieve pacts from. Required if not using pactUrls.                                                                                                                                                                   |
| `contractTags`                      |  false   | array of strings | Array of tags, used to filter pacts from the Broker.                                                                                                                               |
| `pactBrokerToken`           |  false   | string           | Bearer token for Pact Broker authentication. If using Pactflow, you likely need this option.                                                                                                                                                     |
| `publishVerificationResult` |  false   | boolean          | Publish verification result to Broker                                                                                                                                                                                                            | boolean |
| `contractVersion`           |  false   | string           | Provider version, required to publish verification results to a broker         

</details>

---
_Source: https://npm.io/package/@nialloc9/pact-provider · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._