Skip to content

jimschubert/intellij-openapi-generator

Repository files navigation

OpenAPI Generator plugin for IntelliJ IDEs

Assemble Plugin

The OpenAPI Generator plugin allows you to generate client, server, or documentation code from your OpenAPI specifications within your IDE.

This plugin allows for a sort of spec driven development.

While designing your API, you can generate one or more clients from within the IDE to evaluate your changes.

Also install intellij-swagger for a seamless Swagger/OpenAPI editor experience.

Building

./gradlew clean buildPlugin

Running in IntelliJ

First, you'll need to setup a development environment.

Then:

./gradlew runIde

NOTE: When running locally, if changes don't appear in the sandbox instance you may have forgotten to update the plugin version in gradle.properties.

Usage

Open a Specification YAML or JSON file in IntelliJ. Supported specifications are: OpenAPI 2.0/OpenAPI 3.0. With the document active, navigate to Code -> OpenAPI -> Generate from Document.

Choose your desired generator and fill out options. Then, choose an output directory and generate.

License

This project is licensed under the Apache 2.0 license. See ./LICENSE for more details.

Swagger® is a registered trademark of SmartBear Software, Inc.

This project is not maintained by, or associated with, SmartBear Software, Inc. This project is not maintained by, or associated with, OpenAPI Initiative (OAI) in anyway.