Search Gradle plugins
Plugin | Latest Version |
---|---|
com.x3t.gradle.plugins.openapi.openapi_diffOpenAPI Diff Plugin allows the comparison of API Specification files in OpenAPI Spec (v2, v3) format. |
1.1.0
(15 June 2025) |
com.guidedbyte.openapi-modelgenA comprehensive Gradle plugin for generating Java DTOs from multiple OpenAPI specifications with enhanced features: ## Requirements • Java 17+ • Gradle 8.0+ • OpenAPI Generator 7.14.0+ (automatically managed) ## Features • Multi-spec support with individual task generation • Lombok annotation integration (@Data, @Builder, @SuperBuilder, etc.) • Custom Mustache template support with precedence resolution • Template variable expansion (nested variables like {{currentYear}} in {{copyright}}) • Incremental build support for optimal performance • Configuration validation with detailed error reporting • Parallel template processing for large template sets • Content-based template change detection using SHA-256 hashing ## Usage Examples ### Basic Configuration ```groovy plugins { id 'com.guidedbyte.openapi-modelgen' version '1.0.0' } openapiModelgen { defaults { outputDir "build/generated-sources/openapi" modelNameSuffix "Dto" generateModelTests false validateSpec true } specs { pets { inputSpec "src/main/resources/openapi-spec/pets.yaml" modelPackage "com.example.model.pets" } orders { inputSpec "src/main/resources/openapi-spec/orders.yaml" modelPackage "com.example.model.orders" } } } ``` ### Advanced Configuration ```groovy openapiModelgen { defaults { outputDir "build/generated-sources/openapi" templateDir "src/main/resources/openapi-templates" configOptions([ dateLibrary: "java8", serializationLibrary: "jackson", useBeanValidation: "true", hideGenerationTimestamp: "true" ]) templateVariables([ copyright: "Copyright © {{currentYear}} {{companyName}}", currentYear: "2025", companyName: "My Company Inc." ]) globalProperties([ skipFormModel: "false", generateAliasAsModel: "true" ]) } specs { pets { inputSpec "specs/pets-v1.yaml" modelPackage "com.example.pets.v1.model" configOptions([ additionalModelTypeAnnotations: "@lombok.Data;@lombok.experimental.SuperBuilder" ]) } } } ``` Command Line Options: All configuration options can be overridden via command line: • --model-package=com.example.model • --output-dir=build/custom-output • --template-dir=custom-templates • --model-name-suffix=Entity • --validate-spec • --generate-model-tests • --generate-api-docs Task Generation: • generateOpenApiDtosForPets - Generate DTOs for pets specification • generateOpenApiDtosForOrders - Generate DTOs for orders specification • generateOpenApiDtosAll - Generate DTOs for all specifications Dependencies: The plugin automatically detects and works with any OpenAPI Generator version provided by your configuration management (corporate plugins, etc.). If no version is found, it falls back to the tested default version 7.14.0. The plugin also automatically adds required dependencies including Lombok, Jackson, Spring Boot validation, and JSR-305 annotations. Template Customization: Place custom .mustache templates in your template directory to override plugin defaults. Template resolution follows precedence: user templates > plugin templates > OpenAPI generator defaults. For detailed documentation visit: https://github.com/ryansmith4/openapi-modelgen |
2.1.0
(17 September 2025) |
org.openapi.generatorOpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3) |
7.15.0
(01 September 2025) |
io.github.mmalygin.openapi-generatorThis plugin allows you to generate client and server SDKs for different languages, documentation and new generators from OpenAPI 2.0 and 3.x specifications. It does mostly the same things as openapi generator plugin but has a set of additional parameters: 1. Java client retrofit2 generator: add "interfaceOnly" additional property. If it's true, only API interfaces are generated. 2. Java client retrofit2 generator: allow to select serialization library when interfaceOnly = true. It's possible to use jackson instead of gson. 3. Possibility to configure useOneOfInterfaces via additional properties. Generation oneOf interfaces for Java Spring generator. |
6.2.0
(02 October 2022) |
io.github.klahap.coamThe OpenAPI Spec Merger Checker (coam) is a Gradle plugin that verifies whether all paths of one OpenAPI specification file are fully included, through $ref, in another OpenAPI specification file. |
1.0.0
(09 August 2024) |
io.openapiprocessor.openapi-processorplugin to run openapi-processor-*, e.g. openapi-processor-spring (requires gradle 5.5+) |
2023.2
(19 December 2023) |
com.kroegerama.openapi-kgen.gradle-pluginGenerate modern API Clients in Kotlin from OpenAPI specifications. Supports OpenAPI >= 3.0.0. |
1.0.0-beta06
(16 May 2025) |
io.cloudflight.autoconfigure.springdoc-openapi-configureConfigure SpringDoc OpenApi Generation |
1.2.0
(25 April 2025) |
com.github.hauner.openapi-processorplugin to run openapi-processor-*, e.g. openapi-processor-spring (requires gradle 5.2+) |
1.0.0.M8.DEPRECATED
(14 November 2020) |
com.github.hauner.openapi-generatrplugin to run openapi-generatr-x generators, e.g. openapi-generatr-spring |
1.0.0.M5.DEPRECATED
(15 June 2020) |