Prepare for PyPI: publish workflow, SPDX license, pip install feastdate

.github/workflows/publish.yml

@@ -0,0 +1,69 @@
+name: publish
+
+# A pushed v* tag publishes to PyPI. Running the workflow by hand publishes to
+# TestPyPI instead, to check a release before tagging it. Both use Trusted
+# Publishing, so no token is stored: each index has a publisher registered for
+# this repository, this file and the environment named below.
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install build twine
+      - name: tag must match the version in pyproject.toml
+        if: github.ref_type == 'tag'
+        shell: bash
+        run: |
+          version=$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')
+          test "v$version" = "$GITHUB_REF_NAME" || { echo "tag $GITHUB_REF_NAME != version $version"; exit 1; }
+      - run: python -m build
+      - run: twine check --strict dist/*
+      - name: smoke-test the built wheel
+        shell: bash
+        run: |
+          python -m venv /tmp/smoke
+          /tmp/smoke/bin/pip install dist/*.whl
+          /tmp/smoke/bin/feastdate "Dom. Palm. 1656" | grep -F "= Sun 30 Mar 1656 (Julian)"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  testpypi:
+    if: github.event_name == 'workflow_dispatch'
+    needs: build
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  pypi:
+    if: github.ref_type == 'tag'
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

README.md

@@ -19,6 +19,12 @@ It is pure Python, uses only the standard library, and runs on Python 3.9 or lat
 
 ## Install
 
+```console
+pip install feastdate
+```
+
+Or the latest `main` straight from GitHub:
+
 ```console
 pip install git+https://github.com/isaacschepp/feastdate
 ```
@@ -522,4 +528,4 @@ pytest
 
 ## License
 
-MIT. See [LICENSE](LICENSE).
+MIT. See [LICENSE](https://github.com/isaacschepp/feastdate/blob/main/LICENSE).

pyproject.toml

@@ -1,21 +1,21 @@
 [build-system]
-requires = ["setuptools>=61"]
+requires = ["setuptools>=77"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "feastdate"
 version = "1.7.0"
 description = "Convert church-year feast names from old parish registers (Dom. Palm. 1656) into calendar dates, Julian or Gregorian."
 readme = "README.md"
-license = { file = "LICENSE" }
+license = "MIT"
+license-files = ["LICENSE"]
 authors = [{ name = "isaacschepp" }]
 requires-python = ">=3.9"
 dependencies = []
 keywords = ["genealogy", "calendar", "easter", "parish registers", "julian", "gregorian", "liturgical"]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Science/Research",
-    "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Topic :: Sociology :: Genealogy",