Add a Progress API

Fix #52
Fix #56

Author: Christoph Läubrich

README.md

@@ -32,6 +32,11 @@ The project was relocated from <https://github.com/sonatype/sisu-build-api>. Als
 
 ## Provided APIs
 
+### Progress
+
+The API allows a mojo to report progress in a way that is suitable to be shown as a progressbar as well as check if the user wants the mojo to gracefully abort its current operation.
+This can be useful for example when processing some files in a loop so the user can directly see the amount of progress and possibly ask to abort if it takes to long.
+
 ### IDE connection to maven process
 
 This API is usually not used by mojos but for IDE integration, if enabled as a maven-core extension plexus-build-api supply a way to communicate with the running maven build and get events.

src/main/java/org/codehaus/plexus/build/progress/DefaultProgress.java

@@ -0,0 +1,64 @@
+package org.codehaus.plexus.build.progress;
+
+import javax.inject.Inject;
+import javax.inject.Named;
+import javax.inject.Singleton;
+
+import org.apache.maven.execution.scope.MojoExecutionScoped;
+import org.apache.maven.plugin.MojoExecution;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * The default implementation simply log to debug and check for thread
+ * interruption
+ */
+@Named("default")
+@Singleton
+@MojoExecutionScoped
+public class DefaultProgress implements Progress {
+
+    private final Logger logger = LoggerFactory.getLogger(DefaultProgress.class);
+    private MojoExecution execution;
+    private int work;
+
+    @Inject
+    public DefaultProgress(MojoExecution execution) {
+        this.execution = execution;
+    }
+
+    @Override
+    public void startTask(String task, int work) {
+        setRemaining(work);
+        logger.debug(execution.getExecutionId() + ": " + task);
+    }
+
+    @Override
+    public void worked(int work) {
+        if (work == 0) {
+            return;
+        }
+        if (work < 0) {
+            logger.warn(execution.getExecutionId() + " reported negative amount of work!");
+        }
+        if (this.work < 0) {
+            return;
+        }
+        if (work > this.work) {
+            this.work = -1;
+            logger.warn(execution.getExecutionId() + " reported more work than expected!");
+        } else {
+            this.work -= work;
+        }
+    }
+
+    @Override
+    public void setRemaining(int work) {
+        this.work = work <= 0 ? -1 : work;
+    }
+
+    @Override
+    public boolean isCancelRequested() {
+        return Thread.currentThread().isInterrupted();
+    }
+}

src/main/java/org/codehaus/plexus/build/progress/Progress.java

@@ -0,0 +1,47 @@
+package org.codehaus.plexus.build.progress;
+
+/**
+ * The {@link Progress} allows a mojo to report its current state and check if
+ * the user has requested cancellation.
+ */
+public interface Progress {
+
+    /**
+     * Reports that the mojo has started the given task with the given amount of
+     * work.
+     *
+     * @param name
+     * @param work the amount of work that the mojo plan to report, if a value <= 0
+     *             is given the amount of work is assumed to be unknown.
+     */
+    void startTask(String task, int work);
+
+    /**
+     * Reports a given amount of work was processed
+     *
+     * @param work
+     */
+    void worked(int work);
+
+    /**
+     * Reports one unit of work to be processed
+     */
+    default void worked() {
+        worked(1);
+    }
+
+    /**
+     * Notifies the remaining amount of work that will be reported
+     *
+     * @param work
+     */
+    void setRemaining(int work);
+
+    /**
+     * This method should be used to check if the user has requested to finish the
+     * current work and break out early.
+     *
+     * @return <code>true</code> if a cancel request is currently pending.
+     */
+    boolean isCancelRequested();
+}