Parallelize tasks within same project (#482)

Allow tasks within the `library` project to run parallel to each other
by enabling CC. This reduces the execution time of `check` builds by
allowing work units of the 3 test suites to run parallel. Migration to
Dokka v2 is required for CC compatibility. `downloadApiSpec` is made
CC-compatible. `localSpecPath` is removed as a `file://` URI could
easily be used with `remoteSpecUrl`.

PR jobs are fixed for signing key-related error in
`dry-run-publish-library`, probably caused by the new publishing plugin
(#479) trying to read it at configuration time.

```
* What went wrong:
Could not read PGP secret key
> secret key ring doesn't start with secret key tag: tag 0xffffffff
```

([job][1])

#### References

- https://www.liutikas.net/2025/07/29/Parallel-Bits.html

[1]:
https://github.com/gabrielfeo/develocity-api-kotlin/actions/runs/17633648327/job/50106146533

Author: gabrielfeo

.github/workflows/pr.yml

@@ -39,11 +39,13 @@ jobs:
     uses: ./.github/workflows/publish-javadoc.yml
     with:
       dry_run: true
+    secrets: inherit
 
   dry-run-publish-library:
     uses: ./.github/workflows/publish-library.yml
     with:
       dry_run: true
+    secrets: inherit
 
   dry-run-update-api-spec:
     uses: ./.github/workflows/update-api-spec.yml

.github/workflows/publish-javadoc.yml

@@ -31,7 +31,7 @@ jobs:
         uses: ./.github/actions/build
         with:
           args: >-
-            dokkaHtml
+            dokkaGenerate
             '-Pversion=${{ github.ref_name }}'
           artifact-name: 'docs'
           path-to-upload: "library/build/dokka/html/**/*"

build-logic/gradle.properties

@@ -1 +1,3 @@
 kotlin.daemon.jvmargs=-Xmx1g
+org.gradle.configuration-cache=true
+org.gradle.configuration-cache.parallel=true

build-logic/src/main/kotlin/com/gabrielfeo/develocity-api-code-generation.gradle.kts

@@ -8,20 +8,17 @@ plugins {
     id("org.openapi.generator")
 }
 
-val localSpecPath = providers.gradleProperty("localSpecPath")
-val remoteSpecUrl = providers.gradleProperty("remoteSpecUrl").orElse(
-    providers.gradleProperty("develocity.version").map { geVersion ->
-        val majorVersion = geVersion.substringBefore('.').toInt()
-        val specName = when {
-            majorVersion <= 2023 -> "gradle-enterprise-$geVersion-api.yaml"
-            else -> "develocity-$geVersion-api.yaml"
-        }
-        "https://docs.gradle.com/enterprise/api-manual/ref/$specName"
-    }
-)
-
 val downloadApiSpec by tasks.registering {
-    onlyIf { !localSpecPath.isPresent() }
+    val remoteSpecUrl = providers.gradleProperty("remoteSpecUrl").orElse(
+        providers.gradleProperty("develocity.version").map { geVersion ->
+            val majorVersion = geVersion.substringBefore('.').toInt()
+            val specName = when {
+                majorVersion <= 2023 -> "gradle-enterprise-$geVersion-api.yaml"
+                else -> "develocity-$geVersion-api.yaml"
+            }
+            "https://docs.gradle.com/enterprise/api-manual/ref/$specName"
+        }
+    )
     val spec = resources.text.fromUri(remoteSpecUrl)
     val specName = remoteSpecUrl.map { it.substringAfterLast('/') }
     val outFile = project.layout.buildDirectory.file(specName)
@@ -35,11 +32,7 @@ val downloadApiSpec by tasks.registering {
 
 openApiGenerate {
     generatorName = "kotlin"
-    val spec = when {
-        localSpecPath.isPresent() -> localSpecPath.map { rootProject.file(it).absolutePath }
-        else -> downloadApiSpec.map { it.outputs.files.first().absolutePath }
-    }
-    inputSpec = spec
+    inputSpec = downloadApiSpec.map { it.outputs.files.first().absolutePath }
     val generateDir = project.layout.buildDirectory.dir("generated-api")
         .map { it.asFile.absolutePath }
     outputDir = generateDir

build-logic/src/main/kotlin/com/gabrielfeo/published-kotlin-jvm-library.gradle.kts

@@ -1,8 +1,8 @@
 package com.gabrielfeo
 
-import org.jetbrains.dokka.DokkaConfiguration.Visibility.PUBLIC
-import org.jetbrains.dokka.gradle.DokkaTask
-import java.net.URL
+import org.jetbrains.dokka.gradle.DokkaExtension
+import org.jetbrains.dokka.gradle.engine.parameters.VisibilityModifier
+import java.net.URI
 
 plugins {
     id("com.gabrielfeo.kotlin-jvm-library")
@@ -19,33 +19,44 @@ java {
     withJavadocJar()
 }
 
-val kotlinSourceRoot = file("src/main/kotlin")
-tasks.withType<DokkaTask>().configureEach {
-    dokkaSourceSets.all {
-        sourceRoot(kotlinSourceRoot)
+
+configure<DokkaExtension> {
+    val kotlinSourceRoot = file("src/main/kotlin")
+    val repoUrlSuffix = "/blob/$version/${kotlinSourceRoot.relativeTo(rootDir)}"
+    val repoUrl = providers.gradleProperty("repo.url")
+        .map { URI("$it$repoUrlSuffix").toString() }
+    dokkaSourceSets.configureEach {
+        sourceRoots.from(kotlinSourceRoot)
         sourceLink {
             localDirectory.set(kotlinSourceRoot)
-            remoteUrl = providers.gradleProperty("repo.url")
-                .map { URL("$it/blob/$version/${kotlinSourceRoot.relativeTo(rootDir)}") }
+            remoteUrl(repoUrl)
             remoteLineSuffix = "#L"
         }
         jdkVersion = java.toolchain.languageVersion.map { it.asInt() }
+        documentedVisibilities.add(VisibilityModifier.Public)
         suppressGeneratedFiles = false
-        documentedVisibilities = setOf(PUBLIC)
         perPackageOption {
             matchingRegex = """.*\.internal.*"""
             suppress = true
         }
-        externalDocumentationLink("https://kotlinlang.org/api/kotlinx.coroutines/")
-        externalDocumentationLink("https://square.github.io/okhttp/5.x/okhttp/")
-        externalDocumentationLink("https://square.github.io/retrofit/2.x/retrofit/")
-        externalDocumentationLink("https://square.github.io/moshi/1.x/moshi/")
-        externalDocumentationLink("https://square.github.io/moshi/1.x/moshi-kotlin/")
+        listOf(
+            "https://kotlinlang.org/api/kotlinx.coroutines",
+            "https://square.github.io/okhttp/5.x/okhttp",
+            "https://square.github.io/retrofit/2.x/retrofit",
+            "https://square.github.io/moshi/1.x/moshi",
+            "https://square.github.io/moshi/1.x/moshi-kotlin",
+        ).forEach { url ->
+            val name = url.trim('/').substringAfterLast('/')
+            externalDocumentationLinks.register(name) {
+                url(url)
+                packageListUrl("$url/package-list")
+            }
+        }
     }
 }
 
 tasks.named<Jar>("javadocJar") {
-    from(tasks.dokkaHtml)
+    from(tasks.dokkaGenerate)
 }
 
 mavenPublishing {

gradle.properties

@@ -6,9 +6,13 @@ repo.url=https://github.com/gabrielfeo/develocity-api-kotlin
 org.gradle.parallel=true
 org.gradle.jvmargs=-Xmx5g
 org.gradle.caching=true
+org.gradle.configuration-cache=true
+org.gradle.configuration-cache.parallel=true
 # Becomes default in Gradle 9.0
 org.gradle.kotlin.dsl.skipMetadataVersionCheck=false
 # Explicitly added at different versions, due to Kotlin/kotlin-jupyter#462
 kotlin.jupyter.add.api=false
 kotlin.jupyter.add.scanner=false
 kotlin.jupyter.add.testkit=false
+org.jetbrains.dokka.experimental.gradle.pluginMode=V2Enabled
+org.jetbrains.dokka.experimental.gradle.pluginMode.noWarn=true