/gradle-swagger-plugin

Gradle plugin for generating OpenAPI specification using Swagger

Primary LanguageGroovyMIT LicenseMIT

Overview

Build Status

This Gradle plugin is created to generate OpenAPI documentation from a JAX-RS based project using Swagger.

Usage

Applying the plugin to your project the generation will run Swagger to generate OpenAPI documentation after classes are compiled. Applying this plugin will also imply applying the Java plugin. A minimal configuration is as follows.

buildscript {
    dependencies {
        classpath (group: 'dk.bankdata.gradle.swagger', name: 'gradle-swagger-plugin', version: '2.0.0')
    }
}

apply plugin: 'dk.bankdata.swagger'

swagger {
    resourcePackages = ['dk.bankdata.service.example']
}

Acknowledgements

The Gradle Swagger Plugin is inspired by the Swagger Maven Plugin and also the Swagger Gradle Plugin. However this plugin was created with the specific purpose of using as much of the core Swagger modules as possible.