/swaggymnia

Generate Swagger 🌀 documentation for your existing API in Insomnia

Primary LanguageGoMIT LicenseMIT

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