Swaggymnia Save

Generate Swagger 🌀 documentation for your existing API in Insomnia

Project README

CircleCI MIT License Go Report Card

Generate Swagger Documentation from Insomnia REST Client

Download

Below are the available downloads for the latest version of Swaggymnia (1.0.0-beta). Please download the proper package for your operating system and architecture.

Linux:

wget https://s3.amazonaws.com/swaggymnia/1.0.0-beta/linux/swaggymnia

Windows:

wget https://s3.amazonaws.com/swaggymnia/1.0.0-beta/windows/swaggymnia

Mac OS X:

wget https://s3.amazonaws.com/swaggymnia/1.0.0-beta/osx/swaggymnia

FreeBSD:

wget https://s3.amazonaws.com/swaggymnia/1.0.0-beta/freebsd/swaggymnia

OpenBSD:

wget https://s3.amazonaws.com/swaggymnia/1.0.0-beta/openbsd/swaggymnia

How to use it

See usage with:

$ swaggymnia --help

Generate Swagger documentation:

$ swaggymnia generate -insomnia INSOMNIA_EXPORTED_FILE -config CONFIG_FILE -output FORMAT
Option Description
-insomnia Insomnia exported file
-config API Global Configuration file (see Configuration Format)
-output Insomnia output format (json or yaml, default json)

Example

Let's convert the following Insomnia API documentation to Swagger:

Issue the following command:

$ swaggymnia generate -i examples/watchnow.json -c examples/config.json -o json

Configuration Format

{
  "title" : "API Name",
  "version" : "API version",
  "host" : "API URL",
  "basePath" : "Base URL",
  "schemes" : "HTTP protocol",
  "description" : "API description"
}

Tutorials

Maintainers

License

This project is licensed under the MIT License - see the LICENSE file for details

Open Source Agenda is not affiliated with "Swaggymnia" Project. README Source: mlabouardy/swaggymnia
Stars
423
Open Issues
15
Last Commit
2 years ago
License
MIT

Open Source Agenda Badge

Open Source Agenda Rating