README
postman-pact
A command line tool to convert Pact files to Postman collections.
Contents
Requirements
Requires NodeJS version v7.10.1 or higher.
Installation
npm install -g postman-pact
Installation from the repo
Clone the repo and from the root execute:
npm install
npm link
Note: Don't forget to run npm unlink if needed!
Command line usage
From a url
postman-pact http://pact-broker/provider/a-provider/consumer/a-consumer/latest
From a file
postman-pact pact-file.json
Save to a file
postman-pact http://pact-broker/provider/a-provider/consumer/a-consumer/latest -o postman-collection.json
From a url that requires headers
postman-pact http://pact-broker/provider/a-provider/consumer/a-consumer/latest -H '{"Authorization":"Basic ZFhmbHR5Rk1n..."}'
Postman usage
Import the collection in Postman
Once you have a generated Postman collection, select "import" in Postman. The generated collection format is 2.1.
A collection should appear, starting with the name "Pact".
Create a Postman environment
A url variable is used for all the requests. The next step is to create an Postman environment with a url variable, for example: url: http://my-service.com.
You're good to go - so make the requests!
Run tests
Run all tests
npm test
Run unit tests only
npm run test-unit
Run integration tests only
npm run test-integration
Watch tests
npm install -g nodemon
nodemon tests/unit -x "npm run test-unit"
nodemon tests/integration -x "npm run test-integration"