Allow promotion task to be configured

Author: Jonathing

src/main/groovy/net/minecraftforge/gradleutils/GradleUtilsExtensionForProject.java

@@ -4,6 +4,7 @@
  */
 package net.minecraftforge.gradleutils;
 
+import org.gradle.api.Action;
 import org.gradle.api.publish.maven.MavenPublication;
 import org.gradle.api.tasks.TaskProvider;
 
@@ -19,5 +20,19 @@ public sealed interface GradleUtilsExtensionForProject extends GradleUtilsExtens
     ///
     /// @param publication The publication to promote
     /// @return The provider for the promotion task
-    TaskProvider<? extends PromotePublication> promote(MavenPublication publication);
+    default TaskProvider<? extends PromotePublication> promote(MavenPublication publication) {
+        return this.promote(publication, null);
+    }
+
+    /// Promotes a publication to the <a href="https://files.minecraftforge.net">Forge Files Site</a>.
+    ///
+    /// Publications that are promoted will automatically have the relevant task added as a finalizer to the
+    /// `publishPublicationToForgeRepository` task, where the publication matches the task's publication and the
+    /// repository name is "forge". The publishing Forge repo added via [GradleUtilsExtension#getPublishingForgeMaven]
+    /// always sets it with the name "forge".
+    ///
+    /// @param publication The publication to promote
+    /// @param cfg         A configuring action for the task
+    /// @return The provider for the promotion task
+    TaskProvider<? extends PromotePublication> promote(MavenPublication publication, Action<? super PromotePublication> cfg);
 }

src/main/groovy/net/minecraftforge/gradleutils/GradleUtilsExtensionImpl.groovy

@@ -23,6 +23,7 @@ import org.gradle.api.publish.maven.tasks.PublishToMavenRepository
 import org.gradle.api.tasks.TaskProvider
 import org.gradle.authentication.http.BasicAuthentication
 import org.gradle.initialization.layout.BuildLayout
+import org.jetbrains.annotations.Nullable
 
 import javax.inject.Inject
 
@@ -129,8 +130,11 @@ import static net.minecraftforge.gradleutils.GradleUtilsPlugin.LOGGER
         }
 
         @Override
-        TaskProvider<? extends PromotePublication> promote(MavenPublication publication) {
+        TaskProvider<? extends PromotePublication> promote(MavenPublication publication, @Nullable Action<? super PromotePublication> cfg) {
             this.project.tasks.register('promote' + publication.name.capitalize(), PromotePublicationImpl).tap { promote ->
+                if (cfg !== null)
+                    promote.configure { cfg.execute(it) }
+
                 this.project.tasks.withType(PublishToMavenRepository).configureEach { publish ->
                     // if the publish task's publication isn't this one and the repo name isn't 'forge', skip
                     // the name being 'forge' is enforced by gradle utils