@codegena/oapi3ts-cli

CLI Application API for codegeneration from OAS3

This is an experimental library. Now supporting TypeScript data types and model. Also, generating experimental Angular2+ services.

Supporting of other languages and frameworks might be possible in the future.

It's a part of @codegena scope.

See in action: https://codegena-playground.stackblitz.io/ / https://stackblitz.com/edit/codegena-playground.

Using in NodeJS scripts

Install (without optional dependencies):

npm i @codegena/oapi3ts-cli --no-optional

or

yarn add @codegena/oapi3ts-cli --ignore-optional

So you can use @codegena/oapi3ts-cli in NodeJS scripts. For example, lets create update-typings.js script with code:

"use strict";

var cliLib = require('@codegena/oapi3ts-cli');
var cliApp = new cliLib.CliApplication;

cliApp.createTypings();
cliApp.createServices('angular');

Then launch:

node ./update-typings.js --srcPath ./specs/todo-app-spec.json --destPath ./ --separatedFiles true

Class CliApplication will get command line arguments destPath, srcPath and separatedFiles by itself.

CLI arguments

CLI Argument	Description
srcPath	Path of url of JSON file with OpenAPI3 specification
destPath	Path for destination directory
separatedFiles	Whether should converted types been saved in separate files, or in single file

Also, you can set some of options for convertor's configuration config via CLI:

Option	Description
defaultContentType	Default content-type contains no prefixes/suffixes in type names.
implicitTypesRefReplacement	Mode when models that refer to any models via $ref are replacing implicitly even if firsts have names