Skip to content

Transforms OpenAPI Schemas to other formats like MarkDown and PlantUML

License

Notifications You must be signed in to change notification settings

aebaugh/openapi-transformer

 
 

Repository files navigation

OpenAPI transformer

Coverage Status

Build Status

This tool creates a PlantUML Class Diagram from a OpenApi 3 Yaml specification

Requirements

  • OpenAPI 3.0.2
  • OpenAPI specification should be in YAML
  • NodeJS
  • All yaml files should be in 1 directory

Usage

Always run the script from the directory in which the yaml file are.

Usage: index [options] <inputfile>

Options:
  -V, --version                    Output the version number
  -p, --plantuml <plantuml file>   The plantuml file
  -m, --markdown <output file>     The output file for markdown
  -v, --verbose                    Show verbose debug output
  -h, --help                       Output usage information

Example

Generates to plantuml

openapi-transformer vehicle.yaml --plantuml vehicle.plantuml

Generates to plantuml with verbose debug info :)

openapi-transformer vehicle.yaml --verbose --plantuml vehicle.plantuml

Generates to plantuml file and markdown file

openapi-transformer vehicle.yaml --plantuml ./example.plantuml --markdown ./example.md

Example output plantuml

No details

Example no details

Details

Example with details

About

Transforms OpenAPI Schemas to other formats like MarkDown and PlantUML

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages

  • JavaScript 100.0%