English | 简体中文

openapi-tool is a tool to generate service file based on openapi.

If you like it, please give me a star. Thanks a lot!

• Compatible with bath OAS2 and OAS3
• Support major HTTP Client(axios and umi-request so far)
• Support generating js or ts file
• Support type system when generate ts file
• Plugin system to add global-level functionality

npm install openapi-tool 

In order to gain the TypeScript typings (for intellisense / autocomplete) while using CommonJS imports with require() use the following approach:

const OpenApiTool = require('openapi-tool').default;

PS: Typing .default is merely used to gain the TypeScript typings. Please remove .default when you launch the project, otherwise it will throw an error.

const OpenApiTool = require('openapi-tool'); const { resolve } = require('path'); const url = 'https://gw.alipayobjects.com/os/antfincdn/M%24jrzTTYJN/oneapi.json'; const outputDir = resolve(__dirname, 'service'); const openApiTool = new OpenApiTool({url}); openApiTool.generateService({ template: 'axios', importText: `const axios = require('axios');`, typescript: true, outputDir, });

Create a new OpenApiTool instance.

Options:

Generate service files, the name of file will be the tag's name.

ServiceGeneratorOptions:

Get OpenApi that transformed from OAS2/OAS3.

openapi-tool have a flexible plugin system which can add global-level functionality.

Use plugins by calling the OpenApiTool.use() global method. This has to be done before you start your app by calling new OpenApiTool():

// calls `MyPlugin.install(OpenApiTool)` OpenApiTool.use(MyPlugin) new OpenApiTool({ //... options })

You can optionally pass in some options:

OpenApiTool.use(MyPlugin, { someOption: true })

A plugin should be a method. The method will be called with the OpenApiTool constructor as the first argument, along with possible options:

const logPlugin = (OpenApiTool, option) => { OpenApiTool.prototype.log = async function() { const openapi = await this.getOpenApi(); console.log(`the length of apis: ${openapi.apis.length}`); console.log('option', option); } }

then you can use it like this:

const openApiTool = new OpenApiTool({ //... options }); openApiTool.log();

MIT