国 际
用于将 OpenAPI(原为 Swagger) 定义转换为 TypeScript 的命令行工具 .
安装
利用国家预防机制:
npm i -D @harnessio/oats-cli
使用 Yarn :
yarn add -D @harnessio/oats-cli
您可以使用 npx (与 npm) (中文(简体) ).
举个例子 npx oats import --config oats.config.ts。 。 。 .
使用量
Usage: oats <cmd> [args]
Commands:
oats import Import OpenAPI specification and output TypeScript code
Options:
--version Show version number [boolean]
--help Show help [boolean]
可用命令
导入
oats import
Import OpenAPI specification and output TypeScript code
Options:
--version Show version number [boolean]
--help Show help [boolean]
--file Path to OpenAPI spec file. Can be either a JSON or YAML fil
e. [string]
--url URL to remote OpenAPI spec file. [string]
-o, --output Location for the output. [string]
-c, --config Location for the config file.
[string] [default: "oats.config.ts"]
--clean Remove the output directory before generating service.
[boolean] [default: false]
--service Pick the services to generate from a config file. All the s
ervices will generated by default. [array] [default: []]
--genOnlyUsed By default, all types defined in spec are generated. Pass
this flag to, only generate types, which are referenced in
paths.
[boolean] [default: false]
--verbose Shows verbose output [boolean]
配置
配置也可以使用配置文件向cli提供. 默认情况下, cli
将寻找 oats.config.ts 当前目录中的文件。 这可以改变
使用 --config 旗帜。 建议使用 TypeScript 文件进行配置 .
// oats.config.ts
import { defineConfig } from '@harnessio/oats-cli/config';
export default defineConfig({
/**
* The plugins defined here will be used for all the services.
* You can also override the plugins at individual service level.
*/
plugins: [],
/**
* Config for the services to generated.
* Its a map of string and config
*/
services: {
// Name for the service.
// You can use this name to pick a service while using the --service flag
myservice: {
/**
* Path where the output should be written to.
* This is a required field.
*/
output: './path/to/output/folder',
/**
* Path from where the OpenAPI spec is to be read.
* Either path or url must be defined.
*/
file: string,
/**
* URL from where the OpenAPI spec is to be read.
* Either path or url must be defined.
*/
url: string,
/**
* By default, all types defined in spec are generated.
* Pass this flag, to only generate types, which are referenced in paths.
*/
genOnlyUsed: boolean,
/**
* A function, which can be used to pre-process the imported spec.
*
* The function will receive the spec as an argument and it needs to
* return the spec after the processing.
*/
transformer: (spec) => spec;
/**
* Plugins to be overriden for this particular service.
* The plugins will be replaced and not merged.
*/
plugins: Plugin[];
},
},
});
许可证
麻省理工学院.