apiDoc to Interfaces

Command line tool that generates typescript interfaces from your apiDoc documentation.

Getting Started

Installing

To use this tool install it using npm:

$ npm install apidoc2ts -g

Usage

Get help on how to use the tool:

$ apidoc2ts --help

Generating interfaces from your apiDoc:

$ apidoc2ts --source ./doc/api_data.json --output generated --name interfaces.ts

Options

Required flags:

-s --source - path to the api_data.json file from apiDoc
-o --output - path to the output folder (default ./)
-n --name - name for the file with generated interfaces

Additional flags:

-g --gropuing = (single|url):
- single - create one file with all interfaces in it (not the best idea)
- url - create multiple folders with interfaces corresponding to URL structure
-v --version = (last|all) - which versions should be used
- last - interfaces are generated only for the latest versions
- all - interfaces are generated for all version and older version interfaces has a postfix _vx.x.x
-t --custom-types - list of custom types that should not be replaced with strings
-w --whitelist - list of endpoints names which should be processed, the rest of endpoints will be ignored
-e --parse-examples - if example requests/responses should be parsed if no parameters are specified

Prefixes/postfixes for top-level interfaces names:

--static-prefix - prefix for all interfaces names
--static-postfix - postfix for all interfaces names
--request-prefix - prefix for a request interface name
--request-postfix - postfix for a request interface name
--response-prefix - prefix for a response interface name
--response-postfix - postfix for a response interface name
--error-prefix - prefix for an error interface name
--error-postfix - postfix for an error interface name

Config file

The tool will look for a default config file called apidoc2ts.config.js in a current folder and combine flags from the file with a flags specified in command line. Note that command line flags override config file flags and all flags in config file should be in a camelCase.

Also you can specify a path to the config file which must contain all required flags:

-c --config - path to the config file

Example of the config file:

module.exports = {
    source: "source",
    name: "name.ts",
    output: "output",
    staticPrefix: "I",
    customTypes: ["type1", "type2"]
}

Contributing

We appreciate any contribution to this project whether it is a bug report, feature request or some improvement and have a small guide for that.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

fluix/apidoc2ts