modernize Gradle task input handling to support remote URIs (fix regression)

Author: Picazsoo

modules/openapi-generator-gradle-plugin/src/main/kotlin/org/openapitools/generator/gradle/plugin/extensions/OpenApiGeneratorGenerateExtension.kt

@@ -22,6 +22,7 @@ import org.gradle.api.file.RegularFileProperty
 import org.gradle.kotlin.dsl.listProperty
 import org.gradle.kotlin.dsl.mapProperty
 import org.gradle.kotlin.dsl.property
+import org.openapitools.generator.gradle.plugin.utils.isRemoteUri
 
 /**
  * Gradle project level extension object definition for the `generate` task
@@ -444,7 +445,11 @@ open class OpenApiGeneratorGenerateExtension(private val project: Project) {
 
     /** Backwards-compatibility bridge for inputSpec */
     fun setInputSpec(path: String) {
-        inputSpec.set(project.layout.projectDirectory.file(path))
+        if (path.isRemoteUri()) {
+            remoteInputSpec.set(path)
+        } else {
+            inputSpec.set(project.layout.projectDirectory.file(path))
+        }
     }
 
     /** Backwards-compatibility bridge for inputSpecRootDirectory */

modules/openapi-generator-gradle-plugin/src/main/kotlin/org/openapitools/generator/gradle/plugin/extensions/OpenApiGeneratorValidateExtension.kt

@@ -20,6 +20,7 @@ import org.gradle.api.Project
 import org.gradle.api.file.RegularFileProperty
 import org.gradle.api.provider.Property
 import org.gradle.kotlin.dsl.property
+import org.openapitools.generator.gradle.plugin.utils.isRemoteUri
 
 /**
  * Gradle project level extension object definition for the generators task
@@ -32,6 +33,11 @@ open class OpenApiGeneratorValidateExtension(private val project: Project) {
      */
     val inputSpec: RegularFileProperty = project.objects.fileProperty()
 
+    /**
+     * The remote input specification to validate. Supports URLs/URIs.
+     */
+    val remoteInputSpec: Property<String> = project.objects.property()
+
     /**
      * Whether to offer recommendations related to the validated specification document.
      */
@@ -49,6 +55,10 @@ open class OpenApiGeneratorValidateExtension(private val project: Project) {
 
     /** Backwards-compatibility bridge for inputSpec */
     fun setInputSpec(path: String) {
-        inputSpec.set(project.layout.projectDirectory.file(path))
+        if (path.isRemoteUri()) {
+            remoteInputSpec.set(path)
+        } else {
+            inputSpec.set(project.layout.projectDirectory.file(path))
+        }
     }
 }

modules/openapi-generator-gradle-plugin/src/main/kotlin/org/openapitools/generator/gradle/plugin/tasks/GenerateTask.kt

@@ -37,6 +37,7 @@ import org.openapitools.codegen.DefaultGenerator
 import org.openapitools.codegen.config.CodegenConfigurator
 import org.openapitools.codegen.config.GlobalSettings
 import org.openapitools.codegen.config.MergedSpecBuilder
+import org.openapitools.generator.gradle.plugin.utils.isRemoteUri
 import javax.inject.Inject
 
 // =========================================================================================
@@ -318,14 +319,16 @@ abstract class GenerateTask : DefaultTask() {
     abstract val outputDir: DirectoryProperty
 
     @Suppress("unused")
-    @set:Option(option = "input", description = "The input specification.")
-    @get:Internal
-    var input: String? = null
-        set(value) {
-            if (value != null) {
+    @Option(option = "input", description = "The input specification (local path or URL/URI).")
+    fun setInput(value: String) {
+        if (value.isNotEmpty()) {
+            if (value.isRemoteUri()) {
+                remoteInputSpec.set(value)
+            } else {
                 inputSpec.set(layout.projectDirectory.file(value))
             }
         }
+    }
 
     /**
      * The Open API 2.0/3.x specification location.

modules/openapi-generator-gradle-plugin/src/main/kotlin/org/openapitools/generator/gradle/plugin/tasks/ValidateTask.kt

@@ -27,9 +27,8 @@ import org.gradle.api.tasks.*
 import org.gradle.api.tasks.options.Option
 import org.openapitools.codegen.validations.oas.OpenApiEvaluator
 import org.openapitools.codegen.validations.oas.RuleConfiguration
+import org.openapitools.generator.gradle.plugin.utils.isRemoteUri
 import javax.inject.Inject
-import kotlin.text.get
-import kotlin.text.set
 
 /**
  * A generator which validates an Open API spec. This task outputs a list of validation issues and errors.
@@ -53,10 +52,15 @@ abstract class ValidateTask : DefaultTask() {
     @get:Inject
     abstract val layout: ProjectLayout
 
+    @get:Optional
     @get:InputFile
     @get:PathSensitive(PathSensitivity.RELATIVE)
     abstract val inputSpec: RegularFileProperty
 
+    @get:Optional
+    @get:Input
+    abstract val remoteInputSpec: Property<String>
+
     @get:Optional
     @get:Input
     abstract val recommend: Property<Boolean>
@@ -70,29 +74,37 @@ abstract class ValidateTask : DefaultTask() {
         treatWarningsAsErrors.convention(false)
     }
 
-    @get:Internal
-    @set:Option(option = "input", description = "The input specification.")
-    var input: String? = null
-        set(value) {
-            if (value != null) {
+    @Suppress("unused")
+    @Option(option = "input", description = "The input specification (local path or URL).")
+    fun setInput(value: String) {
+        if (value.isNotEmpty()) {
+            if (value.isRemoteUri()) {
+                remoteInputSpec.set(value)
+            } else {
                 inputSpec.set(layout.projectDirectory.file(value))
             }
         }
+    }
 
     @TaskAction
     fun doWork() {
-        // Evaluate inputs
-        val specFile = inputSpec.get().asFile
-        val specPath = specFile.absolutePath
+        // Evaluate inputs - prefer remote if provided, fallback to local file
+        val specLocation = remoteInputSpec.orNull ?: inputSpec.orNull?.asFile?.absolutePath
+
+        if (specLocation == null) {
+            throw GradleException("You must configure either inputSpec or provide a valid remote input via --input")
+        }
+
         val recommendations = recommend.get()
         val failOnWarnings = treatWarningsAsErrors.get()
 
-        logger.lifecycle("Validating spec $specPath")
+        logger.lifecycle("Validating spec $specLocation")
 
         val options = ParseOptions()
         options.isResolve = true
 
-        val result = OpenAPIParser().readLocation(specPath, null, options)
+        // Pass specLocation instead of specPath
+        val result = OpenAPIParser().readLocation(specLocation, null, options)
         val messages = result.messages.toSet()
 
         val ruleConfiguration = RuleConfiguration()

modules/openapi-generator-gradle-plugin/src/main/kotlin/org/openapitools/generator/gradle/plugin/utils/StringUtils.kt

@@ -0,0 +1,12 @@
+package org.openapitools.generator.gradle.plugin.utils
+
+// Compile the regex once for performance
+private val remoteUriRegex = "^[a-zA-Z][a-zA-Z0-9+\\-.]+?:.*".toRegex()
+
+/**
+ * Determines if a string is a remote URI (e.g., http:, jar:, s3:)
+ * while safely ignoring 1-letter Windows drives (e.g., C:\).
+ */
+internal fun String.isRemoteUri(): Boolean {
+    return this.matches(remoteUriRegex)
+}