feat(workers): Introduce a generator for Gradle's init.gradle.kts file

Introduce the `GradleInitGenerator`, which generates an `init.gradle.kts`
file inside the `$HOME/.gradle` directory. The generator currently creates
an empty file, but upcoming commits will use the dedicated
`GradleDefinition` class to populate it with environment definitions.

Signed-off-by: Onur Demirci <[email protected]>

Author: bs-ondem

workers/common/src/main/kotlin/common/env/EnvironmentModule.kt

@@ -53,6 +53,7 @@ fun buildEnvironmentModule(): Module = module {
                 ConanGenerator(),
                 GitConfigGenerator.create(get()),
                 GitCredentialsGenerator(),
+                GradleInitGenerator(),
                 MavenSettingsGenerator(),
                 NpmRcGenerator(),
                 NuGetGenerator(),

workers/common/src/main/kotlin/common/env/GradleInitGenerator.kt

@@ -0,0 +1,39 @@
+/*
+ * Copyright (C) 2025 The ORT Server Authors (See <https://github.com/eclipse-apoapsis/ort-server/blob/main/NOTICE>)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * License-Filename: LICENSE
+ */
+
+package org.eclipse.apoapsis.ortserver.workers.common.env
+
+import org.eclipse.apoapsis.ortserver.workers.common.env.definition.GradleDefinition
+
+/**
+ * A specialized generator class to generate the content of the _init.gradle.kts_ file.
+ *
+ * See https://docs.gradle.org/current/userguide/init_scripts.html.
+ */
+class GradleInitGenerator : EnvironmentConfigGenerator<GradleDefinition> {
+    companion object {
+        /** The name of the file that is generated by this generator. */
+        private const val TARGET_NAME = ".gradle/init.gradle.kts"
+    }
+    override val environmentDefinitionType: Class<GradleDefinition> = GradleDefinition::class.java
+
+    override suspend fun generate(builder: ConfigFileBuilder, definitions: Collection<GradleDefinition>) {
+        builder.buildInUserHome(TARGET_NAME) {}
+    }
+}

workers/common/src/main/kotlin/common/env/definition/GradleDefinition.kt

@@ -0,0 +1,34 @@
+/*
+ * Copyright (C) 2025 The ORT Server Authors (See <https://github.com/eclipse-apoapsis/ort-server/blob/main/NOTICE>)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * License-Filename: LICENSE
+ */
+
+package org.eclipse.apoapsis.ortserver.workers.common.env.definition
+
+import org.eclipse.apoapsis.ortserver.model.CredentialsType
+import org.eclipse.apoapsis.ortserver.model.InfrastructureService
+
+/**
+ * A specific [EnvironmentServiceDefinition] class for generating the Gradle _init.gradle.kts_ file.
+ *
+ * This class is used to define the Gradle-specific configuration for an [InfrastructureService].
+ */
+class GradleDefinition(
+    service: InfrastructureService,
+
+    credentialsTypes: Set<CredentialsType>?,
+) : EnvironmentServiceDefinition(service, credentialsTypes)

workers/common/src/test/kotlin/common/env/GradleInitGeneratorTest.kt

@@ -0,0 +1,45 @@
+/*
+ * Copyright (C) 2025 The ORT Server Authors (See <https://github.com/eclipse-apoapsis/ort-server/blob/main/NOTICE>)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * License-Filename: LICENSE
+ */
+
+package org.eclipse.apoapsis.ortserver.workers.common.env
+
+import io.kotest.core.spec.style.WordSpec
+import io.kotest.matchers.shouldBe
+
+import org.eclipse.apoapsis.ortserver.workers.common.env.definition.GradleDefinition
+
+class GradleInitGeneratorTest : WordSpec({
+    "environmentDefinitionType" should {
+        "return the correct definition class" {
+            val definitionType = GradleInitGenerator().environmentDefinitionType
+
+            definitionType shouldBe GradleDefinition::class.java
+        }
+    }
+
+    "generate" should {
+        "generate the file at the correct location" {
+            val mockBuilder = MockConfigFileBuilder()
+
+            GradleInitGenerator().generate(mockBuilder.builder, emptyList())
+
+            mockBuilder.homeFileName shouldBe ".gradle/init.gradle.kts"
+        }
+    }
+})