chore: Modernize packaging (#301)

Switch to modern packaging backed by setuptools and setuptools-scm,
including a VCS-backed versioning scheme, as well as trusted publishing
configuration for PyPI.

.github/workflows/ci.yaml

@@ -33,9 +33,11 @@ jobs:
           # Keep in sync with version in .readthedocs.yml.
           python-version: "3.11"
           cache: pip
-          cache-dependency-path: docs/requirements.txt
+          cache-dependency-path: docs-requirements.txt
       - name: Install dependencies
-        run: pip install --require-hashes -r docs/requirements.txt
+        run: pip install --require-hashes --no-dependencies -r docs-requirements.txt
+      - name: Install package
+        run: pip install --no-dependencies .
       - name: Build docs
         run: sphinx-build -W -b html docs docs/_build
 
@@ -52,9 +54,9 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           cache: pip
-          cache-dependency-path: setup.cfg
+          cache-dependency-path: pyproject.toml
       - name: Install minimum requirements
-        run: pip install --upgrade -e '.[test]'
+        run: pip install --upgrade '.[test]'
       - name: Run all tests that don't require extra dependencies
         run: >-
           coverage run --append -m pytest
@@ -63,7 +65,7 @@ jobs:
           --ignore=tests/pydantic
           --ignore=tests/ext
       - name: Install extra requirements
-        run: pip install --upgrade -e '.[all,test]'
+        run: pip install --upgrade '.[all,test]'
       - name: Run all tests that require extra dependencies
         run: >-
           coverage run --append -m pytest

.github/workflows/release.yaml

@@ -6,6 +6,43 @@ on:
 
 jobs:
   build-and-publish:
-    uses: less-action/reusables/.github/workflows/python-publish.yaml@main
-    secrets:
-      pypi_api_token: ${{ secrets.PYPI_API_TOKEN }}
+    name: Build and publish
+    runs-on: ubuntu-latest
+    permissions:
+      # permission required for trusted publishing
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/p/immoney
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.12
+          cache: pip
+          cache-dependency-path: pyproject.toml
+          check-latest: true
+      - name: Install dependencies
+        run: python3 -m pip install --upgrade build pkginfo
+      - name: Build
+        run: python3 -m build --sdist --wheel .
+      - name: Inspect built wheel version
+        id: inspect-wheel-version
+        run: |
+          python3 << 'EOF' >> $GITHUB_OUTPUT
+          from pathlib import Path
+          from pkginfo import Wheel
+          [wheel_path] = Path("dist").glob("*.whl")
+          wheel = Wheel(wheel_path)
+          print(f"version={wheel.version}")
+          EOF
+      - name: Fail on version mismatch
+        if: ${{ steps.inspect-wheel-version.outputs.version != github.event.release.tag_name }}
+        run: |
+          echo "💥 The version of the built wheel does not match the release tag."
+          echo
+          echo "Release tag: '${{ github.event.release.tag_name }}'"
+          echo "Packaged version: '${{ steps.inspect-wheel-version.outputs.version }}'"
+          exit 1
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1

.gitignore

@@ -134,3 +134,6 @@ dmypy.json
 
 # pytype static type analyzer
 .pytype/
+
+# Dynamic version file
+src/phantom/_version.py

.pre-commit-config.yaml

@@ -77,4 +77,6 @@ repos:
       - id: check-manifest
         args: ["--no-build-isolation"]
         additional_dependencies:
-          - setuptools==67.4.0
+          - setuptools==74.1.2
+          - setuptools-scm==8.1.0
+          - wheel==0.44.0

.readthedocs.yml

@@ -9,4 +9,6 @@ build:
     python: "3.11"
 python:
   install:
-    - requirements: docs/requirements.txt
+    - requirements: docs-requirements.txt
+    - method: pip
+      path: .

MANIFEST.in

@@ -8,3 +8,6 @@ exclude *.yaml
 exclude *.yml
 include README.md
 include LICENSE
+exclude .gitignore
+exclude setup.cfg
+exclude *requirements.txt

Makefile

@@ -46,3 +46,8 @@ test-typing:
 .PHONY: clean
 clean:
 	rm -rf {**/,}*.egg-info **{/**,}/__pycache__ build dist .coverage coverage.xml
+
+docs-requirements: export CUSTOM_COMPILE_COMMAND='make docs-requirements'
+docs-requirements:
+	@pip install --upgrade pip-tools
+	@pip-compile

docs/Makefile

@@ -18,8 +18,3 @@ help:
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-
-
-requirements: export CUSTOM_COMPILE_COMMAND='make requirements'
-requirements:
-	@pip-compile