Search Gradle plugins
| Plugin | Latest Version |
|---|---|
|
Apply this to your settings.gradle to get default versions for all FreeFair Gradle Plugins |
9.8.2
(14 October 2026) |
|
A 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.2.3
(14 October 2026) |
|
Sets project version automatically from git tags using Conventional Commits bump logic (MAJOR/MINOR/PATCH). Pure JGit — no git CLI dependency. |
0.1.4
(13 October 2026) |
|
A Gradle plugin to read oci.versions.toml and provide typed accessors for gradle-oci |
0.4.1
(17 September 2026) |
|
Computes project.version from git tags plus Conventional Commits messages, independent of the java plugin. |
0.1.0
(15 September 2026) |
|
Provide version tasks in root project |
19.16.0
(11 September 2026) |
|
Sets the project version from the state of the git repository it's in. |
0.7.1
(05 September 2026) |
|
A plugin that helps to maintain a semantic versioning of the build artifacts based on the project's git repository. It uses the current branch and the latest tag to enforce naming conventions |
3.0.0
(19 August 2026) |
|
Automatically generate a Gradle version catalog from a BOM |
4.2.2
(16 July 2026) |
|
Propagates version settings to Kotlin JVM and Android modules automatically. |
1.0.1
(23 April 2026) |