[ODM-10883] Rework api documentation, switch to opeanapi-generator-gradle-plugin

.gitattributes

@@ -0,0 +1,9 @@
+#
+# https://help.github.com/articles/dealing-with-line-endings/
+#
+# Linux start script should use lf
+/gradlew        text eol=lf
+
+# These are Windows script files and should use crlf
+*.bat           text eol=crlf
+

.gitignore

@@ -13,3 +13,9 @@ target
 .env-woq
 .arg
 .secret
+
+# Ignore Gradle project-specific cache directory
+.gradle
+
+# Ignore Gradle build output directory
+build

Earthfile

@@ -20,39 +20,26 @@ ARG --global --required NEXUS_REPOSITORY_URL
 deps:
     ARG --required BASE_IMAGES_VERSION
     FROM ${HARBOR_DOCKER_REGISTRY}/builder:${BASE_IMAGES_VERSION}
-    COPY requirements.R .
-    ARG APT_PACKAGES=build-essential \
-        pandoc texinfo texlive-latex-extra \
-        texlive-fonts-extra libz-dev libxml2-dev \
-        libcurl4-openssl-dev libssl-dev libssl-doc \
-        automake file libfribidi-dev libgfortran5 \
-        libfontconfig1-dev libgdal-dev libzmq3-dev \
-        libharfbuzz-dev libfreetype6-dev libpng-dev \
-        libtiff5-dev libjpeg-dev libxml2-dev \
-        libicu70 libgomp1 libreadline8
+    COPY requirements.R requirements.txt .
     RUN \
-        apt update && apt install -y ${APT_PACKAGES} && \
-        Rscript requirements.R
-
-    COPY pom.xml requirements.txt .
-    COPY .mvn .mvn
-    COPY mvnw mvnw
-    RUN \
-        ./mvnw de.qaware.maven:go-offline-maven-plugin:1.2.8:resolve-dependencies \
-            -Drevision=dummyValue && \
-        python3 -m pip install -r requirements.txt
+        Rscript requirements.R && \
+        python3 \
+            -m pip install \
+            -r requirements.txt
 
     SAVE IMAGE --cache-hint
 
 build:
     FROM +deps
 
-    COPY --dir openapi scripts docs templates .
+    COPY --dir openapi scripts gradle gradlew  build.gradle.kts settings.gradle.kts .
     # R allows only numeric versions
     # https://r-pkgs.org/lifecycle.html
     ARG --required ODM_OPENAPI_VERSION
     ENV ODM_OPENAPI_VERSION=${ODM_OPENAPI_VERSION}
-    RUN ./mvnw package
+    RUN ./gradlew \
+            --no-daemon \
+            generateAllApiClients
 
     SAVE IMAGE --cache-hint
     SAVE ARTIFACT generated

build.gradle.kts

@@ -0,0 +1,64 @@
+import org.openapitools.generator.gradle.plugin.tasks.GenerateTask
+import kotlin.io.path.listDirectoryEntries
+import kotlin.io.path.name
+import kotlin.io.path.Path as KotlinPath
+
+plugins {
+    alias(libs.plugins.openapi.generator) apply true
+}
+
+val openApiVersion: String = System.getenv("ODM_OPENAPI_VERSION")
+val openApiSpecPath = "$rootDir/openapi/default"
+val fileNameList = KotlinPath(openApiSpecPath).listDirectoryEntries("*.yaml")
+val tasksList = fileNameList
+        .map { it.name.replace(".yaml", "") }
+
+fun String.camelToKebabCase(): String {
+    val pattern = "(?<=.)[A-Z]".toRegex()
+    return this.replace(pattern, "-$0").lowercase()
+}
+
+fun String.camelToSnakeCase(): String {
+    val pattern = "(?<=.)[A-Z]".toRegex()
+    return this.replace(pattern, "_$0").lowercase()
+}
+
+fun String.kebabToCamelCase(): String {
+    val pattern = "(-)([a-z])".toRegex()
+    return this.replace(pattern) { it.groupValues[2].uppercase() }
+}
+
+
+tasks {
+    for (task in tasksList) {
+        register(task + "Python", GenerateTask::class) {
+            generatorName.set("python")
+            inputSpec.set("$rootDir/openapi/default/$task.yaml")
+            outputDir.set("$rootDir/generated/python/${task.camelToKebabCase()}")
+            packageName.set(task.camelToSnakeCase())
+            gitUserId.set("genestack")
+            gitRepoId.set("odm-openapi")
+            configOptions = mapOf(
+                    "packageVersion" to openApiVersion
+            )
+            skipValidateSpec = true
+        }
+        register(task + "R", GenerateTask::class) {
+            generatorName.set("r")
+            inputSpec.set("$rootDir/openapi/default/$task.yaml")
+            outputDir.set("$rootDir/generated/r/${task.kebabToCamelCase()}")
+            packageName.set(task.kebabToCamelCase())
+            gitUserId.set("genestack")
+            gitRepoId.set("odm-openapi")
+            configOptions = mapOf(
+                    "packageVersion" to openApiVersion
+            )
+            skipValidateSpec = true
+        }
+
+    }
+
+    val generateAllApiClients by registering(GradleBuild::class) {
+        tasks = tasksList.flatMap { listOf(it + "Python", it + "R") }
+    }
+}