Stabilize publication promotion

Publication promotion (also known as artifact promotion) promotes a
published publication on the Forge files site to become the "latest"
version it displays. It also updates the files site and makes it aware
of the new version of the project that was just pushed to the maven.

This is designed for internal use only by Forge projects, or for
projects that have trusted access to the Forge maven. However, it is not
a requirement for all Forge projects to be promoted on the files site.

As a reminder, promotion is requested like this in your buildscript
(Groovy DSL):

```groovy
publishing {
    repositories {
        maven gradleutils.publishingForgeMaven
    }

    publications.register('pluginMaven', MavenPublication) {
        gradleutils.promote(it)

        // ...
    }
}
```

Author: Jonathing

.github/workflows/publish.yml

@@ -17,7 +17,6 @@ jobs:
     with:
       java: 17
       gradle_tasks: ':gradleutils-shared:check :check :gradleutils-shared:publish :publish :publishPlugins'
-      artifact_name: 'gradleutils,gradleutils-shared'
     secrets:
       DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
       PROMOTE_ARTIFACT_WEBHOOK: ${{ secrets.PROMOTE_ARTIFACT_WEBHOOK }}

build.gradle

@@ -137,6 +137,7 @@ publishing {
 
     publications.register('pluginMaven', MavenPublication) {
         changelog.publish(it)
+        gradleutils.promote(it)
 
         pom { pom ->
             name = projectDisplayName

gradleutils-shared/build.gradle

@@ -90,6 +90,8 @@ publishing {
     publications.register('mavenJava', MavenPublication) {
         from components.java
 
+        gradleutils.promote(it)
+
         pom { pom ->
             name = projectDisplayName
             description = project.description

settings.gradle

@@ -13,8 +13,8 @@ plugins {
     // NOTE: We need to load this into the classpath before GradleUtils for the service to load correctly
     id 'io.freefair.javadoc-links' version '8.14' apply false // https://plugins.gradle.org/plugin/io.freefair.javadoc-links
 
-    id 'net.minecraftforge.gradleutils' version '3.0.0' // https://plugins.gradle.org/plugin/net.minecraftforge.gradleutils
-    id 'net.minecraftforge.gitversion'  version '3.0.0' // https://plugins.gradle.org/plugin/net.minecraftforge.gitversion
+    id 'net.minecraftforge.gradleutils' version '3.1.4' // https://plugins.gradle.org/plugin/net.minecraftforge.gradleutils
+    id 'net.minecraftforge.gitversion'  version '3.0.2' // https://plugins.gradle.org/plugin/net.minecraftforge.gitversion
 }
 
 rootProject.name = 'gradleutils'
@@ -34,7 +34,7 @@ dependencyResolutionManagement {
             version 'gradle-javadoc-links', '8.14'
 
             plugin 'licenser',       'net.minecraftforge.licenser'  version '1.2.0' // https://plugins.gradle.org/plugin/net.minecraftforge.licenser
-            plugin 'changelog',      'net.minecraftforge.changelog' version '3.0.0' // https://plugins.gradle.org/plugin/net.minecraftforge.changelog
+            plugin 'changelog',      'net.minecraftforge.changelog' version '3.0.2' // https://plugins.gradle.org/plugin/net.minecraftforge.changelog
             plugin 'plugin-publish', 'com.gradle.plugin-publish'    version '1.3.1' // https://plugins.gradle.org/plugin/com.gradle.plugin-publish
             plugin 'shadow',         'com.gradleup.shadow'          version '9.0.2' // https://plugins.gradle.org/plugin/com.gradleup.shadow
 

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

@@ -11,8 +11,9 @@
 
 /// This task promotes a publication to the <a href="https://files.minecraftforge.net">Forge Files Site</a>.
 ///
-/// @apiNote This task is still [experimental][ApiStatus.Experimental]. It may be buggy and is subject to change.
-@ApiStatus.Experimental
+/// @apiNote This task is [internal][org.jetbrains.annotations.ApiStatus.Internal] as it is meant for use in Forge
+/// projects only.
+@ApiStatus.Internal
 public sealed interface PromotePublication extends Task permits PromotePublicationInternal {
     /// The publication group to promote.
     ///

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

@@ -11,6 +11,7 @@ import org.gradle.api.DefaultTask
 import org.gradle.api.plugins.BasePluginExtension
 import org.gradle.api.provider.ProviderFactory
 import org.gradle.api.publish.maven.MavenPublication
+import org.gradle.api.publish.plugins.PublishingPlugin
 import org.gradle.api.tasks.TaskAction
 
 import javax.inject.Inject
@@ -26,6 +27,9 @@ import java.time.Duration
 
     @Inject
     PromotePublicationImpl(MavenPublication publication) {
+        this.group = PublishingPlugin.PUBLISH_TASK_GROUP
+        this.description = "Publishes Maven publication '${publication.name}' to the Forge Files site."
+
         this.artifactGroup.convention(this.providers.provider(this.project.&getGroup).map(Object.&toString)).set(this.providers.provider(publication.&getGroupId))
         this.artifactName.convention(this.project.extensions.getByType(BasePluginExtension).archivesName).set(this.providers.provider(publication.&getArtifactId))
         this.artifactVersion.convention(this.providers.provider(this.project.&getVersion).map(Object.&toString)).set(this.providers.provider(publication.&getVersion))
@@ -45,7 +49,7 @@ import java.time.Duration
     @TaskAction
     void exec() {
         var client = HttpClient.newBuilder().tap {
-            sslParameters(SSLContext.default.defaultSSLParameters.tap { protocols = ["TLSv1.3"] })
+            sslParameters(SSLContext.default.defaultSSLParameters.tap { protocols = ['TLSv1.3'] })
         }.build()
 
         var request = HttpRequest.newBuilder().tap {
@@ -62,7 +66,7 @@ import java.time.Duration
         }.build()
 
         var response = client.send(request, HttpResponse.BodyHandlers.ofString())
-        if (response.statusCode() != 200)
+        if (response.statusCode() !== 200)
             throw new RuntimeException("Failed to promote artifact: ${response.statusCode()} ${response.body()}")
     }
 }