openapi cli tool
Project description
openapi-cli-tool
OpenAPI (Swagger 3.x) CLI Tool.
- Supports multi file extension (json|yaml|yml).
- List up defined APIs.
- Display an API specification which is resolved
$ref
. - Bundle multi-file into one.
- OAS interactive scaffold.
Installation
Execute Python installation command on your machine.
Supports Python 2.7, 3.4 <=.
$ python setup.py install
Then openapi-cli-tool
command is installed.
Usage
$ openapi-cli-tool --help
Usage: openapi-cli-tool [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
bundle Bundle multi-file into one.
list List up APIs in a specific file or directory.
resolve Display `$ref` resolved API specification.
scaffold Interactively create a simple OpenAPI Specification.
Bundle
Bundle multi-file specifications into one, regardless of file extension (json|yaml|yml).
$ openapi-cli-tool bundle --help
Usage: openapi-cli-tool bundle [OPTIONS] FILE_PATH
Bundle multi-file into one.
Options:
-f, --file TEXT Load common objects such as info and servers from a
specific file. Default is a file which is the top of list
command result.
-t, --type TEXT Export data type. {json|yaml} [default: json]
--help Show this message and exit.
example:
$ openapi-cli-tool bundle FILE_PAH > ./specification.json
List
List up APIs from specification file/directory regardless of file extension (json|yaml|yml).
$ openapi-cli-tool list [spec-path]
Method Path File
-------- --------- ------------------------------------------
PUT /avatar ./tests/resources/spec/sample.yml
GET /follwers ./tests/resources/spec/folder1/sample2.yaml
POST /follwers ./tests/resources/spec/folder1/sample2.yaml
PUT /follwers ./tests/resources/spec/folder1/sample2.yaml
POST /pets ./tests/resources/spec/sample.yml
GET /posts ./tests/resources/spec/folder1/sample.json
POST /posts ./tests/resources/spec/folder1/sample.json
GET /users ./tests/resources/spec/folder1/sample.json
POST /users ./tests/resources/spec/folder1/sample.json
Resolve
Display an API specification which is resolved multi-file API specification via $ref pointers.
Usage: openapi-cli-tool resolve [OPTIONS] METHOD PATH FILE_PATH
Display `$ref` resolved API specification.
Options:
-t, --type TEXT Export data type. {json|yaml} [default: json]
--help Show this message and exit.
example:
$ openapi-cli-tool resolve post /cats ./tests/resources/spec
Scaffold
Interactively input information of your API.
A simple OpenAPI Specification is generated on your prompt.
$ openapi-cli-tool scaffold
Please enter title [""]: sample
Please enter version [v1.0]:
Please enter license [Apache 2.0]:
Please enter server url [http://example.com]:
Please enter path [/]: /example
Please enter method for /example [get|post|put|delete|head|option|trace]: get
Please enter description for get /example [""]: sample get endpoint
Please enter response code for get /example [200]:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
openapi-cli-tool-0.1a0.tar.gz
(5.8 kB
view hashes)
Built Distributions
Close
Hashes for openapi_cli_tool-0.1a0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1f5b3746265deb856a424cabfb8510f53cd81932d76d42d64de2e34e0bdf7add |
|
MD5 | cf60dea8f08771171df327907d3d0c9a |
|
BLAKE2b-256 | 26275c053dd4669f6c402eaf220af3c87cd8afea8ad56a9715e8c464f0b8701e |
Close
Hashes for openapi_cli_tool-0.1a0-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 21f9d0e7108980babb2e6b74c27b0878df355e80771c21e060086b7569e7407f |
|
MD5 | 8e6904492d7a24cc501d7e6715372361 |
|
BLAKE2b-256 | 9137ef81e98d69d3f2a66683f00bdfb68807f871355c12667460143fa89864ec |