Quarkus' extension for generation of client SDKs based on OpenAPI specification files.

This extension is based on the Kiota.

Want to contribute? Great! We try to make it easy, and all contributions, even the smaller ones, are more than welcome. This includes bug reports, fixes, documentation, examples... But first, read this page.

If you have a supersonic, subatomic Quarkus project you can use this extension to generate code with Kiota:

<dependency>
  <groupId>io.quarkiverse.kiota</groupId>
  <artifactId>quarkus-kiota</artifactId>
  <version>VERSION</version>
</dependency>

remember to enable the code generation in the quarkus-maven-plugin configuration, if not already present, add <goal>generate-code</goal>:

<plugin>
  <groupId>io.quarkus</groupId>
  <artifactId>quarkus-maven-plugin</artifactId>
  <executions>
    <execution>
      <goals>
        <goal>build</goal>
        <goal>generate-code</goal>
      </goals>
    </execution>
  </executions>
</plugin>

now you can drop any Open API specification in the src/<scope>/openapi folder and configure the extension as usual with Quarkus configuration. We highly encourage you to pin quarkus.kiota.version to a specific version instead of relying on the "latest detection" built-in mechanism for production code.

To fine tune the generation you can define additional properties after the Open API spec file name:

Using the extension, by default, the Json serializer and deserializer will be based on Jackson instead of the official one based on Gson.

If you want to improve the docs, please feel free to contribute editing the docs in Docs. But first, read this page.

Thanks goes to these wonderful people (emoji key):

Andrea Peruffo 💻 🚧

George Gastaldi 💻 🚧

This project follows the all-contributors specification. Contributions of any kind welcome!