Generates openapi documentation from a mu-resources configuration
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
Dockerfile
README.md
openapi-generator.lisp
packages.lisp
resources-openapi-generator.asd
startup.lisp

README.md

OpenAPI resources generator

Generates OpenAPI spec from mu-cl-resources

Example usage

    # Start a triplestore, unless you already have a triplestore in a docker available
    docker run --name my-database -p 8890:8890 tenforce/virtuoso:1.0.0-virtuoso7.2.4
    
    # Generate the sources
    docker run --link my-database:database \
           -v `pwd`/config/resources:/config \
           -v /tmp/:/config/output \
           semtech/mu-cl-resources-openapi-generator
    
    # Copy from the terminal, or open the generated json file
    cat /tmp/openapi.json

The last line of output contains the generate calls. /tmp/openapi.json will contain the generated api as well. You can paste these contents into the swagger editor to get a preview. Use the JSON import of the File menu.