(maven-studies) branch maven-atr-plugin updated: add runOnlyAtExecutionRoot logic

[hboutemy]

This is an automated email from the ASF dual-hosted git repository.

hboutemy pushed a commit to branch maven-atr-plugin
in repository https://gitbox.apache.org/repos/asf/maven-studies.git


The following commit(s) were added to refs/heads/maven-atr-plugin by this push:
     new 3552b55d6 add runOnlyAtExecutionRoot logic
3552b55d6 is described below

commit 3552b55d648623193e379081094d353d4502c75b
Author: Hervé Boutemy <hbout...@apache.org>
AuthorDate: Sun Mar 15 19:10:06 2026 +0100

    add runOnlyAtExecutionRoot logic
---
 .../apache/maven/plugins/atr/AbstractAtrMojo.java  | 38 ++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/src/main/java/org/apache/maven/plugins/atr/AbstractAtrMojo.java 
b/src/main/java/org/apache/maven/plugins/atr/AbstractAtrMojo.java
index 5b89e5019..d499d396c 100644
--- a/src/main/java/org/apache/maven/plugins/atr/AbstractAtrMojo.java
+++ b/src/main/java/org/apache/maven/plugins/atr/AbstractAtrMojo.java
@@ -18,13 +18,16 @@
  */
 package org.apache.maven.plugins.atr;
 
+import java.io.File;
 import java.net.URL;
 
+import org.apache.maven.execution.MavenSession;
 import org.apache.maven.plugin.AbstractMojo;
 import org.apache.maven.plugin.MojoExecutionException;
 import org.apache.maven.plugin.MojoFailureException;
 import org.apache.maven.plugins.annotations.Component;
 import org.apache.maven.plugins.annotations.Parameter;
+import org.apache.maven.project.MavenProject;
 import org.apache.maven.settings.Server;
 import org.apache.maven.settings.Settings;
 import org.apache.maven.settings.crypto.DefaultSettingsDecryptionRequest;
@@ -63,6 +66,25 @@ public abstract class AbstractAtrMojo extends AbstractMojo {
     @Parameter(property = "atr.serverId", defaultValue = "apache.atr")
     protected String serverId;
 
+    /**
+     * If set to true, the plugin will only execute in the execution root 
directory (typically the top-level
+     * directory of a multi-module build). This prevents the plugin from 
running multiple times in child modules.
+     */
+    @Parameter(property = "atr.runOnlyAtExecutionRoot", defaultValue = "false")
+    protected boolean runOnlyAtExecutionRoot;
+
+    /**
+     * Maven project.
+     */
+    @Parameter(defaultValue = "${project}", readonly = true, required = true)
+    protected MavenProject project;
+
+    /**
+     * Maven session.
+     */
+    @Parameter(defaultValue = "${session}", readonly = true, required = true)
+    protected MavenSession session;
+
     /**
      * Maven settings.
      */
@@ -111,9 +133,25 @@ public abstract class AbstractAtrMojo extends AbstractMojo 
{
             return;
         }
 
+        if (runOnlyAtExecutionRoot && !isExecutionRoot()) {
+            getLog().info("Skipping ATR plugin execution (not execution 
root)");
+            return;
+        }
+
         atrExecute();
     }
 
+    /**
+     * Check if the current project is the execution root.
+     *
+     * @return true if this is the execution root
+     */
+    private boolean isExecutionRoot() {
+        File executionRootDirectory = new 
File(session.getExecutionRootDirectory());
+        File projectBaseDir = project.getBasedir();
+        return executionRootDirectory.equals(projectBaseDir);
+    }
+
     /**
      * Execute the ATR-specific logic.
      *