Conjure OpenAPI

CLI to generate OpenAPI yaml specifications from Conjure API definitions; it implements the contract described here.

Usage

Usage: conjure-openapi generate <input> <output>

Generate OpenAPI yaml for a Conjure API
    <input>      Path to the input IR file
    <output>     Output directory for generated source

Conjure Generator

Run conjure-openapi through gradle-conjure using the conjureGenerators configuration and specifying the jar we publish to Maven Central:

dependencies {
    conjureGenerators 'com.theoremlp.conjure.openapi:conjure-openapi:<version>'
}

Contributing

To contribute to conjure-openapi:

• Install Java 17 - brew tap homebrew/cask-versions && brew install --cask homebrew/cask-versions/zulu17
• Setup JAVA_HOME - export JAVA_HOME=$(/usr/libexec/java_home -v 17)
• Install Intellij via the Jetbrains Toolbox
• Open the project using Intellij

License

This project is made available under the Apache 2.0 License.