detect changes in mapping.yaml outside the apiDir (#7, based on (#89)

Author: hauner

src/main/kotlin/io/openapiprocessor/gradle/OpenApiProcessorPlugin.kt

@@ -124,6 +124,7 @@ class OpenApiProcessorPlugin: Plugin<Project> {
                 copyApiPath (task)
                 task.getApiDir().set(project.layout.projectDirectory.dir(getInputDirectory()))
                 task.getTargetDir().set(project.layout.projectDirectory.dir(getOutputDirectory()))
+                processor.getMapping()?.let { task.getMapping().set(project.file(it)) }
 
                 val handler = project.dependencies
                 val dependencies = ArrayList<Dependency>()

src/main/kotlin/io/openapiprocessor/gradle/OpenApiProcessorTask.kt

@@ -8,11 +8,14 @@ package io.openapiprocessor.gradle
 import org.gradle.api.DefaultTask
 import org.gradle.api.file.ConfigurableFileCollection
 import org.gradle.api.file.DirectoryProperty
+import org.gradle.api.file.RegularFileProperty
 import org.gradle.api.provider.MapProperty
 import org.gradle.api.provider.Property
 import org.gradle.api.tasks.Classpath
 import org.gradle.api.tasks.InputDirectory
+import org.gradle.api.tasks.InputFile
 import org.gradle.api.tasks.Internal
+import org.gradle.api.tasks.Optional
 import org.gradle.api.tasks.OutputDirectory
 import org.gradle.api.tasks.TaskAction
 import org.gradle.workers.WorkerExecutor
@@ -33,6 +36,15 @@ abstract class OpenApiProcessorTask: DefaultTask() {
     @InputDirectory
     abstract fun getApiDir(): DirectoryProperty
 
+    /**
+     * mapping.yaml input file. Used by gradle for the up-to-date check.
+     *
+     * @return mapping.yaml
+     */
+    @Optional
+    @InputFile
+    abstract fun getMapping(): RegularFileProperty
+
     /**
      * Target directory for the sources generated by the processor. Used by gradle for the up-to-date check.
      *

src/main/kotlin/io/openapiprocessor/gradle/Processor.kt

@@ -110,6 +110,10 @@ open class Processor(configName: String): ProcessorBase() {
         other[API_PATH] = apiPath.toString()
     }
 
+    fun getMapping(): String? {
+        return other["mapping"]?.toString()
+    }
+
     fun prop(props: Map<String, Any>) {
         other.putAll(props)
     }

src/testInt/groovy/io/openapiprocessor/gradle/MappingSpec.groovy

@@ -0,0 +1,70 @@
+/*
+ * Copyright 2025 https://github.com/openapi-processor/openapi-processor-gradle
+ * PDX-License-Identifier: Apache-2.0
+ */
+
+package io.openapiprocessor.gradle
+
+
+import io.openapiprocessor.gradle.support.PluginSpec
+
+class MappingSpec extends PluginSpec {
+
+    @Override
+    String getBuildFileName () {
+        'build.gradle.kts'
+    }
+
+    @Override
+    String getBuildFile (String projectDir) {
+        """\
+        import io.openapiprocessor.gradle.OpenApiProcessorTask
+
+        plugins {
+            id("io.openapiprocessor.openapi-processor")
+        }
+        
+        repositories {
+            mavenCentral()
+        }
+        
+        openapiProcessor {
+            apiPath(file("src/api/openapi.yaml"))
+        
+            process("v1") {
+                processor(project.files("$projectDir/processor-v1/build/libs/processor-v1.jar"))
+                targetDir(layout.buildDirectory.dir("v1"))
+        
+                prop("mapping", file("mapping.yaml"))
+            }
+        }
+        
+        afterEvaluate {
+            val task = tasks.named("processV1").get() as OpenApiProcessorTask
+            
+            println("MAPPING:")
+            val mapping = task.getMapping()
+            println(mapping)
+
+            val mapping2 = mapping.get()
+            println(mapping2)
+        }
+        
+        """.stripIndent ()
+    }
+
+    @Override
+    List<String> getGradleArguments () {
+        ['--stacktrace', '--debug']
+    }
+
+    void "passes mapping to task if set" () {
+        when:
+        def result = build("9.0.0", """\
+            """.stripIndent())
+
+        then:
+        def mapping = new File(testProjectDir, "mapping.yaml")
+        result.output.contains(mapping.absolutePath)
+    }
+}