Prepare for initial release on PyPI

Author: millerdev

.github/workflows/pypi.yml

@@ -0,0 +1,81 @@
+name: Publish Python distribution to PyPI and TestPyPI
+# Source:
+# https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'
+jobs:
+  build:
+    name: Build distribution package
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+      - run: pip install build
+      - name: Add untagged version suffix
+        if: ${{ ! startsWith(github.ref, 'refs/tags/v') }}
+        run: python version.py update
+      - name: Build a binary wheel and a source tarball
+        run: python -m build
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+  version-check:
+    name: Check for version match in git tag and unmagic.__version__
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+      - name: Install pytest-unmagic
+        run: pip install -e .
+      - name: Check version
+        run: python version.py check "${{ github.ref }}"
+  pypi-publish:
+    name: Upload release to PyPI
+    needs: [build, version-check]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pytest-unmagic
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+  pypi-test-publish:
+    name: Upload release to test PyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/pytest-unmagic
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

.gitignore

@@ -1 +1,2 @@
 __pycache__
+/dist

README.md

@@ -193,3 +193,14 @@ cd path/to/pytest-unmagic
 pip install -e .
 pytest
 ```
+
+
+## Publishing a new verison to PyPI
+
+Push a new tag to Github using the format vX.Y.Z where X.Y.Z matches the version
+in [`__init__.py`](src/unmagic/__init__.py).
+
+A new version is published to https://test.pypi.org/p/pytest-unmagic on every
+push to the *main* branch.
+
+Publishing is automated with [Github Actions](.github/workflows/pypi.yml).

pyproject.toml

@@ -2,6 +2,7 @@
 name = "pytest-unmagic"
 authors = [{name = "Daniel Miller", email = "millerdev@gmail.com"}]
 license = {file = "LICENSE"}
+readme = {file = "README.md", content-type = "text/markdown"}
 dynamic = ["version", "description"]
 requires-python = ">= 3.9"
 classifiers = [
@@ -10,6 +11,10 @@ classifiers = [
     "License :: OSI Approved :: BSD License",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Software Development :: Libraries",
     "Topic :: Software Development :: Testing",
 ]

src/unmagic/__init__.py

@@ -1,4 +1,4 @@
-"""Reduce pytest magic
+"""Pytest fixtures with conventional import semantics
 
 The primary motivation of this project is to remove the argument-name-
 matching magic in pytest fixtures.

version.py

@@ -0,0 +1,47 @@
+"""Check or update version in __init__.py"""
+import re
+import sys
+from datetime import datetime
+from pathlib import Path
+
+
+def main(argv=sys.argv):
+    if len(argv) < 2:
+        sys.exit(f"usage: {argv[0]} (check|update) [...]")
+    cmd, *args = sys.argv[1:]
+    if cmd in COMMANDS:
+        COMMANDS[cmd](*args)
+    else:
+        sys.exit(f"unknown arguments: {argv[1:]}")
+
+
+def check(ref):
+    import unmagic
+    if not ref.startswith("refs/tags/v"):
+        sys.exit(f"unexpected ref: {ref}")
+    version = ref.removeprefix("refs/tags/v")
+    if version != unmagic.__version__:
+        sys.exit(f"version mismatch: {version} != {unmagic.__version__}")
+
+
+def update():
+    path = Path(__file__).parent / "src/unmagic/__init__.py"
+    vexpr = re.compile(r"""(?<=^__version__ = )['"](.+)['"]$""", flags=re.M)
+    with open(path, "r+") as file:
+        text = file.read()
+        match = vexpr.search(text)
+        if not match:
+            sys.exit("unmagic.__version__ not found")
+        timestamp = datetime.now().strftime("%Y%m%d%H%M%S")
+        version = f"{match.group(1)}.dev{timestamp}"
+        print("new version:", version)
+        file.seek(0)
+        file.write(vexpr.sub(repr(version), text))
+        file.truncate()
+
+
+COMMANDS = {"check": check, "update": update}
+
+
+if __name__ == "__main__":
+    main()