ci: publish flow maintenance (#227)

Bring in line with other clj-commons projects by triggering build on
git release tag (instead of GitHub UI).

Borrow work from clj-commons/pomegranate, where I most recently did
this work. This includes:
- consolidation of shared setup to composite actions.
- using neil to store/bump lib version
- automatically including date in changelog release headers 
(manually back-filled existing)
- changelog now using [breaking] and [minor breaking] attributes for
release headers
- adding a link to changelog from GitHub release

Tweaks from pomegranate included:
- github-coords is different from release artifact name
- our default branch here is main, not master
- changelog release headers are level 3 here (as opposed to level 2)

Also:
- turfed whitespace linting, do not want to maintain/review

I'm pretty sure there will be typos and config errors to correct.
There are some GitHub Actions YAMLisms I am not entirely sure will 
work.

Tip to lurkers: The VSCode Red Hat YAML extension offers some 
pretty nice linting and has special validations for GitHub actions YAML.

Close #222

Author: lread

.github/workflows/code-coverage.yml

@@ -10,53 +10,24 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
-
-    - name: Clojure deps cache
-      uses: actions/cache@v3
-      with:
-        path: |
-          ~/.m2/repository
-          ~/.gitlibs
-        key: ${{ runner.os }}-cljdeps-${{ hashFiles('deps.edn') }}
-        restore-keys: ${{ runner.os }}-cljdeps-
-
-    - name: Setup Java
-      uses: actions/setup-java@v3
-      with:
-        distribution: 'temurin'
-        java-version: '11'
-
-    - name: Install Clojure tools
-      uses: DeLaGuardo/[email protected]
-      with:
-        cli: 'latest'
-        bb: 'latest'
-
-    - name: Tools versions
-      run: |
-        echo "bb --version"
-        bb --version
-        echo "java -version"
-        java -version
-        echo "clojure -Sdescribe"
-        clojure -Sdescribe
-
-    - name: Download clojure dependencies
-      run: clojure -Spath
-
-    - name: Run Tests with Code Coverage
-      run: bb test-coverage
-
-    - name: Upload Code Coverage Results
-      run: |
-        echo "Downloading codecov uploader script"
-        curl -s https://codecov.io/bash > codecov
-        echo "Verifying codedov uploader script"
-        VERSION=$(grep 'VERSION=\".*\"' codecov | cut -d'"' -f2);
-        for i in 1 256 512
-        do
-          sha${i}sum -c --ignore-missing <(curl -s "https://raw.githubusercontent.com/codecov/codecov-bash/${VERSION}/SHA${i}SUM")
-        done
-        echo "Uploading to codecov"
-        bash codecov -f target/coverage/codecov.json
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Setup
+        uses: ./.github/workflows/shared-setup
+
+      - name: Run Tests with Code Coverage
+        run: bb test-coverage
+
+      - name: Upload Code Coverage Results
+        run: |
+          echo "Downloading codecov uploader script"
+          curl -s https://codecov.io/bash > codecov
+          echo "Verifying codedov uploader script"
+          VERSION=$(grep 'VERSION=\".*\"' codecov | cut -d'"' -f2);
+          for i in 1 256 512
+          do
+            sha${i}sum -c --ignore-missing <(curl -s "https://raw.githubusercontent.com/codecov/codecov-bash/${VERSION}/SHA${i}SUM")
+          done
+          echo "Uploading to codecov"
+          bash codecov -f target/coverage/codecov.json

.github/workflows/libs-test.yml

@@ -16,28 +16,16 @@ jobs:
       libs: ${{ steps.set-libs.outputs.libs }}
 
     steps:
-    - uses: actions/checkout@v3
+      - name: Checkout
+        uses: actions/checkout@v3
 
-    - name: Clojure deps cache
-      uses: actions/cache@v3
-      with:
-        path: |
-          ~/.m2/repository
-          ~/.gitlibs
-        # base cache on libs_test.clj script for now... lib deps are embedded in it
-        key: ${{ runner.os }}-clj-libs-deps-${{ hashFiles('script/test_libs.clj') }}
-        restore-keys: ${{ runner.os }}-clj-libs-deps-
+      - name: Setup
+        uses: ./.github/workflows/shared-setup
 
-    - name: Install Clojure tools
-      uses: DeLaGuardo/[email protected]
-      with:
-        cli: 'latest'
-        bb: 'latest'
-
-    - id: set-libs
-      name: Set libs var for matrix
-      ## call bb script directly instead of as task to avoid task status output
-      run: echo "libs=$(bb script/test_libs.clj list --format=json)" >> $GITHUB_OUTPUT
+      - id: set-libs
+        name: Set libs var for matrix
+        ## call bb script directly instead of as task to avoid task status output
+        run: echo "libs=$(bb script/test_libs.clj list --format=json)" >> $GITHUB_OUTPUT
 
   libs-test:
     needs: enumerate-libs
@@ -48,56 +36,19 @@ jobs:
         lib: ${{ fromJSON(needs.enumerate-libs.outputs.libs) }}
 
     steps:
-    - uses: actions/checkout@v3
-      with:
-        fetch-depth: 0
-
-    - name: Clojure deps cache
-      uses: actions/cache@v3
-      with:
-        path: |
-          ~/.m2/repository
-          ~/.gitlibs
-        # base cache on libs_test.clj script for now... lib deps are embedded in it
-        key: ${{ runner.os }}-clj-libs-deps-${{ hashFiles('script/test_libs.clj') }}
-        restore-keys: ${{ runner.os }}-clj-libs-deps-
-
-    - name: Setup Java
-      uses: actions/setup-java@v3
-      with:
-        distribution: 'temurin'
-        java-version: '11'
-
-    - name: Install planck
-      run: |
-        # There are not planck binaries for jammy yet, so hack-around to use focal release
-        sudo add-apt-repository -y "deb http://cz.archive.ubuntu.com/ubuntu focal main universe"
-        sudo add-apt-repository -y "deb http://security.ubuntu.com/ubuntu focal-security main"
-
-        # is missing after installing planck so compensate
-        DEBIAN_FRONTEND=noninteractive sudo apt-get install -y libicu66
-
-        wget https://launchpad.net/~mfikes/+archive/ubuntu/planck/+files/planck_2.25.0-1ppa1~focal1_amd64.deb
-        sudo apt-get install ./planck_2.25.0-1ppa1~focal1_amd64.deb
-
-    - name: Install Clojure tools
-      uses: DeLaGuardo/[email protected]
-      with:
-        cli: 'latest'
-        bb: 'latest'
-
-    - name: Tools versions
-      run: |
-        echo "bb --version"
-        bb --version
-        echo "java -version"
-        java -version
-        echo "clojure -Sdescribe"
-        clojure -Sdescribe
-        echo "lein --version"
-        lein --version
-        echo "planck --version"
-        planck --version
-
-    - name: Run Libs Tests
-      run: bb test-libs run ${{ matrix.lib }}
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Setup
+        uses: ./.github/workflows/shared-setup
+        with:
+          clj-cache-prefix: clj-libs-deps-${{ matrix.lib }}
+          clj-cache-hash-files: "'script/test_libs.clj','deps.edn','bb.edn'"
+
+      - name: Install planck
+        uses: ./.github/workflows/setup-planck
+
+      - name: Run Libs Tests
+        run: bb test-libs run ${{ matrix.lib }}

.github/workflows/native-image-test.yml

@@ -22,76 +22,24 @@ jobs:
     name: ${{ matrix.os }},jdk ${{ matrix.graal-java }},${{ matrix.test }},clj ${{ matrix.clojure-version }}
 
     steps:
-    - uses: actions/checkout@v3
-
-    #
-    # Caches
-    #
-    - name: Clojure deps cache
-      uses: actions/cache@v3
-      with:
-        path: |
-          ~/.m2/repository
-          ~/.gitlibs
-        key: ${{ runner.os }}-cljdeps-${{ hashFiles('deps.edn') }}
-        restore-keys: ${{ runner.os }}-cljdeps-
-
-    #
-    # Install GraalVM
-    #
-    - name: Install GraalVM
-      uses: graalvm/setup-graalvm@v1
-      with:
-        version: '22.3.1'
-        java-version: ${{ matrix.graal-java }}
-        components: 'native-image'
-        github-token: ${{ secrets.GITHUB_TOKEN }}
-
-    #
-    # Install Babashka
-    #
-    - name: Install Babashka
-      uses: DeLaGuardo/[email protected]
-      with:
-        bb: 'latest'
-
-    #
-    # Install Clojure
-    #
-    - name: Install clojure (windows)
-      # On windows, deps.clj's deps.exe is used in place of clojure to avoid complexities of official clojure install
-      run: |
-       PowerShell -Command "iwr -useb https://raw.githubusercontent.com/borkdude/deps.clj/master/install.ps1 | iex"
-       Rename-Item $HOME\deps.clj\deps.exe clojure.exe
-       echo "$HOME\deps.clj" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
-      if: matrix.os == 'windows'
-
-    - name: Install Clojure (macos, linux)
-      uses: DeLaGuardo/[email protected]
-      with:
-        cli: 'latest'
-      if: matrix.os != 'windows'
-
-    #
-    # Summarize installs
-    #
-    - name: Tools versions
-      run: |
-        echo "bb --version"
-        bb --version
-        echo "java -version"
-        java -version
-        echo "clojure -Sdescribe"
-        clojure -Sdescribe
-
-    #
-    # Prep Clojure
-    #
-    - name: Download clojure dependencies
-      run: clojure -Spath
-
-    #
-    # native image tests
-    #
-    - name: Execute ${{ matrix.test }} native test
-      run: bb ${{ matrix.test }} --clojure-version ${{ matrix.clojure-version }}
+      - name: Checkout
+        uses: actions/checkout@v3
+        
+      - name: Setup
+        uses: ./.github/workflows/shared-setup
+        with:
+          jdk: skip
+
+      - name: Install GraalVM
+        uses: graalvm/setup-graalvm@v1
+        with:
+          version: '22.3.1'
+          java-version: ${{ matrix.graal-java }}
+          components: 'native-image'
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+
+      #
+      # native image tests
+      #
+      - name: Execute ${{ matrix.test }}
+        run: bb ${{ matrix.test }} --clojure-version ${{ matrix.clojure-version }}

.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish
+on:
+  push:
+    tags:
+      - 'v\d+.*'
+
+jobs:
+  unit-test:
+    uses: ./.github/workflows/unit-test.yml
+  native-image-test:
+    uses: ./.github/workflows/native-image-test.yml
+  libs-test:
+    uses: ./.github/workflows/libs-test.yml
+
+  publish:
+    environment: publish
+    runs-on: ubuntu-latest
+    needs: [unit-test, native-image-test, libs-test]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Setup
+      uses: ./.github/workflows/shared-setup
+
+    - name: Deploy to clojars
+      env:
+        CLOJARS_USERNAME: ${{ secrets.CLOJARS_USERNAME }}
+        CLOJARS_PASSWORD: ${{ secrets.CLOJARS_PASSWORD }}
+      run: bb -ci-clojars-deploy
+
+    - name: Create GitHub Release
+      env:
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: bb -ci-github-create-release
+
+    - name: Inform Cljdoc
+      run: bb -ci-cljdoc-request-build