Skip to content

Tool for generating a Postman collection from Blueprint API markup or the Apiary API

License

Notifications You must be signed in to change notification settings

pulseshift/apiary2postman

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

apiary2postman

Tool for generating a Postman collection from an API Blueprint, or an API Blueprint hosted on Apiary.

Supports

Prerequisites

Drafter < 2.0 is required if you want to use API Blueprint/Apiary API.

To install on OS X:

brew install --HEAD https://raw.githubusercontent.com/apiaryio/drafter/b3dce8dda5d48b36e963abeffe5b0de7afecac3d/tools/homebrew/drafter.rb

To install from source:

git clone https://github.com/apiaryio/drafter
cd drafter
git checkout b3dce8d # This is the commit for release 0.1.9
git submodule update --init --recursive # Get all the dependencies needed for compile
./configure
make
sudo make install

Drafter is used to convert Blueprint API to JSON. The preferred version is v0.1.9. Drafter v2 changed the JSON output format to be incomptabile with apiary2postman. Feel free to submit a pull request which fixes this.

Installation

pip install apiary2postman

Or, run from your checkout

git clone <repo-url>
cd apiary2postman/apiary2postman
./apiary2postman.py <args>

Usage

apiary2postman json blueprint.json --output postman.json
If you have the API Blueprint, use the blueprint subcommand:
apiary2postman blueprint some.blueprint > postman.dump

It is also possible to pipe everything:

cat some.blueprint | apiary2postman blueprint > postman.dump
To generate a total Postman environment dump from Apiary API, use the api subcommand with your Apiary API name:
apiary2postman api my_api > my_api.dump

If you don't have an API key, go to https://login.apiary.io/tokens. Generate one if needed, and set the environment variable APIARY_API_KEY to that hex string.

APIARY_API_KEY=ffffffffffffffffffffffffffffffff apiary2postman api my_api > my_api.dump

Or to generate only a Postman collection from Apiary API:

apiary2postman --only-collection api my_api > my_api.collection

It's also possible to specify the output file using the --output.

If you have the API Blueprint AST already generated, use the json subcommand:
apiary2postman json some.json > postman.dump

It is also possible to pipe everything:

cat some.json | apiary2postman json > postman.dump
Single Collection

To force all resource groups to be created as Folder within the same Postman collection use --single-collection option.

Contribution

Contributions are greatly appreciated. What is most lacking is tests and would be super-grealy appreciated.

About

Tool for generating a Postman collection from Blueprint API markup or the Apiary API

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%