Release automation

Author: twm

NEWS.rst

@@ -1,6 +1,10 @@
 Incremental 24.11.0 (2025-11-27)
 ================================
 
+.. note::
+
+    The date above is correct — 25.11.0 was mistakenly released with this version number.
+
 Features
 --------
 

RELEASE.rst

@@ -0,0 +1,10 @@
+Releasing Incremental
+=====================
+
+To release Incremental, `install just <https://just.systems/>`_ and run `just release`.
+
+This will bump the version,
+render `the changelog <./NEWS.rst>`_,
+and push the tagged release.
+The `release workflow <https://github.com/twisted/incremental/actions/workflows/release.yml>`_
+will build and upload the library to PyPI.org.

justfile

@@ -0,0 +1,27 @@
+# Update the version, tag a release, and trigger the GHA release workflow
+release:
+    #!/bin/bash
+    set -exu -o pipefail
+    # TODO: Replace `tox` with `uv run`
+    tox -e release --notest
+    if [[ $(git rev-parse --abbrev-ref HEAD) != trunk ]]
+    then
+        echo "ERROR: Must be on trunk branch"
+        exit 1
+    fi
+    if ! git diff --quiet HEAD
+    then
+        echo "ERROR: Dirty working copy"
+        exit 1
+    fi
+    # Incremental doesn't do release candidates.
+    .tox/bin/release/bin/incremental update --rc
+    .tox/bin/release/bin/incremental update
+    version=$(.tox/bin/release/bin/hatch version)
+    tag="incremental-$version"
+    .tox/bin/release/bin/towncrier build --yes
+    git add -A NEWS.rst src/incremental/newsfragments src/incremental/_version.py
+    git commit -am "Release $version"
+    git tag "$tag"
+    git push origin "$tag"
+    git push origin trunk

src/incremental/newsfragments/185.misc.rst

@@ -0,0 +1 @@
+Add release automation to prevent errors like the mis-numbered 24.11.0 release.

tox.ini

@@ -63,3 +63,9 @@ commands =
 [testenv:build]
 # empty environment to build universal wheel once per tox invocation
 # https://github.com/ionelmc/tox-wheel#build-configuration
+
+[testenv:release]
+description = Release management dependencies
+deps =
+    hatch
+    towncrier