Search Gradle plugins

Asyncwright brings contract-first AsyncAPI validation and model-based generation to Gradle builds and CI. It validates a defined subset of AsyncAPI 3.0.0 YAML and JSON documents, resolves local JSON Pointer references, and produces JSON and text diagnostic reports. A Groovy/Kotlin DSL configures specifications and project rules; validation integrates with the check task so contract errors fail the build. The Java extension API lets teams supply custom validation rules and generators that work with a typed model. Generation runs through explicitly invoked tasks using user-supplied generators. Validation and generation tasks support the Gradle build cache and configuration cache, and run in classloader-isolated Gradle workers without requiring Node.js. Custom extensions must declare their inputs and produce deterministic outputs for correct caching. The supported subset excludes external references, traits, YAML aliases and non-default schema formats. See the project documentation for setup, examples and the full validation scope.

• #asyncapi
• #validation
• #code-generation
• #java

Configures the Gradle Shadow plugin to replace the normal jar task output with the shaded jar without a classifier

• #rewrite
• #refactoring
• #java

Set the output encoding of your javadoc tasks to 'UTF-8'

• #javadoc
• #utf-8

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

• #openapi
• #code-generation
• #lombok
• #dto
• #models
• #java
• #spring

Applies org.springframework.boot and wires the MSP Spring Boot BOM for dependency management. Names the bootJar after the root project and registers copyOtelJavaagent to copy the OpenTelemetry Java agent into build/libs at assemble time. Adds spring-boot-devtools (developmentOnly), micrometer-registry-prometheus (runtimeOnly), msp-spring-boot-application (implementation), and msp-spring-test-starter (testImplementation). Rewrites application.yml at processResources time with build metadata (context name, version, CI environment). When com.stano.docker is also applied, auto-configures the Docker image name, build args, and wires bootWar output as the Docker build context.

• #convention
• #spring-boot
• #java

Docker Compose file generation and lifecycle management. Registers generateDockerCompose (resolves artifact versions into a docker-compose.yml template), dockerComposeUp, and dockerComposeDown tasks. Configure the template path, output file, and token replacements via the dockerCompose DSL. Template tokens use {{group:name}} syntax and are resolved from the docker configuration or explicit templateToken(key, value) entries.

• #convention
• #docker
• #docker-compose

Docker image build, tag, and push support. Registers docker (build), dockerTag, dockerPush, dockerLogin, dockerLogout, dockerClean, and dockerCleanupImage tasks. Configure images via the docker DSL: image name, Dockerfile path, build args, labels, platforms, and additional build context files. Supports docker buildx (default) with multi-platform builds and automatic AWS ECR login. Automatically stamps images with build provenance labels (branch, commit hash, build number, repository URL). When com.stano.spring-boot is also applied, auto-configures the image name and wires bootWar output as the build context.

• #convention
• #docker

Packages Kotlin/Wasm production output into a cache-safe deployment release.

• #kotlin
• #wasm
• #deployment
• #gradle-plugin

Extension to make compatible Paparazzi html output reports with Develocity Test Distribution

• #develocity
• #test distribution
• #paparazzi

A Gradle plugin for publishing DITA documents with DITA Open Toolkit. Continuation of com.github.eerohele.dita-ot-gradle with Kotlin migration. Supports incremental builds, continuous mode, multiple output formats, and DITAVAL filtering. Faster than running DITA-OT directly thanks to the Gradle Daemon.

• #dita
• #dita-ot
• #documentation
• #publishing
• #technical-writing