@coorpacademy/baucis-swagger
Generate customizable swagger definitions for your Baucis REST API.
Last updated 6 days ago by godu .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @coorpacademy/baucis-swagger 
SYNC missed versions from official npm registry.

baucis-swagger

Npm version Build Status

:warning: This is a fork from the Coorpacademy Tech team :warning:

This is so far intended for intern use


This module generates customizable swagger definitions for your Baucis API. Use this module in conjunction with Baucis.

npm install --save @coorpacademy/baucis @coorpacademy/baucis-swagger

It is very easy to use. Include the package after baucis is included, and before your API is built.

const express = require('express');
const baucis = require('@coorpacademy/baucis')(mongoose, express);
const swagger = require('@coorpacademy/baucis-swagger');

baucis.addPlugin(swagger)
const app = express();

// ... Set up a mongoose schema ...

baucis.rest('vegetable');
app.use('/api', baucis());

Then, access e.g. GET http://localhost:3333/api/documentation. See the Baucis repo for more information about building REST APIs with Baucis.

If you want to modify the swagger definition, generate the definition first. (This will happen automatically otherwise.)

controller.generateSwagger();
controller.swagger.xyz = '123';

If you wish to disable the Invalid type warning, you can load the plugin with the following options:

baucis.addPlugin(swagger.withOptions({noWarning: true}));

Current Tags

  • 1.0.0                                ...           latest (6 days ago)

12 Versions

  • 1.0.0                                ...           6 days ago
  • 0.3.1                                ...           4 months ago
  • 0.3.0                                ...           9 months ago
  • 0.2.6                                ...           a year ago
  • 0.2.5                                ...           a year ago
  • 0.2.4                                ...           a year ago
  • 0.2.3                                ...           a year ago
  • 0.2.2                                ...           a year ago
  • 0.2.1                                ...           a year ago
  • 0.2.0                                ...           a year ago
  • 0.2.0-alpha.0                                ...           a year ago
  • 0.1.1                                ...           a year ago
Downloads
Today 0
This Week 0
This Month 12
Last Day 0
Last Week 12
Last Month 0
Dependencies (1)
Dev Dependencies (11)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |