Skip to content

dac09/grunt-apiary-blueprint

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

grunt-apiary-blueprint

A grunt setup for dealing with apiary blueprints. Makes the workflow much easier, by concatonating multiple blueprints in the source folder to a single file - dist/apiary.apib and also publishing through the apiaryio gem.

Note: Publishing from command line overwrites any changes made online,

Instructions

  1. Clone the repo, then install dependencies
cd grunt-apiary-blueprint/
npm install
  1. As part of the install process you will be asked your password to install the apiaryio gem. You can also run this manually using sudo gem install apiaryio if you wish.

  2. Copy config.example.js to config.js and set the name to match your API blueprint name and key the apiary api key obtained from https://login.apiary.io/tokens

  3. Start grunt in bash grunt

  4. Save your blueprints inside /source as \*.apib files

  5. Repeat Step 5

Publishing specifics

You can configuring different environements to deploy to, for example if you had a shared and a personal blueprint.

Add a new grunt env, and specify the new apiary key (through config.js, or directly). Publish to this new environment from the cli using grunt publish --env=shared (where shared is the name of the environment in your grunt file)

About

Generate your full API blueprint APIB by concatenation from smaller sub-sections using Grunt.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published