Add Quarkus and Protobuf support, improve documentation

- Add automatic detection and dependency management for Quarkus and Protobuf
- Switch from configuration-based to extension-based plugin detection
- Add real plugin dependencies for testing (Spring Boot, Quarkus, Protobuf)
- Enhance README with Requirements, How it works, Troubleshooting sections
- Add Contributing guide and improve dependency table
- Enable Gradle configuration cache and increase JVM memory
- Modernize code with Java 17+ features

Author: Соболев Василий

README.md

@@ -1,5 +1,6 @@
 <p align="center">
   <a href="https://github.com/AkaZver/mapstruct-plugin/actions"><img src="https://github.com/AkaZver/mapstruct-plugin/workflows/Build/badge.svg" alt="Actions Status"></a>
+  <a href="#"><img src="https://img.shields.io/gradle-plugin-portal/v/com.github.akazver.mapstruct?label=Plugin Version&logo=github" alt="Plugin Version"></a>
   <a href="https://sonarcloud.io"><img src="https://sonarcloud.io/api/project_badges/measure?project=AkaZver_mapstruct-plugin&metric=alert_status" alt="Quality Gate Status"></a>
   <a href="https://sonarcloud.io"><img src="https://sonarcloud.io/api/project_badges/measure?project=AkaZver_mapstruct-plugin&metric=coverage" alt="Coverage"></a>
   <br/>
@@ -18,33 +19,49 @@
 
 Gradle plugin for easy [MapStruct](https://mapstruct.org/) setup
 
-Usage:
+## Requirements
+
+- **Gradle:** 9.0 or higher
+- **Java:** 17 or higher
+
+## Usage
+
 ```groovy
 plugins {
-    id 'com.github.akazver.mapstruct' version '2.0.0'
+    id 'com.github.akazver.mapstruct' version 'X.Y.Z'
 }
 ```
 
-## Dependencies
-**MapStruct** (required)
-- [mapstruct](https://mvnrepository.com/artifact/org.mapstruct/mapstruct) (implementation)
-- [mapstruct-processor](https://mvnrepository.com/artifact/org.mapstruct/mapstruct-processor) (annotationProcessor)
+## How it works
 
-**Lombok** (optional)
-- [lombok-mapstruct-binding](https://mvnrepository.com/artifact/org.projectlombok/lombok-mapstruct-binding) (annotationProcessor)
+The plugin automatically:
 
-**Spring** (optional)
-- [mapstruct-spring-annotations](https://mvnrepository.com/artifact/org.mapstruct.extensions.spring/mapstruct-spring-annotations) (implementation)
-- [mapstruct-spring-extensions](https://mvnrepository.com/artifact/org.mapstruct.extensions.spring/mapstruct-spring-extensions) (annotationProcessor)
-- [mapstruct-spring-test-extensions](https://mvnrepository.com/artifact/org.mapstruct.extensions.spring/mapstruct-spring-test-extensions) (testImplementation)
+- Adds MapStruct dependencies (`mapstruct` and `mapstruct-processor`)
+- Detects optional dependencies (Lombok, Spring, Camel, Quarkus, Protobuf) in your project
+- Adds required binding libraries when needed (e.g., `lombok-mapstruct-binding` for Lombok)
+- Configures compiler arguments based on your `mapstruct {}` block settings
+- Runs after project evaluation to ensure all dependencies are resolved
 
-**Camel** (optional)
-- [camel-mapstruct](https://mvnrepository.com/artifact/org.apache.camel/camel-mapstruct) (implementation)
-- [camel-mapstruct-starter](https://mvnrepository.com/artifact/org.apache.camel.springboot/camel-mapstruct-starter) (implementation)
-- [camel-quarkus-mapstruct](https://mvnrepository.com/artifact/org.apache.camel.quarkus/camel-quarkus-mapstruct) (implementation)
+## Dependencies
+
+| Category                   | GitHub                                                                                            | Maven                                                                                                                                                                   | Configuration         |
+|----------------------------|---------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------|
+| **MapStruct** *(required)* | [mapstruct/mapstruct](https://github.com/mapstruct/mapstruct)                                     | [org.mapstruct/mapstruct](https://mvnrepository.com/artifact/org.mapstruct/mapstruct)                                                                                   | `implementation`      |
+|                            |                                                                                                   | [org.mapstruct/mapstruct-processor](https://mvnrepository.com/artifact/org.mapstruct/mapstruct-processor)                                                               | `annotationProcessor` |
+| **Lombok**                 | [projectlombok/lombok](https://github.com/projectlombok/lombok)                                   | [org.projectlombok/lombok-mapstruct-binding](https://mvnrepository.com/artifact/org.projectlombok/lombok-mapstruct-binding)                                             | `annotationProcessor` |
+| **Spring**                 | [mapstruct/mapstruct-spring-extensions](https://github.com/mapstruct/mapstruct-spring-extensions) | [org.mapstruct.extensions.spring/mapstruct-spring-annotations](https://mvnrepository.com/artifact/org.mapstruct.extensions.spring/mapstruct-spring-annotations)         | `implementation`      |
+|                            |                                                                                                   | [org.mapstruct.extensions.spring/mapstruct-spring-extensions](https://mvnrepository.com/artifact/org.mapstruct.extensions.spring/mapstruct-spring-extensions)           | `annotationProcessor` |
+|                            |                                                                                                   | [org.mapstruct.extensions.spring/mapstruct-spring-test-extensions](https://mvnrepository.com/artifact/org.mapstruct.extensions.spring/mapstruct-spring-test-extensions) | `testImplementation`  |
+| **Camel**                  | [apache/camel](https://github.com/apache/camel)                                                   | [org.apache.camel/camel-mapstruct](https://mvnrepository.com/artifact/org.apache.camel/camel-mapstruct)                                                                 | `implementation`      |
+|                            | [apache/camel-spring-boot](https://github.com/apache/camel-spring-boot)                           | [org.apache.camel.springboot/camel-mapstruct-starter](https://mvnrepository.com/artifact/org.apache.camel.springboot/camel-mapstruct-starter)                           | `implementation`      |
+|                            | [apache/camel-quarkus](https://github.com/apache/camel-quarkus)                                   | [org.apache.camel.quarkus/camel-quarkus-mapstruct](https://mvnrepository.com/artifact/org.apache.camel.quarkus/camel-quarkus-mapstruct)                                 | `implementation`      |
+| **Quarkus**                | [quarkiverse/quarkus-mapstruct](https://github.com/quarkiverse/quarkus-mapstruct)                 | [io.quarkiverse.mapstruct/quarkus-mapstruct](https://mvnrepository.com/artifact/io.quarkiverse.mapstruct/quarkus-mapstruct)                                             | `implementation`      |
+| **Protobuf**               | [entur/mapstruct-spi-protobuf](https://github.com/entur/mapstruct-spi-protobuf)                   | [no.entur.mapstruct.spi/protobuf-spi-impl](https://mvnrepository.com/artifact/no.entur.mapstruct.spi/protobuf-spi-impl)                                                 | `implementation`      |
 
 ## Config
+
 Plugin adds configuration block which looks like this:
+
 ```groovy
 mapstruct {
     suppressGeneratorTimestamp = true
@@ -60,8 +77,30 @@ mapstruct {
 }
 ```
 
-All parameters used according to official 
+All parameters used according to official
 [documentation](https://mapstruct.org/documentation/stable/reference/html/#configuration-options)
 
+## Troubleshooting
+
+### MapStruct not generating mappers
+
+Make sure you have the Java plugin applied and that annotation processing is enabled in your IDE.
+
+### Lombok + MapStruct conflicts
+
+The plugin automatically adds `lombok-mapstruct-binding` when Lombok is detected. If you still have issues, ensure
+Lombok plugin is applied before MapStruct plugin.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
 ## License
+
 [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FAkaZver%2Fmapstruct-plugin.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2FAkaZver%2Fmapstruct-plugin?ref=badge_large)

build.gradle

@@ -28,10 +28,19 @@ gradlePlugin {
 repositories {
     mavenLocal()
     mavenCentral()
+    gradlePluginPortal()
 }
 
 dependencies {
+    // id 'io.freefair.lombok' version '9.5.0'
     testImplementation 'io.freefair.gradle:lombok-plugin:9.5.0'
+    // id 'io.quarkus' version '3.38.0'
+    testImplementation 'io.quarkus:io.quarkus.gradle.plugin:3.38.0'
+    // id 'org.springframework.boot' version '4.1.0'
+    testImplementation 'org.springframework.boot:org.springframework.boot.gradle.plugin:4.1.0'
+    // id 'com.google.protobuf' version '0.10.0'
+    testImplementation 'com.google.protobuf:com.google.protobuf.gradle.plugin:0.10.0'
+
     testImplementation 'org.assertj:assertj-core:3.27.7'
     testImplementation 'org.junit.jupiter:junit-jupiter:6.1.2'
     testImplementation 'org.junit.platform:junit-platform-launcher:6.1.2'
@@ -42,6 +51,12 @@ dependencies {
 test {
     useJUnitPlatform()
     finalizedBy jacocoTestReport
+    maxParallelForks = 1
+}
+
+configurations.testImplementation {
+    exclude group: 'org.slf4j'
+    exclude group: 'org.jboss.slf4j'
 }
 
 java {

gradle.properties

@@ -1 +1,2 @@
-org.gradle.jvmargs=-Dfile.encoding=UTF-8 -Dconsole.encoding=UTF-8
+org.gradle.jvmargs=-Dfile.encoding=UTF-8 -Dconsole.encoding=UTF-8 -Xmx4g
+org.gradle.configuration-cache=true

src/main/java/com/github/akazver/gradle/plugins/mapstruct/dependency/AdditionalDependency.java

@@ -51,6 +51,14 @@ public class AdditionalDependency extends PluginDependency {
     public static final AdditionalDependency CAMEL_QUARKUS_MAPSTRUCT =
             new AdditionalDependency("implementation", "org.apache.camel.quarkus:camel-quarkus-mapstruct:3.36.0");
 
+    // https://mvnrepository.com/artifact/io.quarkiverse.mapstruct/quarkus-mapstruct
+    public static final AdditionalDependency QUARKUS_MAPSTRUCT =
+            new AdditionalDependency("implementation", "io.quarkiverse.mapstruct:quarkus-mapstruct:1.1.0");
+
+    // https://mvnrepository.com/artifact/no.entur.mapstruct.spi/protobuf-spi-impl
+    public static final AdditionalDependency PROTOBUF_SPI_IMPL =
+            new AdditionalDependency("implementation", "no.entur.mapstruct.spi:protobuf-spi-impl:1.62.0");
+
     public AdditionalDependency(String configuration, String id) {
         super(configuration, id);
     }

src/main/java/com/github/akazver/gradle/plugins/mapstruct/dependency/MarkerDependency.java

@@ -35,6 +35,10 @@ public class MarkerDependency extends PluginDependency {
     public static final MarkerDependency QUARKUS_CORE =
             new MarkerDependency("implementation", "io.quarkus:quarkus-core:3.38.0");
 
+    // https://mvnrepository.com/artifact/com.google.protobuf/protobuf-java
+    public static final MarkerDependency PROTOBUF_JAVA =
+            new MarkerDependency("implementation", "com.google.protobuf:protobuf-java:4.35.1");
+
     public MarkerDependency(String configuration, String id) {
         super(configuration, id);
     }

src/main/java/com/github/akazver/gradle/plugins/mapstruct/dependency/PluginDependency.java

@@ -28,8 +28,7 @@ public PluginDependency(String configuration, String id) {
         String[] split = id.split(":");
 
         if (split.length != 3) {
-            String message = String.format("Dependency id '%s' is invalid", id);
-            throw new MapstructPluginException(message);
+            throw new MapstructPluginException("Dependency id '%s' is invalid".formatted(id));
         }
 
         this.group = split[0];

src/main/java/com/github/akazver/gradle/plugins/mapstruct/manager/CompilerArgsManager.java

@@ -53,10 +53,9 @@ private String fetchCompilerArg(MapstructExtension extension, String name) {
             PropertyDescriptor descriptor = new PropertyDescriptor(name, MapstructExtension.class);
             Object value = descriptor.getReadMethod().invoke(extension);
 
-            return String.format(COMPILER_ARG_PATTERN, name, value);
+            return COMPILER_ARG_PATTERN.formatted(name, value);
         } catch (IllegalAccessException | InvocationTargetException | IntrospectionException exception) {
-            String message = String.format("Can't fetch compiler argument for '%s'", name);
-            throw new MapstructPluginException(message, exception);
+            throw new MapstructPluginException("Can't fetch compiler argument for '%s'".formatted(name), exception);
         }
     }
 

src/main/java/com/github/akazver/gradle/plugins/mapstruct/manager/DependencyManager.java

@@ -24,10 +24,6 @@ public class DependencyManager {
     private static final String ADDING_MESSAGE = "Adding {} dependencies";
     private static final String DEPENDENCY_PREFIX = "- {}";
 
-    private static final String LOMBOK_CONFIG_NAME = "lombok";
-    private static final String SPRING_BOOT_CONFIG_NAME = "bootArchives";
-    private static final String QUARKUS_EXT_NAME = "quarkus";
-
     private final ConfigurationContainer configurations;
     private final ExtensionContainer extensions;
     private final DependencyHandler dependencies;
@@ -44,12 +40,13 @@ public void addRequiredDependencies() {
     }
 
     public void addOptionalDependencies() {
-        boolean hasLombok = hasConfiguration(LOMBOK_CONFIG_NAME) || hasDependency(LOMBOK);
+        boolean hasLombok = hasExtension("lombok") || hasDependency(LOMBOK);
         boolean hasBinding = hasDependency(LOMBOK_MAPSTRUCT_BINDING);
-        boolean hasSpringBoot = hasConfiguration(SPRING_BOOT_CONFIG_NAME) || hasDependency(SPRING_BOOT);
+        boolean hasSpringBoot = hasExtension("springBoot") || hasDependency(SPRING_BOOT);
         boolean hasSpring = hasDependency(SPRING_CORE);
         boolean hasCamel = hasDependency(CAMEL_CORE);
-        boolean hasQuarkus = hasExtension(QUARKUS_EXT_NAME) || hasDependency(QUARKUS_CORE);
+        boolean hasQuarkus = hasExtension("quarkus") || hasDependency(QUARKUS_CORE);
+        boolean hasProtobuf = hasExtension("protobuf") || hasDependency(PROTOBUF_JAVA);
 
         if (hasLombok && !hasBinding) {
             LOGGER.lifecycle(ADDING_MESSAGE, "Lombok");
@@ -72,6 +69,16 @@ public void addOptionalDependencies() {
                 addDependency(CAMEL_MAPSTRUCT);
             }
         }
+
+        if (hasQuarkus) {
+            LOGGER.lifecycle(ADDING_MESSAGE, "Quarkus");
+            addDependency(QUARKUS_MAPSTRUCT);
+        }
+
+        if (hasProtobuf) {
+            LOGGER.lifecycle(ADDING_MESSAGE, "Protobuf");
+            addDependency(PROTOBUF_SPI_IMPL);
+        }
     }
 
     private boolean isNeededDependency(Dependency dependency, PluginDependency pluginDependency) {
@@ -86,11 +93,6 @@ private boolean hasDependency(PluginDependency pluginDependency) {
                 .anyMatch(dependency -> isNeededDependency(dependency, pluginDependency));
     }
 
-    private boolean hasConfiguration(String configurationName) {
-        return configurations.findByName(configurationName) != null;
-    }
-
-    @SuppressWarnings("SameParameterValue")
     private boolean hasExtension(String extensionName) {
         return extensions.findByName(extensionName) != null;
     }