https://github.com/quarkiverse/quarkus-openapi-generator

OpenAPI Generator - REST Client Generator
https://github.com/quarkiverse/quarkus-openapi-generator

openapi openapi-generator openapi-specification quarkus-extension rest rest-client

Last synced: 26 days ago
JSON representation

OpenAPI Generator - REST Client Generator

• Host: GitHub
• URL: https://github.com/quarkiverse/quarkus-openapi-generator
• Owner: quarkiverse
• License: apache-2.0
• Created: 2022-02-07T15:20:16.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-05-06T19:10:20.000Z (about 1 month ago)
• Last Synced: 2025-05-06T20:23:54.704Z (about 1 month ago)
• Topics: openapi, openapi-generator, openapi-specification, quarkus-extension, rest, rest-client
• Language: Java
• Homepage:
• Size: 3.17 MB
• Stars: 134
• Watchers: 7
• Forks: 103
• Open Issues: 56
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        





# Quarkus - OpenAPI Generator






[![All Contributors](https://img.shields.io/badge/all_contributors-47-orange.svg?style=flat-square)](#contributors-)

[![Build]()](https://github.com/quarkiverse/quarkus-openapi-generator/actions?query=workflow%3ABuild)

[![Maven Central](https://img.shields.io/maven-central/v/io.quarkiverse.openapi.generator/quarkus-openapi-generator.svg?label=Maven%20Central&style=flat-square)](https://search.maven.org/artifact/io.quarkiverse.openapi.generator/quarkus-openapi-generator)

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square)](https://opensource.org/licenses/Apache-2.0)

Quarkus' extensions for generation of [Rest Clients](https://quarkus.io/guides/rest-client) and server stubs generation based on the [Apicurio Codegen](https://github.com/Apicurio/apicurio-codegen) capabilities based on OpenAPI specification files.

This client-side extension is based on the [OpenAPI Generator Tool](https://openapi-generator.tech/). Please consider a donation to help them maintain the

project: https://opencollective.com/openapi_generator/donate

This repository holds two Quarkus extensions. The one located in the client folder is for REST code generation for client-side only. The extension located in the server folder can be used for server stubs generation.

> [!WARNING]

> This extension, [like Quarkus 3.7](https://quarkus.io/blog/java-17/), requires Java 17. The last version of this extension that supports earlier versions of Java is [2.2.16](https://github.com/quarkiverse/quarkus-openapi-generator/releases/tag/2.2.16).

> [!CAUTION]

> Check versions 1.x.x if you're still using Quarkus 2. But be aware that we no longer support Quarkus 2. That means there are no updates planned for those versions.

**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](CONTRIBUTING.md).

## Getting Started

You can learn more in [Quarkus OpenAPI Generator Documentation](http://docs.quarkiverse.io/quarkus-openapi-generator/dev/index.html).

> [!TIP]

> If you want to improve the docs, please feel free to contribute editing the docs in [Docs](https://github.com/quarkiverse/quarkus-openapi-generator/tree/main/docs/modules/ROOT). But first, read [this page](CONTRIBUTING.md).

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  

    

      
Ricardo Zanini
💻 🚧

      
Helber Belmiro
📖 💻

      
George Gastaldi
💻 🚇

      
Rishi Kumar Ray
🚇

      
Francisco Javier Tirado Sarti
💻

      
Orbifoldt
💻

      
antssilva96
💻

    

    

      
Walter Medvedeo
💻

      
Miguel Angel Chico
💻

      
Martin Weiler
💻

      
Leibniz.Hu
💻

      
Melloware
📖

      
Cristiano Nicolai
💻

      
YassinHajaj
💻

    

    

      
Gwydion Martín
💻

      
Adriano Augusto Tagliaferro
⚠️

      
Christian Berger
💻

      
Bruno Alves
💻

      
Matheus Cruz
🚇 💻 📖

      
Laurent Perez
💻

      
Bas Passon
💻

    

    

      
Michal Somora
💻

      
Waldemar Reusch
💻 📖

      
Patrik Toth
⚠️ 💻

      
Alessandro Chacón
⚠️ 💻

      
ninckblokje
💻 ⚠️

      
DennisGyldendahlJensenSparNord
💻

      
Luan Ramalho
📖

    

    

      
gabriel-farache
💻 ⚠️

      
Martin
💻

      
Matthias Ngeo
📖

      
nmirasch
💻

      
Rupert Bogensperger
💻 ⚠️ 📖

      
boyi01
💻 ⚠️

      
Carles Arnal
🚧

    

    

      
Brice Laurencin
💻

      
Gabriel Malheiro
📖

      
Karl Ferdinand Ebert
💻 📖

      
Michał Kolenda
💻

      
rednalyn
📖

      
Marko Bekhta
💻

      
Andy Barilla
💻 ⚠️ 📖

    

    

      
yuhaibohotmail
💻 ⚠️

      
Juan Piero Santisteban Quiroz
💻 ⚠️

      
Jochen Schalanda
💻

      
Luis Fabrício De Llamas
📖

      
João Guilherme Hagemann
📖

    

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!