Set up publishing to Maven Central (#74)

Closes #53 and implements proper signing.

---

#53

Currently, the library is "deployed" to JitPack. Maven Central was
already a desire, but JitPack is actually breaking test fixtures variant
in the library's Gradle Module Metadata. As a result, no one can consume
the fixtures artifact.

-
https://jitpack.io/com/github/gabrielfeo/gradle-enterprise-api-kotlin/0.16.0-beta/gradle-enterprise-api-kotlin-0.16.0-beta.module
-
https://gradle-community.slack.com/archives/CAHSN3LDN/p1683828623398169

Author: gabrielfeo

.github/actions/build/action.yml

@@ -10,6 +10,10 @@ inputs:
   path-to-upload:
     description: "Path to upload as artifact"
     required: false
+  dry-run:
+    description: "Whether to --dry-run"
+    type: boolean
+    default: false
 runs:
   using: "composite"
   steps:
@@ -20,12 +24,18 @@ runs:
         java-version: 8
     - name: Validate Gradle wrapper JAR
       uses: gradle/[email protected]
-    - name: Run Gradle
+    - name: Set up Gradle
       uses: gradle/[email protected]
-      with:
-        arguments: ${{ inputs.args }}
+    - name: Run Gradle
+      shell: bash
+      run: |
+        if [[ "${{ inputs.dry-run }}" == "true" ]]; then
+          gradle --dry-run ${{ inputs.args }}
+        else
+          gradle ${{ inputs.args }}
+        fi
     - name: Upload
-      if: ${{ inputs.path-to-upload }}
+      if: ${{ inputs.path-to-upload && !inputs.dry-run }}
       uses: actions/[email protected]
       with:
         name: ${{ inputs.artifact-name }}

.github/workflows/pr.yml

@@ -79,6 +79,11 @@ jobs:
     with:
       dry_run: true
 
+  dry-run-publish-library:
+    uses: ./.github/workflows/publish-library.yml
+    with:
+      dry_run: true
+
   dry-run-update-api-spec:
     uses: ./.github/workflows/update-api-spec.yml
     with:

.github/workflows/publish-library.yml

@@ -0,0 +1,47 @@
+name: 'Publish library to Central'
+
+on:
+  push:
+    tags: ['*']
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Dry run'
+        type: boolean
+        required: false
+  workflow_call:
+    inputs:
+      dry_run:
+        description: 'Dry run'
+        type: boolean
+        required: true
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+
+  build-and-publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: gradle publishLibraryPublicationToMavenCentralRepository
+        uses: ./.github/actions/build
+        with:
+          dry-run: ${{ inputs.dry_run }}
+          args: >-
+            publishLibraryPublicationToMavenCentralRepository
+            --rerun-tasks
+            '-Pversion=${{ github.ref_name }}'
+            '-Pmaven.central.username=${{ secrets.MAVEN_CENTRAL_USERNAME }}'
+            '-Pmaven.central.password=${{ secrets.MAVEN_CENTRAL_PASSWORD }}'
+            '-Psigning.password=${{ secrets.GPG_PASSWORD }}'
+            '-Psigning.secretKey=${{ secrets.GPG_SECRET_KEY }}'
+          artifact-name: 'outputs'
+          path-to-upload: |
+            library/build/*-api.yaml
+            library/build/generated/open-api-generator/**/*
+            library/build/publications/**/*
+            library/build/libs/**/*

gradle.properties

@@ -3,5 +3,5 @@ org.gradle.caching=true
 version=SNAPSHOT
 # Must be later than 2022.1
 gradle.enterprise.version=2022.4
-group=com.github.gabrielfeo
+group=com.gabrielfeo
 artifact=gradle-enterprise-api-kotlin

library/build.gradle.kts

@@ -11,6 +11,7 @@ plugins {
     `java-library`
     `java-test-fixtures`
     `maven-publish`
+    `signing`
 }
 
 val repoUrl = "https://github.com/gabrielfeo/gradle-enterprise-api-kotlin"
@@ -172,15 +173,6 @@ tasks.named<Jar>("javadocJar") {
     from(tasks.dokkaHtml)
 }
 
-publishing {
-    publications {
-        create<MavenPublication>("library") {
-            artifactId = "gradle-enterprise-api-kotlin"
-            from(components["java"])
-        }
-    }
-}
-
 testing {
     suites {
         getByName<JvmTestSuite>("test") {
@@ -192,7 +184,6 @@ testing {
         }
         register<JvmTestSuite>("integrationTest") {
             dependencies {
-//                implementation(project())
                 implementation("org.jetbrains.kotlinx:kotlinx-coroutines-test:1.7.1")
             }
         }
@@ -229,3 +220,65 @@ dependencies {
     implementation("com.squareup.retrofit2:converter-scalars:2.9.0")
     api("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.1")
 }
+
+publishing {
+    publications {
+        create<MavenPublication>("library") {
+            artifactId = "gradle-enterprise-api-kotlin"
+            from(components["java"])
+            pom {
+                name.set("Gradle Enterprise API Kotlin")
+                description.set("A library to use the Gradle Enterprise REST API in Kotlin")
+                url.set("https://github.com/gabrielfeo/gradle-enterprise-api-kotlin")
+                licenses {
+                    license {
+                        name.set("MIT")
+                        url.set("https://spdx.org/licenses/MIT.html")
+                        distribution.set("repo")
+                    }
+                }
+                developers {
+                    developer {
+                        id.set("gabrielfeo")
+                        name.set("Gabriel Feo")
+                        email.set("[email protected]")
+                    }
+                }
+                scm {
+                    val basicUrl = "github.com/gabrielfeo/gradle-enterprise-api-kotlin"
+                    connection.set("scm:git:git://$basicUrl.git")
+                    developerConnection.set("scm:git:ssh://$basicUrl.git")
+                    url.set("https://$basicUrl/")
+                }
+            }
+        }
+    }
+    repositories {
+        maven {
+            name = "mavenCentral"
+            val releasesRepoUrl = uri("https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/")
+            val snapshotsRepoUrl = uri("https://s01.oss.sonatype.org/content/repositories/snapshots/")
+            val isSnapshot = version.toString().endsWith("SNAPSHOT")
+            url = if (isSnapshot) snapshotsRepoUrl else releasesRepoUrl
+            authentication {
+                register<BasicAuthentication>("basic")
+            }
+            credentials {
+                username = project.properties["maven.central.username"] as String?
+                password = project.properties["maven.central.password"] as String?
+            }
+        }
+    }
+}
+
+fun isCI() = System.getenv("CI").toBoolean()
+
+signing {
+    sign(publishing.publications["library"])
+    if (isCI()) {
+        useInMemoryPgpKeys(
+            project.properties["signing.secretKey"] as String?,
+            project.properties["signing.password"] as String?,
+        )
+    }
+}