Name | oaspy JSON |
Version |
2024.2.13
JSON |
| download |
home_page | |
Summary | oaspy is a quick-and-dirty tool to generate an OpenApi 3.x specification from an insomnia V4 collections. |
upload_time | 2024-02-13 04:48:19 |
maintainer | |
docs_url | None |
author | |
requires_python | >=3.9,<3.12 |
license | |
keywords |
oaspy
insomnia
openapi
converter
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# oaspy
[![Python: 3.10](https://img.shields.io/badge/python-3.10-blue?logo=python)](https://docs.python.org/3.10/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://badge.fury.io/py/oaspy.svg)](https://pypi.org/project/oaspy/)
---
**oaspy** is a quick-and-dirty tool to generate an [OpenApi 3.x](https://www.openapis.org) specification from an [insomnia V4](https://insomnia.rest/products/insomnia) collections.
## Getting Started
For more, see the [documentation](./docs/README.md).
### Installation
**oaspy** is available on [PyPI](https://pypi.org/project/oaspy/):
```shell
pip install oaspy
```
## Usage
To run **oaspy**, try any of the following:
```sh
oaspy --help
```
## Commands
### **gen:** :new: (in progress)
Generate an OpenApi 3.x file from an Insomnia collection v4.
```sh
oaspy gen --help
```
with the default options.
```sh
oaspy gen --file Insomnia_file_v4.json
```
defining the version of openapi to generate.
```sh
oaspy gen --file Insomnia_file_v4.json --schema v30
```
> argument `v30` refers to openapi version 3.0.x
defining the version of openapi to generate and the output file name.
```sh
oaspy gen --file Insomnia_file_v4.json --output my_oa3_export.json
```
a complete version of the above.
```sh
oaspy gen --file Insomnia_file_v4.json --schema v30 --output my_oa3_export.json
```
### **check:** :new:
Validates the structure of an OpenApi file.
```sh
oaspy check --help
```
```sh
oaspy check --file my_oa3_export.json
```
### **info:** :new:
Shows information from an Insomnia v4 file.
```sh
oaspy info --help
```
```sh
oaspy info --file Insomnia_file_v4.json
```
### Configuration
**oaspy** can be configured through a `pyproject.toml` if it is used as a dev dependency in your project.
If left unspecified, the default configuration is equivalent to:
```toml
[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 = "apiteam@awesome.io"
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.](https://opensource.org/license/mit/) license.
The full text of this license can be found in the [LICENSE.](./LICENSE) file.
## How to Contribute
For any questions, comments, suggestions or contributions, go to the [issues.](https://gitlab.com/HomeInside/oaspy/-/issues) section.
Before opening a new issue, check the existing ones to find a solution (possibly already existing) to the problem you are facing.
Raw data
{
"_id": null,
"home_page": "",
"name": "oaspy",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<3.12",
"maintainer_email": "",
"keywords": "oaspy,insomnia,openapi,converter",
"author": "",
"author_email": "Jorge Brunal <diniremix@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/d2/9b/eafc307fabcdf7e73d57138b220ef97ebbbb227c77c1c268af7c243016ce/oaspy-2024.2.13.tar.gz",
"platform": null,
"description": "# oaspy\n\n[![Python: 3.10](https://img.shields.io/badge/python-3.10-blue?logo=python)](https://docs.python.org/3.10/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![PyPI version](https://badge.fury.io/py/oaspy.svg)](https://pypi.org/project/oaspy/)\n---\n\n**oaspy** is a quick-and-dirty tool to generate an [OpenApi 3.x](https://www.openapis.org) specification from an [insomnia V4](https://insomnia.rest/products/insomnia) collections. \n\n\n## Getting Started\n\nFor more, see the [documentation](./docs/README.md).\n\n### Installation\n\n**oaspy** is available on [PyPI](https://pypi.org/project/oaspy/):\n\n```shell\npip install oaspy\n```\n\n## Usage\n\nTo run **oaspy**, try any of the following:\n\n```sh\noaspy --help\n```\n\n\n## Commands\n\n### **gen:** :new: (in progress)\n\nGenerate an OpenApi 3.x file from an Insomnia collection v4.\n\n```sh\noaspy gen --help\n```\n\nwith the default options.\n\n```sh\noaspy gen --file Insomnia_file_v4.json\n```\n\ndefining the version of openapi to generate.\n\n```sh\noaspy gen --file Insomnia_file_v4.json --schema v30\n```\n> argument `v30` refers to openapi version 3.0.x\n\ndefining the version of openapi to generate and the output file name.\n\n```sh\noaspy gen --file Insomnia_file_v4.json --output my_oa3_export.json\n```\n\na complete version of the above.\n\n```sh\noaspy gen --file Insomnia_file_v4.json --schema v30 --output my_oa3_export.json\n```\n\n\n### **check:** :new:\n\nValidates the structure of an OpenApi file.\n\n```sh\noaspy check --help\n```\n\n```sh\noaspy check --file my_oa3_export.json\n```\n\n### **info:** :new:\n\nShows information from an Insomnia v4 file.\n\n```sh\noaspy info --help\n```\n\n```sh\noaspy info --file Insomnia_file_v4.json\n```\n\n\n### Configuration\n\n**oaspy** can be configured through a `pyproject.toml` if it is used as a dev dependency in your project.\n\nIf left unspecified, the default configuration is equivalent to:\n\n```toml\n[tool.oaspy]\ntitle = \"awesome api - OpenAPI 3.0\"\ndescription = \"my awesome api\"\nterms-of-service = \"http://awesome.io/terms\"\ncontact-url = \"http://awesome.io\"\ncontact-email = \"apiteam@awesome.io\"\nlicense-name = \"MIT\"\nlicense-url = \"https://opensource.org/license/mit/\"\nversion = \"1.0.0\"\n```\n\n\n## License\n\nThis project is licensed under the terms of the [MIT.](https://opensource.org/license/mit/) license.\n\nThe full text of this license can be found in the [LICENSE.](./LICENSE) file.\n\n\n## How to Contribute\n\nFor any questions, comments, suggestions or contributions, go to the [issues.](https://gitlab.com/HomeInside/oaspy/-/issues) section.\nBefore opening a new issue, check the existing ones to find a solution (possibly already existing) to the problem you are facing.\n\n",
"bugtrack_url": null,
"license": "",
"summary": "oaspy is a quick-and-dirty tool to generate an OpenApi 3.x specification from an insomnia V4 collections.",
"version": "2024.2.13",
"project_urls": {
"Changelog": "https://gitlab.com/HomeInside/oaspy/-/blob/master/CHANGELOG.md",
"Documentation": "https://gitlab.com/HomeInside/oaspy",
"Homepage": "https://gitlab.com/HomeInside/oaspy",
"Source": "https://gitlab.com/HomeInside/oaspy"
},
"split_keywords": [
"oaspy",
"insomnia",
"openapi",
"converter"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "561f30f621950236f7a638e3a66500fbd824fad09b390bb6613e178f05daa71a",
"md5": "cb6aa8a52b1e5cfe08a065bb1a1be108",
"sha256": "35bc80e84da957c5e7e8198966b952c689da9cbbe59797023ea4d2a93506d428"
},
"downloads": -1,
"filename": "oaspy-2024.2.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cb6aa8a52b1e5cfe08a065bb1a1be108",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<3.12",
"size": 20623,
"upload_time": "2024-02-13T04:48:17",
"upload_time_iso_8601": "2024-02-13T04:48:17.998699Z",
"url": "https://files.pythonhosted.org/packages/56/1f/30f621950236f7a638e3a66500fbd824fad09b390bb6613e178f05daa71a/oaspy-2024.2.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d29beafc307fabcdf7e73d57138b220ef97ebbbb227c77c1c268af7c243016ce",
"md5": "f326a74329ea2341de5c817aa3cea095",
"sha256": "4cf6db3e224774d1c2f2d5914a064a667010364c35bc7cc199b123915282c3b2"
},
"downloads": -1,
"filename": "oaspy-2024.2.13.tar.gz",
"has_sig": false,
"md5_digest": "f326a74329ea2341de5c817aa3cea095",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<3.12",
"size": 21405,
"upload_time": "2024-02-13T04:48:19",
"upload_time_iso_8601": "2024-02-13T04:48:19.840752Z",
"url": "https://files.pythonhosted.org/packages/d2/9b/eafc307fabcdf7e73d57138b220ef97ebbbb227c77c1c268af7c243016ce/oaspy-2024.2.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-13 04:48:19",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "HomeInside",
"gitlab_project": "oaspy",
"lcname": "oaspy"
}