Move all Git-related operations to GitVersion

GradleUtils 2.3 was 90% JGit and Git-related operations, which are all
now housed in the framework-agnostic GitVersion. Projects that do not
opt-in to using GitVersion or having subprojects are not affected.

There are a small amount of binary breaking changes in this update, but
it should not affect Gradle buildscripts (the primary consumer of this)
as they are dynamically compiled and can use Groovy's funky syntax to
get what they need.

Author: Jonathing

.github/workflows/publish.yml

@@ -11,7 +11,7 @@ jobs:
   build:
     uses: MinecraftForge/SharedActions/.github/workflows/gradle.yml@main
     with:
-      java: 11
+      java: 17
       gradle_tasks: "publish publishPlugins"
       artifact_name: "gradleutils"
     secrets:

build.gradle

@@ -1,30 +1,19 @@
 plugins {
     id 'java-gradle-plugin'
     id 'groovy'
+    id 'idea'
     id 'maven-publish'
-    id 'net.minecraftforge.licenser' version '1.0.1'
+    id 'net.minecraftforge.licenser' version '1.1.1'
     id 'com.gradle.plugin-publish' version '1.2.1'
     id 'net.minecraftforge.gradleutils'
-    id 'com.github.johnrengelman.shadow' version '8.1.1'
+    id 'com.gradleup.shadow' version '8.3.6'
 }
 
-group 'net.minecraftforge'
-version gradleutils.tagOffsetVersion
+group = 'net.minecraftforge'
+version = gitversion.version.tagOffset
 println "Version: $version"
 
-repositories {
-    mavenCentral()
-}
-
-dependencies {
-    implementation 'org.eclipse.jgit:org.eclipse.jgit:6.7.0.202309050840-r'
-}
-
-java {
-    // JGit 6.7 requires Java 11
-    toolchain.languageVersion = JavaLanguageVersion.of(11)
-    withSourcesJar()
-}
+apply from: 'build_shared.gradle'
 
 tasks.withType(GroovyCompile).configureEach {
     groovyOptions.optimizationOptions.indy = true
@@ -36,37 +25,27 @@ license {
     exclude '** /*.properties'
 }
 
-gradlePlugin {
-    website = 'https://github.com/MinecraftForge/GradleUtils'
-    vcsUrl = 'https://github.com/MinecraftForge/GradleUtils.git'
-    plugins {
-        gradleutils {
-            id = 'net.minecraftforge.gradleutils'
-            implementationClass = 'net.minecraftforge.gradleutils.GradleUtilsPlugin'
-            displayName = 'Forge Gradle Utilities'
-            description = 'Small collection of utilities for standerdizing our gradle scripts'
-            tags.set(['minecraftforge'])
-        }
-        changelog {
-            id = 'net.minecraftforge.changelog'
-            implementationClass = 'net.minecraftforge.gradleutils.changelog.ChangelogPlugin'
-            displayName = 'Git Changelog'
-            description = 'Creates a changelog text file based on git history'
-            tags.set(['git', 'changelog'])
-        }
-    }
-}
-
 jar {
     archiveClassifier = 'thin'
 }
 
 tasks.named('shadowJar', com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar) {
-    enableRelocation true
+    enableRelocation =  true
     archiveClassifier = null
     relocationPrefix = 'net.minecraftforge.gradleutils.shadow'
 }
 
+javadoc.enabled = false
+groovydoc.use = true
+
+// javadocJar is created after evaluation, so we need to configure it here
+afterEvaluate {
+    tasks.named('javadocJar', Jar) {
+        dependsOn groovydoc
+        from groovydoc.destinationDir
+    }
+}
+
 changelog {
     fromBase()
     publishAll = false
@@ -75,20 +54,21 @@ changelog {
 publishing {
     publications.register('pluginMaven', MavenPublication) {
         changelog.publish(it)
-        pom {
+        pom { pom ->
             artifactId = 'gradleutils'
             name = 'Gradle Utils'
             description = 'Used by MinecraftForge projects as a util library for Gradle buildscripts'
-            url = 'https://github.com/MinecraftForge/GradleUtils'
 
-            gradleutils.pom.setGitHubDetails(pom, 'GradleUtils')
+            gradleutils.pom.gitHubDetails = pom
 
             license gradleutils.pom.licenses.LGPLv2_1
 
+            // TODO [GradleUtils] Re-evaluate active developers in GU 3.0
             developers {
                 developer gradleutils.pom.Developers.LexManos
                 developer gradleutils.pom.Developers.SizableShrimp
                 developer gradleutils.pom.Developers.Paint_Ninja
+                developer gradleutils.pom.Developers.Jonathing
             }
         }
     }
@@ -97,3 +77,5 @@ publishing {
         maven gradleutils.publishingForgeMaven
     }
 }
+
+idea.module { downloadSources = downloadJavadoc = true }

buildSrc/build.gradle

@@ -2,16 +2,7 @@ plugins {
     id 'java-gradle-plugin'
 }
 
-repositories {
-    mavenCentral()
-}
-
-// JGit 6.7 requires Java 11
-java.toolchain.languageVersion = JavaLanguageVersion.of(11)
-
-dependencies {
-    implementation 'org.eclipse.jgit:org.eclipse.jgit:6.7.0.202309050840-r'
-}
+apply from: '../build_shared.gradle'
 
 sourceSets {
     main {
@@ -20,16 +11,3 @@ sourceSets {
         }
     }
 }
-
-gradlePlugin {
-    plugins {
-        gradleutils {
-            id = 'net.minecraftforge.gradleutils'
-            implementationClass = 'net.minecraftforge.gradleutils.GradleUtilsPlugin'
-        }
-        changelog {
-            id = 'net.minecraftforge.changelog'
-            implementationClass = 'net.minecraftforge.gradleutils.changelog.ChangelogPlugin'
-        }
-    }
-}

buildSrc/settings.gradle

@@ -0,0 +1 @@
+apply from: '../settings_shared.gradle'

build_shared.gradle

@@ -0,0 +1,52 @@
+
+java {
+    // GitVersion requires Java 17
+    toolchain.languageVersion = JavaLanguageVersion.of(17)
+    withSourcesJar()
+}
+
+repositories {
+    maven { url = 'https://maven.minecraftforge.net' }
+    maven { url = 'https://repo.eclipse.org/content/groups/releases/' }
+    mavenCentral()
+    mavenLocal()
+}
+
+dependencies {
+    // GitHub Actions Workflows
+    implementation libs.yaml
+
+    // Git Version
+    implementation libs.gitver
+
+    // TODO - Deprecated git utilities, remove in 3.0
+    implementation libs.jgit
+}
+
+gradlePlugin {
+    website = 'https://github.com/MinecraftForge/GradleUtils'
+    vcsUrl = 'https://github.com/MinecraftForge/GradleUtils.git'
+    plugins {
+        gradleutils {
+            id = 'net.minecraftforge.gradleutils'
+            implementationClass = 'net.minecraftforge.gradleutils.GradleUtilsPlugin'
+            displayName = 'Forge Gradle Utilities'
+            description = 'Small collection of utilities for standardizing our gradle scripts'
+            tags.set(['minecraftforge'])
+        }
+        gitversion {
+            id = 'net.minecraftforge.gitversion'
+            implementationClass = 'net.minecraftforge.gradleutils.gitversion.GitVersionPlugin'
+            displayName = 'Git Version'
+            description = 'Provides versioning information based on git history and configurable subprojects'
+            tags.set(['git', 'version'])
+        }
+        changelog {
+            id = 'net.minecraftforge.changelog'
+            implementationClass = 'net.minecraftforge.gradleutils.changelog.ChangelogPlugin'
+            displayName = 'Git Changelog'
+            description = 'Creates a changelog text file based on git history using GitVersion'
+            tags.set(['git', 'changelog'])
+        }
+    }
+}

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME