Unleash awesomeness. Private packages, team management tools, and powerful integrations. Get started with npm Orgs »

swagger-inline

1.0.2 • Public • Published

swagger-inline

Node module for extracting swagger endpoints from inline comments.

CircleCI

Too complicated? Try the oas command line tool, which automates all of this! https://github.com/readmeio/oas

Install

npm install --save-dev swagger-inline

Build

npm run build # single build 
npm start # build + watch 

Test

npm test # single run 
npm run test-watch # test + watch 

Usage

Javascript

swaggerInline([inputGlobs...], options) => Promise => json | yaml

const swaggerInline = require('swagger-inline');
 
swaggerInline(['src/**/*.js', 'test/**/*.js'], {
    base: 'swaggerBase.json',
}).then((generatedSwagger) => {
    /* ... */
});
 

CLI

swagger-inline <inputGlobs ...> [--base] [--format] [--out]

swagger-inline 'src/**/*.js' --base 'swaggerBase.json' # outputs built swagger.json 

Options:

  • inputGlobs: Files/globs to search for swagger comments.
  • base: Base swagger to extend. (default: auto-detect)
  • out: Name of file to output the generated swagger file (default: results returned, no file saved).
  • format: Output filetype - .json or .yaml (default: .json)
  • logger: Function called for logging.
  • metadata: Add additional annotations to the Swagger file, prefixed with "x-si"
  • ignore: globs of files to ignore (by default, ['node_modules/**/*', ...etc],
  • scope: matches the scope field defined in each api (for example, --scope public... if not provided, all APIs' doc will be generated )

Example:

1) Create a project

swaggerBase.yaml

swagger: "2.0"
host: "petstore.swagger.io"
basePath: "/api"
schemes: ['http']

api.js

 
/*
 * @api [get] /pets
 * description: "Returns all pets from the system that the user has access to"
 * responses:
 *   "200":
 *     description: "A list of pets."
 *     schema:
 *       type: "String"
 */
 
api.route('/pets', function() {
    /* Pet code 😺 */
});

2) Run Command

swagger-inline './*.js' --base './swaggerBase.yaml'

Output:

swagger.yaml

swagger: '2.0'
host: petstore.swagger.io
basePath: /api
schemes:
  - http
paths:
  /pets:
    get:
      description: Returns all pets from the system that the user has access to
      responses:
        '200':
          description: A list of pets.
          schema:
            type: String

install

npm i swagger-inline

Downloadsweekly downloads

3,383

version

1.0.2

license

ISC

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
Report a vulnerability