Add a method to safely call the now-deprecated forUseAtConfigurationTime method

Author: zml2008

src/main/java/net/kyori/mammoth/GradleCompat.java

@@ -24,18 +24,18 @@
 package net.kyori.mammoth;
 
 import org.gradle.api.Project;
+import org.gradle.api.provider.Provider;
 
 final class GradleCompat {
-  static final boolean HAS_CONVENTION;
+  static final boolean HAS_CONVENTION = hasMethod(Project.class, "getConvention");
+  static final boolean HAS_FOR_USE_AT_CONFIGURATION_TIME = hasMethod(Provider.class, "forUseAtConfigurationTime");
 
-  static {
-    boolean hasConvention = false;
-    try {
-      Project.class.getMethod("getConvention");
-      hasConvention = true;
-    } catch (final NoSuchMethodException ex) {
-      // no-op
-    }
-    HAS_CONVENTION = hasConvention;
+  private static boolean hasMethod(final Class<?> clazz, final String name, final Class<?>... args) {
+      try {
+        clazz.getMethod(name, args);
+        return true;
+      } catch (final NoSuchMethodException ex) {
+          return false;
+      }
   }
 }

src/main/java/net/kyori/mammoth/Properties.java

@@ -24,19 +24,38 @@
 package net.kyori.mammoth;
 
 import org.gradle.api.provider.HasConfigurableValue;
+import org.gradle.api.provider.Provider;
 import org.jetbrains.annotations.NotNull;
 
 public final class Properties {
   private Properties() {
   }
 
+  /**
+   * Mark a property as being for use at configuration time.
+   *
+   * <p>Gradle has deprecated this method, but it is required on older Gradle versions.</p>
+   *
+   * @param <T> the provider value type
+   * @param provider provider to get for use at configuration time
+   * @return a configuration time-safe view of the provided provider
+   * @since 1.1.0
+   */
+  public static <T> @NotNull Provider<T> forUseAtConfigurationTime(final @NotNull Provider<T> provider) {
+    if (GradleCompat.HAS_FOR_USE_AT_CONFIGURATION_TIME) {
+      return provider.forUseAtConfigurationTime();
+    } else {
+      return provider;
+    }
+  }
+
   /**
    * Touches {@code property} to mark it as {@link HasConfigurableValue#finalizeValue() finalized}.
    *
    * @param property the property
    * @param <T> the type
    * @return the property
-   * @since 2.0.0
+   * @since 1.0.0
    */
   public static <T extends HasConfigurableValue> @NotNull T finalized(final @NotNull T property) {
     property.finalizeValue();
@@ -49,7 +68,7 @@ private Properties() {
    * @param property the property
    * @param <T> the type
    * @return the property
-   * @since 2.0.0
+   * @since 1.0.0
    */
   public static <T extends HasConfigurableValue> @NotNull T finalizedOnRead(final @NotNull T property) {
     property.finalizeValueOnRead();
@@ -62,7 +81,7 @@ private Properties() {
    * @param property the property
    * @param <T> the type
    * @return the property
-   * @since 2.0.0
+   * @since 1.0.0
    */
   public static <T extends HasConfigurableValue> @NotNull T changesDisallowed(final @NotNull T property) {
     property.disallowChanges();