1.0.0 • Published 6 years ago

@apib2/postman v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
6 years ago

API Blueprint to Postman

Quick Start

  1. Install the package globally
    npm i -g @apib2/postman

Command Line Options

apib2postman <api-blueprint.apib> [options]

or

node ./bin/apib2postman.js <api-blueprint.apib> [options]
  • -o <output>, --output <output>

    Default stdout

    Specify a file for where the collection will be saved.

  • -e <env-output>, --environment <env-output>

    Default API.postman_environment.json

    Specify a file for where the environment template will be saved.

  • -t <test-template>, --testTemplate <test-template>

    Default templates/postman/actions/js-tests.hbs

    Specify a handlebar template to be used for each action's Postman tests. Variables are listed below which can be used within the template.

Postman Test Template

Some JS tests have been created which get templated and attached to every action. The default tests exist at templates/postman/js-tests.hbs

This template is applied to every action and the variables which get passed to this template are as follows:

NameDescriptionExample
pathNameThe path of the group collection as a standardized name.networkDevices_ for /api/networkDevices/:id
statusCodeThe expected status code for the action200
headersThe expected headers to be returned[ { key: "Accept", value: "application/json" } ]
schemaThe JSON schema for the action's response{ large schema here... }
isPageableReturns true if the response schema has a collection withintrue
sortParamsThe accepted sort parameters parsed from the sort query parameter description[ "name", "category" ]