Added build cache and develocity plugin (#192)

Author: Mr3zee

.gitignore

@@ -32,3 +32,5 @@ detekt/reports/**
 
 # Ignore kover reports
 /kover
+
+scan-journal.log

compiler-plugin/settings.gradle.kts

@@ -13,6 +13,7 @@ pluginManagement {
 
 plugins {
     id("settings-conventions")
+    id("conventions-develocity")
 }
 
 includeRootAsPublic()

docs/develocity.md

@@ -0,0 +1,27 @@
+# Develocity usage guide
+
+> [!NOTE]
+> Build scans and remote build cache are for JetBrains developers only.
+>
+> To disable publishing attempts, add `kotlinx.rpc.develocity.skipBuildScans=true` property
+to your `~/.gradle/gradle.properties` file
+
+Develocity is configured for this project.
+That means that you can use both [build scans](https://docs.gradle.org/current/userguide/build_scans.html)
+and remote [build cache](https://docs.gradle.org/current/userguide/build_cache.html)
+features.
+
+To use build scans, first you need to log in here: https://ge.jetbrains.com.
+You can do that directly in Gradle:
+
+```Bash
+./gradlew :provisionDevelocityAccessKey
+```
+
+Sing in with your Google work account, and that is it.
+Now your scans will automatically be published after each build, and
+Gradle will read the remote build caches so that your local build may be faster.
+
+This also allows you to check various metrics about your scans (https://ge.jetbrains.com).
+
+Build scan logs are collected locally in the `scan-journal.log` file.

gradle-conventions-settings/develocity/build.gradle.kts

@@ -0,0 +1,26 @@
+/*
+ * Copyright 2023-2024 JetBrains s.r.o and contributors. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+plugins {
+    alias(libs.plugins.gradle.kotlin.dsl)
+}
+
+configurations.configureEach {
+    resolutionStrategy {
+        force(libs.kotlin.reflect)
+        force(libs.kotlin.stdlib)
+        force(libs.kotlin.stdlib.jdk7)
+        force(libs.kotlin.stdlib.jdk8)
+    }
+}
+
+repositories {
+    mavenCentral()
+    gradlePluginPortal()
+}
+
+dependencies {
+    implementation("com.gradle:develocity-gradle-plugin:3.17")
+    implementation("com.gradle:common-custom-user-data-gradle-plugin:2.0.1")
+}

gradle-conventions-settings/develocity/src/main/kotlin/conventions-develocity.settings.gradle.kts

@@ -0,0 +1,56 @@
+/*
+ * Copyright 2023-2024 JetBrains s.r.o and contributors. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+import java.util.*
+
+plugins {
+    id("com.gradle.develocity")
+    id("com.gradle.common-custom-user-data-gradle-plugin")
+}
+
+develocity {
+    val startParameter = gradle.startParameter
+    val scanJournal = File(settingsDir, "scan-journal.log")
+
+    server = DEVELOCITY_SERVER
+
+    buildScan {
+        uploadInBackground = !isCIRun
+
+        // obfuscate NIC since we don't want to expose user real IP (will be relevant without VPN)
+        obfuscation {
+            ipAddresses { addresses -> addresses.map { _ -> "0.0.0.0" } }
+        }
+
+        capture {
+            fileFingerprints = true
+        }
+
+        buildScanPublished {
+            scanJournal.appendText("${Date()} — $buildScanUri — $startParameter\n")
+        }
+
+        val skipBuildScans = settings.providers.gradleProperty("kotlinx.rpc.develocity.skipBuildScans")
+            .getOrElse("false")
+            .toBooleanStrict()
+
+        publishing.onlyIf { !skipBuildScans }
+    }
+}
+
+buildCache {
+    if (isCIRun) {
+        local {
+            isEnabled = false
+        }
+    }
+
+    remote(develocity.buildCache) {
+        isPush = isCIRun
+        isEnabled = true
+    }
+}
+
+enrichTeamCityData()
+enrichGitData()

gradle-conventions-settings/develocity/src/main/kotlin/customization.kt

@@ -0,0 +1,64 @@
+/*
+ * Copyright 2023-2024 JetBrains s.r.o and contributors. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+import com.gradle.develocity.agent.gradle.DevelocityConfiguration
+import org.gradle.api.initialization.Settings
+
+fun Settings.enrichTeamCityData() {
+    val ge = extensions.getByType(DevelocityConfiguration::class.java)
+
+    gradle.projectsEvaluated {
+        if (isCIRun) {
+            val buildTypeId = "teamcity.buildType.id"
+            val buildId = "teamcity.build.id"
+
+            if (gradle.rootProject.hasProperty(buildId) && gradle.rootProject.hasProperty(buildTypeId)) {
+                val buildIdValue = gradle.rootProject.property(buildId).toString()
+                val teamCityBuildNumber = java.net.URLEncoder.encode(buildIdValue, Charsets.UTF_8)
+                val teamCityBuildTypeId = gradle.rootProject.property(buildTypeId)
+
+                ge.buildScan.link(
+                    "kotlinx.rpc TeamCity build",
+                    "${TEAMCITY_URL}/buildConfiguration/${teamCityBuildTypeId}/${teamCityBuildNumber}"
+                )
+            }
+
+            if (gradle.rootProject.hasProperty(buildId)) {
+                ge.buildScan.value("CI build id", gradle.rootProject.property(buildId) as String)
+            }
+        }
+    }
+}
+
+fun Settings.enrichGitData() {
+    val ge = extensions.getByType(DevelocityConfiguration::class.java)
+
+    gradle.projectsEvaluated {
+        val skipGitTags = settings.providers.gradleProperty("kotlinx.rpc.develocity.skipGitTags")
+            .getOrElse("false")
+            .toBooleanStrict()
+
+        if (!isCIRun && !skipGitTags) {
+            // Git commit id
+            val commitId = execute("git rev-parse --verify HEAD")
+            if (commitId.isNotEmpty()) {
+                ge.buildScan.value("Git Commit ID", commitId)
+                ge.buildScan.link("GitHub Commit Link", "$GITHUB_REPO/tree/$commitId")
+            }
+
+            // Git branch name
+            val branchName = execute("git rev-parse --abbrev-ref HEAD")
+            if (branchName.isNotEmpty()) {
+                ge.buildScan.value("Git Branch Name", branchName)
+                ge.buildScan.link("GitHub Branch Link", "$GITHUB_REPO/tree/$branchName")
+            }
+
+            // Git dirty local state
+            val status = execute("git status --porcelain")
+            if (status.isNotEmpty()) {
+                ge.buildScan.value("Git Status", status)
+            }
+        }
+    }
+}

gradle-conventions-settings/develocity/src/main/kotlin/execute.kt

@@ -0,0 +1,12 @@
+/*
+ * Copyright 2023-2024 JetBrains s.r.o and contributors. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+import org.gradle.api.initialization.Settings
+
+@Suppress("UnstableApiUsage")
+fun Settings.execute(cmd: String): String {
+    return settings.providers.exec {
+        commandLine(cmd.split(" "))
+    }.standardOutput.asText.get().trim()
+}

gradle-conventions-settings/develocity/src/main/kotlin/params.kt

@@ -0,0 +1,9 @@
+/*
+ * Copyright 2023-2024 JetBrains s.r.o and contributors. Use of this source code is governed by the Apache 2.0 license.
+ */
+
+const val DEVELOCITY_SERVER = "https://ge.jetbrains.com"
+const val GITHUB_REPO = "https://github.com/Kotlin/kotlinx-rpc"
+const val TEAMCITY_URL = "https://krpc.teamcity.com"
+
+val isCIRun = System.getenv("TEAMCITY_VERSION") != null

gradle-conventions-settings/settings.gradle.kts

@@ -6,3 +6,5 @@ rootProject.name = "gradle-conventions-settings"
 
 // Code below is a hack because a chicken-egg problem, I can't use myself as a settings-plugin
 apply(from = "src/main/kotlin/settings-conventions.settings.gradle.kts")
+
+include(":develocity")

gradle.properties

@@ -38,3 +38,11 @@ systemProp.org.gradle.kotlin.dsl.precompiled.accessors.strict=true
 # Using compileOnly dependencies in these targets is not currently supported
 # because compileOnly dependencies must be present during the compilation of projects that depend on this project.
 kotlin.suppressGradlePluginWarnings=IncorrectCompileOnlyDependencyWarning
+
+# Uncomment to skip attempts to publish Develocity build scans
+# Add this property to ~/.gradle/gradle.properties to avoid polluting git with unwanted changes
+#kotlinx.rpc.develocity.skipBuildScans=true
+
+# Uncomment to skip adding git tags to Develocity build scan
+# Add this property to ~/.gradle/gradle.properties to avoid polluting git with unwanted changes
+#kotlinx.rpc.develocity.skipGitTags=true