Skip to content

lscalese/openapi-server-gen

Repository files navigation

Gitter Quality Gate Status Reliability Rating

License: MIT

openapi-server-gen

Important : To make maintenance easier, this package has been merged with openapi-suite ( Link to GitHub repository ). Consider this package deprecated and replaced by openapi-suite (classes have kept the same name)

This is a library to generate server-side REST classes for intersystems IRIS.
openapi-server-gen is piece of a bigger project openapi-suite ( OEX Link - GitHub ).

Installation zpm

zpm "install openapi-server-gen"

optional swagger-ui

zpm "install swagger-ui"

Installation docker

git clone [email protected]:lscalese/openapi-server-gen.git
cd openapi-server-gen
docker-compose up -d

Usage

Generate petstore server-side class from OpenAPI 3 specification

Open an IRIS terminal :

Set applicationName = "petstoresrv" ; this is the package name for the generated classes.  
Set webApplication = "/petstore/api" ; webapplication name to create, leave empty if you don't want create the web apps
Set sc = ##class(dc.openapi.server.ServerAppGenerator).Generate(applicationName, "https://petstore3.swagger.io/api/v3/openapi.json", webApplication)

Explorer generated class in petstoresrv package.

If you install swagger-ui you can open this page http://localhost:52797/swagger-ui/index.html and then explore http://localhost:52796/petstore/api/_spec

More information about this package will be available soon on OpenExchange.

About

IRIS server-side REST class generator from OpenAPI specification

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published