Home
Softono
swagger-autogen

swagger-autogen

Open source MIT JavaScript
503
Stars
71
Forks
59
Issues
4
Watchers
2 years
Last Commit

About swagger-autogen

This module performs automatic construction of Swagger documentation. It can identify the endpoints and automatically capture methods such as get, post, put, and so on. It also identifies paths, routes, middlewares, response status codes and parameters. At the end, it generates the .json file containing the Swagger format specification.

Platforms

Web Self-hosted

Languages

JavaScript

swagger-autogen

Overview

This module performs automatic construction of Swagger documentation. It can identify the endpoints and automatically capture methods such as get, post, put, and so on. It also identifies paths, routes, middlewares, response status codes, parameters in the path, header, query and body. It is possible to add information such as endpoint description, parameter description, schemas, security, among others using comments in code. At the end, it generates the .json file containing the Swagger format specification.

NPM Version NPM Downloads

Contents

Installation

This is a Node.js module available through the npm.

$ npm install --save-dev swagger-autogen

If you're using CommonJS:

const swaggerAutogen = require('swagger-autogen')();

Or if you're using ES modules:

import swaggerAutogen from 'swagger-autogen';

Documentation

Please refer to the documentation website on https://swagger-autogen.github.io.

Changelog

Check the GitHub Releases page.

Issues

Due to the number of open issues and the lack of time to respond with quality, I've disabled the opening of issues for now. I'm still keeping my eyes on the project and I intend to prioritize the issues already open. Once I have closed a satisfactory number of issues, I will open it again. Thank you for understanding.

License

MIT License