feat(plugin/generator): allow for file to be used for discoveryUrl

* Use `java.net.URI` instead of `java.net.URL`

Author: EdricChan03

plugins/generator/src/main/kotlin/io/github/edricchan03/koogle_api/plugin/generator/KoogleApiGeneratorPluginExtension.kt

@@ -2,20 +2,92 @@ package io.github.edricchan03.koogle_api.plugin.generator
 
 import io.github.edricchan03.koogle_api.plugin.generator.tasks.SchemaFileNameMapper
 import org.gradle.api.file.DirectoryProperty
+import org.gradle.api.file.RegularFile
 import org.gradle.api.file.RegularFileProperty
 import org.gradle.api.provider.Property
-import java.net.URL
+import org.gradle.api.provider.Provider
+import java.io.File
+import java.net.URI
+import java.nio.file.Path
 
 /**
  * Configuration options for the [Koogle API generator plugin][KoogleApiGeneratorPlugin].
  */
 public abstract class KoogleApiGeneratorPluginExtension {
-    /** The discovery URL to use. */
-    public abstract val discoveryUrl: Property<URL>
+    /**
+     * The discovery URL to use.
+     *
+     * A file path can be used.
+     * @since 0.1.0
+     */
+    public abstract val discoveryUrl: Property<URI>
 
-    /** The discovery URL to use. */
+    /**
+     * The discovery URL to use.
+     * @since 0.1.0
+     */
     public fun discoveryUrl(url: String) {
-        discoveryUrl.set(URL(url))
+        discoveryUrl.set(URI(url))
+    }
+
+    /**
+     * The discovery URL to use, as a [Provider].
+     * @since 0.1.0
+     */
+    @JvmName("discoveryUrlProviderString")
+    public fun discoveryUrl(url: Provider<String>) {
+        discoveryUrl.set(url.map { URI(it) })
+    }
+
+    /**
+     * The discovery file to use.
+     * @since 0.1.0
+     */
+    public fun discoveryUrl(file: File) {
+        discoveryUrl.set(file.toURI())
+    }
+
+    /**
+     * The discovery file to use, as a [Provider].
+     * @since 0.1.0
+     */
+    @JvmName("discoveryUrlProviderFile")
+    public fun discoveryUrl(file: Provider<File>) {
+        discoveryUrl.set(file.map { it.toURI() })
+    }
+
+    /**
+     * The discovery file to use, as a [Path].
+     * @since 0.1.0
+     */
+    public fun discoveryUrl(path: Path) {
+        discoveryUrl.set(path.toUri())
+    }
+
+    /**
+     * The discovery file to use, as a [Provider] of [Path].
+     * @since 0.1.0
+     */
+    @JvmName("discoveryUrlProviderPath")
+    public fun discoveryUrl(path: Provider<Path>) {
+        discoveryUrl.set(path.map { it.toUri() })
+    }
+
+    /**
+     * The discovery file to use, as a [RegularFile].
+     * @since 0.1.0
+     */
+    public fun discoveryUrl(file: RegularFile) {
+        discoveryUrl.set(file.asFile.toURI())
+    }
+
+    /**
+     * The discovery file to use, as a [Provider] of [RegularFile].
+     * @since 0.1.0
+     */
+    @JvmName("discoveryUrlProviderRegularFile")
+    public fun discoveryUrl(file: Provider<RegularFile>) {
+        discoveryUrl.set(file.map { it.asFile.toURI() })
     }
 
     /**