Have opinions about JavaScript? We want to hear them. Take the 2018 JavaScript Ecosystem Survey »

api-console-cli

1.0.8 • Public • Published

API console CLI

The command-line tool for the API Console Web Component.

Warning Warning Warning Warning

Note: This version does not work with API console version 4.

This CLI tool works with version 5 which is still in preview.

Please, use version 0.2.12.

$ npm install -g api-console-cli@0.2.12

Warning Warning Warning Warning

Features

  • build - Build the api console application optimized for production
  • generate-json - Regenerates the JSON file that can be used as a data source in the Console
  • serve - Creates a http server on local machine and serves content of current folder.

Installation

$ npm install -g api-console-cli

Command Overview

api-console [COMMAND] --help

Run api-console --help to get a list of supported commands. Pass it a command name (ex: api-console build --help) to get detailed information about that command and the options it supports.

api-console build [options] -a path/to/api.raml -t "RAML 1.0"

NOTE until API console version 5 is in preview add -n "5.0.0-preview-1" to the command to install preview version.

Builds the API Console for specific API definition. The build is optimized for production, meaning code bundling and minification.

By default this tool support RAML and OAS.

Run api-console build --help for the full list of available options & optimizations.

Detailed description of all options you can find here: api-console build doc

api-console generate-json <RAML PATH> [options]

Creates a JSON file from the RAML spec that can be used as a data source for the API Console.

One of the optimization options it to create a JSON file instead of parsing YAML in the browser. This command allows you to create / regenerate this JSON file instead of rebuilding the whole console.

Run api-console generate-json --help for the full list of available options & optimizations.

Detailed description of all options you can find here: api-console generate-json doc

api-console serve [options] [path]

Runs a local web server serving a content of the current directory or selected path.

Detailed description of all options you can find here: api-console serve doc

Contribution

Your feedback is welcome. If you need support for a method, command options other than described here please, file a feature request. If you find a bug, please, file a bug report with details so we can fix it.

install

npm i api-console-cli

Downloadsweekly downloads

219

version

1.0.8

license

Apache-2.0

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
  • avatar
Report a vulnerability