aqovia-openapi-generator-cli
v1.3.0
Published
A npm package wrapper for OpenAPI Generator (https://github.com/OpenAPITools/openapi-generator), generates which API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)
Downloads
9
Maintainers
Readme
@aqovia/openapi-generator-cli
*** This is a fork of @openapitools/openapi-generator-cli (v4.3.0) - with the addition of a C# Azure Functions server generator ***
OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (both 2.0 and 3.0 are supported). Please see OpenAPITools/openapi-generator
Thanks openapitools.org for this awesome CLI!
Installation
There are several ways to install the package.
Global Mode
In global mode (ie, with -g or --global appended to the command), it installs the package as a global package. This
means that you'll get the openapi-generator
command available on your command line interface (CLI) as well.
# install the latest version of "@aqovia/openapi-generator-cli"
npm install @aqovia/openapi-generator-cli -g
After the installation has finished you can type for example:
# this shall print the correct version number
openapi-generator version
Package Mode
It is recommended to install the package as development dependency, because normally you only need this dependency during the development process. To do that you can type the following:
# install the latest version of "@aqovia/openapi-generator-cli"
npm install @openapitools/openapi-generator-cli -D
After the installation has finished you can add a script like this:
{
"name": "my-cool-package",
"version": "0.0.0",
"scripts": {
"my-awesome-script-name": "openapi-generator generate -i docs/openapi.yaml -g csharp-functions-server -o generated-sources/openapi --additional-properties packageName=MyCoolApi",
}
}
Further Documentation
Please refer to the official openapi-generator docs for more information about the possible arguments and a detailed usage manual of the command line interface.