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)
+ }
+}