For original usage read - original README

npm install saddleback-openapi-typescript-codegen --save-dev 

1. install the package
2. create config files for every microservice that you need (put it in the root project folder for example openapiEvents.config.json)
3. inside the config file you need to specify
   1. output folder (for Events it would be ./src/shared/api/events)
   2. microservice that you're specifying ("Events")
   3. environment that using for fetch ("feature")
   4. if you don't want to generate whole microservices, you can specify filterMethod and filterArray
4. create utility files that used in services
   1. 'baseAxios' should export axios instance that be used for fetch
   2. 'getBaseConfig' and 'serviceError' described here https://github.com/saddlebackdev/church-management/wiki/Services
5. run the command where you should pass your login and pass from saddleback identity server saddlebackApi --config openapiEvents.config.json --login login --password password

1. same as above
2. same as above
3. addition specify the input path to the swagger.json file
4. same as above
5. run the command saddlebackApi --config openapiEvents.config.json

Generated folders should be untouchable. Because every generate action will delete and put generated files into the output folder.

$ saddlebackOpenapi --help Usage: saddlebackOpenapi [options] Options: -V, --version output the version number -i, --input <value> OpenAPI specification, can be a path, url or string content -o, --output <value> Output directory should end with service name workflows | events | notifications | core | journey | giving | smallGroup -c, --config <value> Path to the config file -l, --login <value> Login -p, --password <value> Password -e, --environment <value> Environment dev | stage | stage2 -s, --service <value> Service Service Workflows | Events | Notifications | Core | Journey | Giving | SmallGroup -h, --help display help for command -m, --filterMethod Filter method include(default) | exclude') -f, --filterArray Filter array Examples $ saddlebackOpenApi --input ./spec.json --output ./generated $ saddlebackOpenApi --config ./openapi.config.json $ saddlebackOpenApi -o "./folderPath" -l "Login" -p "Password" -e "dev" -s "core" 

extends original OPTIONS

 input required in the config or cmd arguments output required in the config or cmd arguments additionalModelFileExtension optional additionalServiceFileExtension optional removeLodashPrefixes optional 

• Default: undefined
• Type: string

OpenAPI specification, can be a path, url or string content (required in the config or cmd arguments)

• Default: undefined
• Type: string

Output directory (required in the config or cmd arguments)

• Default: undefined
• Type: string

Login to saddleback identity server

• Default: undefined
• Type: string

Password to saddleback identity server

• Default: undefined
• Type: 'dev' | 'stage' | 'stage2'

Which Environment should be used for swagger.json

• Default: undefined
• Type: 'workflows' | 'event' | 'notifications' | 'core'

Which service should be fetched

• Default: include
• Type: 'include' | 'exclude'

Which method of sort should be applied to the filter array

• Default: undefined
• Type: string[]

Which services should be included or excluded to/from generated list

• Default: true
• Type: boolean

Apply *.models.* extension to model files.

For example (myModel.ts -> myModel.models.ts)

• Default: true
• Type: boolean

Apply *.service.* extension to service files.

For example (myService.ts -> myService.service.ts)

• Default: true
• Type: boolean

Remove special prefixes that are separated by _ at the start of names.

For example (Custom_Prefix_Name -> Name)