Add gradleutils#pluginDevDefaults

Does some convention defaults when invoked with the configurations
container and the requested Gradle version. Helps to eliminate more
unnecessary clutter in the buildscripts.

Author: Jonathing

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

@@ -5,7 +5,10 @@
 package net.minecraftforge.gradleutils;
 
 import org.gradle.api.Action;
+import org.gradle.api.artifacts.ConfigurationContainer;
 import org.gradle.api.provider.Property;
+import org.gradle.api.provider.Provider;
+import org.gradle.api.provider.ProviderConvertible;
 import org.gradle.api.publish.maven.MavenPublication;
 import org.gradle.api.tasks.TaskProvider;
 
@@ -20,6 +23,14 @@ public sealed interface GradleUtilsExtensionForProject extends GradleUtilsExtens
     /// @return The property for the display name
     Property<String> getDisplayName();
 
+    void pluginDevDefaults(ConfigurationContainer configurations, CharSequence gradleVersion);
+
+    void pluginDevDefaults(ConfigurationContainer configurations, Provider<? extends CharSequence> gradleVersion);
+
+    default void pluginDevDefaults(ConfigurationContainer configurations, ProviderConvertible<? extends CharSequence> gradleVersion) {
+        this.pluginDevDefaults(configurations, gradleVersion.asProvider());
+    }
+
     /// 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

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

@@ -9,7 +9,10 @@ import groovy.transform.PackageScope
 import org.codehaus.groovy.runtime.InvokerHelper
 import org.gradle.api.Action
 import org.gradle.api.Project
+import org.gradle.api.artifacts.Configuration
+import org.gradle.api.artifacts.ConfigurationContainer
 import org.gradle.api.artifacts.repositories.MavenArtifactRepository
+import org.gradle.api.attributes.plugin.GradlePluginApiVersion
 import org.gradle.api.file.Directory
 import org.gradle.api.file.DirectoryProperty
 import org.gradle.api.flow.FlowProviders
@@ -210,6 +213,25 @@ import static net.minecraftforge.gradleutils.GradleUtilsPlugin.LOGGER
             }
         }
 
+        @Override
+        void pluginDevDefaults(ConfigurationContainer configurations, CharSequence gradleVersion) {
+            this.pluginDevDefaults(configurations, this.providers.provider { gradleVersion })
+        }
+
+        @Override
+        void pluginDevDefaults(ConfigurationContainer configurations, Provider<? extends CharSequence> gradleVersion) {
+            // Applies the "Gradle Plugin API Version" attribute to configuration
+            // This was added in Gradle 7, gives consumers useful errors if they are on an old version
+            this.project.configurations.named(JavaPlugin.RUNTIME_ELEMENTS_CONFIGURATION_NAME.&containsIgnoreCase as Spec<String>).configureEach { configuration ->
+                configuration.attributes { attributes ->
+                    attributes.attributeProvider(
+                        GradlePluginApiVersion.GRADLE_PLUGIN_API_VERSION_ATTRIBUTE,
+                        gradleVersion.map { this.objects.named(GradlePluginApiVersion, it.toString()) }
+                    )
+                }
+            }
+        }
+
         @Override
         TaskProvider<? extends PromotePublication> promote(MavenPublication publication, @Nullable Action<? super PromotePublication> cfg) {
             this.project.tasks.register("promote${publication.name.capitalize()}Publication", PromotePublicationImpl, publication).tap { promote ->