This project provides a server that can generate responses based on pact files. It is a single executable binary. It implements the V2 Pact specification.
The stub server works by taking all the interactions (requests and responses) from a number of pact files. For each interaction, it will compare any incoming request against those defined in the pact files. If there is a match (based on method, path and query parameters), it will return the response from the pact file.
The pact stub server is bundled as a single binary executable pact-stub-server. Running this with out any options displays the standard help.
```console pact-stub-server v0.0.0 Pact Stub Server
USAGE:
pact-stub-server [OPTIONS] --file
FLAGS: -h, --help Prints help information -v, --version Prints version information
OPTIONS: -d, --dir
```
You can control the log level with the -l, --loglevel <loglevel> option. It defaults to warn, and the options that you can specify are: error, warn, info, debug, trace, none.
You can specify the pacts to verify with the following options. They can be repeated to set multiple sources.
| Option | Type | Description |
|--------|------|-------------|
| -f, --file <file> | File | Loads a pact from the given file |
| -u, --url <url> | URL | Loads a pact from a URL resource |
| -d, --dir <dir> | Directory | Loads all the pacts from the given directory |
The running server can be controlled with the following options:
| Option | Description |
|--------|-------------|
| -p, --port <port> | The port to bind to. If not specified, a random port will be allocated by the operating system. |