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: about 1 month 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 (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-04-11T12:01:53.000Z (7 months ago)
• Last Synced: 2024-04-11T13:27:07.801Z (7 months ago)
• Topics: openapi, openapi-generator, openapi-specification, quarkus-extension, rest, rest-client
• Language: Java
• Homepage:
• Size: 2.24 MB
• Stars: 100
• Watchers: 8
• Forks: 62
• Open Issues: 40
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Quarkus - OpenAPI Generator

[![All Contributors](https://img.shields.io/badge/all_contributors-39-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)

> **⚠️** This is the instructions for the latest SNAPSHOT version (main branch). Please, see the [latest **released** documentation](https://docs.quarkiverse.io/quarkus-openapi-generator/dev/index.html) if you are looking for instructions.

> **⚠️** 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).

> **⚠️** 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.

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 donation to help them maintain the

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

This repository holds two Quarkus extensions. The one located on 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.

**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).

> 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
💻

    

  

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