oaspy 2023.8.30

oaspy is a quick-and-dirty tool to generate an OpenApi 3.x specification from an insomnia V4 collections.

oaspy

oaspy is a quick-and-dirty tool to generate an OpenApi 3.x specification from an insomnia V4 collections.

Getting Started

For more, see the documentation.

Installation

oaspy is available on PyPI:

pip install oaspy

Usage

To run oaspy, try any of the following:

oaspy --help

with the default options.

oaspy --file Insomnia_file_v4.json

defining the version of openapi to generate.

oaspy --file Insomnia_file_v4.json --schema v30

parameter v30 refers to openapi version 3.0.x

defining the version of openapi to generate and the output file name.

oaspy --file Insomnia_file_v4.json --output my_oa3_export.json

a complete version of the above.

oaspy --file Insomnia_file_v4.json --schema v30 --output my_oa3_export.json

Configuration

oaspy can be configured through a pyproject.toml.

If left unspecified, the default configuration is equivalent to:

[tool.oaspy]
title = "awesome api - OpenAPI 3.0"
description = "my awesome api"
terms-of-service = "http://awesome.io/terms"
contact-url = "http://awesome.io"
contact-email = "[e-mail]"
license-name = "MIT"
license-url = "https://opensource.org/license/mit/"
version = "1.0.0"

License

This project is licensed under the terms of the MIT. license.

The full text of this license can be found in the LICENSE. file.

How to Contribute

For any questions, comments, suggestions or contributions, go to the issues. section. Before opening a new issue, check the existing ones to find a solution (possibly already existing) to the problem you are facing.