Skip to content

Latest commit

 

History

History
32 lines (23 loc) · 1.87 KB

README.md

File metadata and controls

32 lines (23 loc) · 1.87 KB

JavaScript Client Generation

Kubling license

This repository contains a list of curated and tested, auto-generated API Clients, using openapi-generator.

It is important to note that ApiClient template was modified to use Kubling httpCli, the object injected in all JavaScript contexts. Therefore, you can't use the built-in generator's template for JavaScript since it will not work.

Node.js based libraries

Most famous JavaScript libraries were meant to be used within a Node.js context. Similar way Kubling engine injects objects in execution contexts, Node.js has core, built-in libraries (called modules) you can simply import, like http and fs.

Since they are not available in our engine, most of those libraries can't be used directly and need some adaptation, like teh result of this template, in which we removed references to the standard superagent in favor of the powerful Kubling's httpCli.

Generate API Client sources

Generated sources are not included since, in most cases, the result is a hundred of source files, which does not make any sense to include as the generation takes usually less than a git clone.

To generate a client, you must have java installed locally. Please have a look at this doc
In case you don't want to use the version added to this repo, please read in that same document how to install the generator locally.

Once everything is configured just run:

java -jar openapi-generator-cli-7.6.0.jar generate -i [path/to/spec] -g javascript -o [path/to/client/dir] -t template/

Example:

java -jar openapi-generator-cli-7.6.0.jar generate -i azure/spec/storage.yaml -g javascript -o azure/generated/storage/ -t template/