rc/semantic release

.github/workflows/ci.yml

@@ -2,38 +2,38 @@ name: CI
 
 on:
   pull_request:
-  push:
-    branches: main
 
 jobs:
+  generate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - id: generate
+        uses: freckle/stack-action/generate-matrix@v5
+    outputs:
+      stack-yamls: ${{ steps.generate.outputs.stack-yamls }}
+      fail-fast: false
+
   test:
+    needs: generate
     runs-on: ubuntu-latest
 
     strategy:
       matrix:
-        stack-yaml:
-          - stack-nightly.yaml # ghc-9.6
-          - stack.yaml # ghc-9.4
-          - stack-lts-20.26.yaml # ghc-9.2
-          - stack-lts-19.33.yaml # ghc-9.0
-          - stack-lts-18.28.yaml # ghc-8.10
-          - stack-lts-16.31.yaml # ghc-8.8
-          - stack-lts-14.27.yaml # ghc-8.6
-          - stack-lts-12.26.yaml # ghc-8.4
-          - stack-persistent-2.14.yaml
+        stack-yaml: ${{ fromJSON(needs.generate.outputs.stack-yamls) }}
       fail-fast: false
 
     steps:
       - uses: actions/checkout@v4
-      - uses: freckle/stack-action@v4
+      - uses: freckle/stack-action@v5
         with:
           stack-yaml: ${{ matrix.stack-yaml }}
 
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: rwe/actions-hlint-setup@v1
-      - uses: rwe/actions-hlint-run@v2
+      - uses: actions/checkout@v4
+      - uses: haskell-actions/hlint-setup@v2
+      - uses: haskell-actions/hlint-run@v2
         with:
           fail-on: warning

.github/workflows/release.yml

@@ -2,22 +2,31 @@ name: Release
 
 on:
   push:
-    branches: main
+    branches:
+      - main
+      - rc/*
 
 jobs:
   release:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
 
-      - id: tag
-        uses: freckle/haskell-tag-action@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - id: token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ vars.FRECKLE_AUTOMATION_APP_ID }}
+          private-key: ${{ secrets.FRECKLE_AUTOMATION_PRIVATE_KEY }}
 
-      - if: steps.tag.outputs.tag
-        uses: freckle/stack-upload-action@v2
+      - id: release
+        uses: cycjimmy/semantic-release-action@v4
         with:
-          pvp-bounds: lower
+          extra_plugins: |
+            git+https://github.com/pbrisbin/semantic-release-stack-upload.git
         env:
-          HACKAGE_API_KEY: ${{ secrets.HACKAGE_UPLOAD_API_KEY }}
+          FORCE_COLOR: 1
+          GITHUB_TOKEN: ${{ steps.token.outputs.token }}
+          HACKAGE_KEY: ${{ secrets.HACKAGE_UPLOAD_API_KEY }}
+          STACK_YAML: stack-lts-12.26.yaml

.releaserc.yaml

@@ -0,0 +1,15 @@
+tagFormat: "v2.${version}" # PVP prefixed
+
+plugins:
+  - "@semantic-release/commit-analyzer"
+  - "@semantic-release/release-notes-generator"
+  - - "@semantic-release/github"
+    - successCommentCondition: false
+  - - "semantic-release-stack-upload"
+    - pvpBounds: lower
+      stripSuffix: true
+
+branches:
+  - main
+  - name: rc/*
+    prerelease: '${name.replace(/^rc\//, "rc-")}'

CHANGELOG.md

@@ -1,46 +1 @@
-## [_Unreleased_](https://github.com/freckle/graphula/compare/v2.1.0.0...main)
-
-## [v2.1.0.0](https://github.com/freckle/graphula/compare/v2.0.2.2...v2.1.0.0)
-
-- Some unnecessary `SafeToInsert` have been removed from `node` and `nodeKeyed`.
-  - `node` only requires `SafeToInsert` when the `KeySource` is `SourceDefault`,
-    not when the `KeySource` is `KeyArbitrary`.
-  - `nodeKeyed` no longer ever requires `SafeToInsert`
-- `MonadGraphulaFrontend` has a new `insertKeyed` method.
-
-## [v2.0.2.2](https://github.com/freckle/graphula/compare/v2.0.2.1...v2.0.2.2)
-
-- Add missing MonadUnliftIO instance to GraphulaLoggedT
-
-## [v2.0.2.1](https://github.com/freckle/graphula/compare/v2.0.1.1...v2.0.2.1)
-
-- Support persistent-2.14
-
-## [v2.0.1.1](https://github.com/freckle/graphula/compare/v2.0.0.5...v2.0.1.1)
-
-- Support GHCs 9.0 and 9.2
-
-## [v2.0.1.0](https://github.com/freckle/graphula/compare/v2.0.0.5...v2.0.1.0)
-
-- Add/improve documentation
-- Re-organize previously-internal module
-
-## [v2.0.0.5](https://github.com/freckle/graphula/compare/v2.0.0.4...v2.0.0.5)
-
-- Release without dependencies upper bounds
-
-## [v2.0.0.4](https://github.com/freckle/graphula/compare/v2.0.0.3...v2.0.0.4)
-
-- Relax persistent packages' upper bounds
-
-## [v2.0.0.3](https://github.com/freckle/graphula/compare/v2.0.0.2...v2.0.0.3)
-
-- Relax dependencies upper bounds
-
-## [v2.0.0.2](https://github.com/freckle/graphula/compare/v2.0.0.1...v2.0.0.2)
-
-- Support GHC-8.10 and unliftio-core 2.0.0
-
-## [v2.0.0.1](https://github.com/faktory/graphula/tree/v2.0.0.1)
-
-First tagged release.
+See https://github.com/freckle/graphula/releases

graphula.cabal

@@ -1,11 +1,11 @@
 cabal-version: 1.12
 
--- This file has been generated from package.yaml by hpack version 0.36.0.
+-- This file has been generated from package.yaml by hpack version 0.37.0.
 --
 -- see: https://github.com/sol/hpack
 
 name:           graphula
-version:        2.1.0.0
+version:        2.0.0.0
 synopsis:       A simple interface for generating persistent data and linking its dependencies
 description:    Please see README.md
 category:       Network

package.yaml

@@ -1,5 +1,5 @@
 name: graphula
-version: 2.1.0.0
+version: 2.0.0.0
 maintainer: Freckle Education
 category: Network
 github: freckle/graphula

test/README.lhs

@@ -209,3 +209,15 @@ runDB f = runSqlite "test.db" $ do
   f
 ```
 -->
+
+## Release
+
+To release a new version of this library, push a commit to `main` using a
+conventionally-formatted commit message.
+
+- Prefix with `fix:` to release a new patch version,
+- Prefix with `feat:` to release a new minor version, or
+- Prefix with `feat!:` to release a new major version
+
+To change the "epoch" version, edit it in `package.yaml` and change the
+`.releaserc.yaml` tag prefix to match.