EXP-1213: Add GitHub Actions release automation

.github/workflows/ci.yml

@@ -36,13 +36,14 @@ jobs:
         uses: actions/setup-python@v2
         with:
           python-version: ${{ matrix.pythonversion }}
+      - uses: extractions/setup-just@v3
       - name: install dependencies
-        run: "python -m pip install -r requirements-tests.txt -e ."
+        run: just install
       - name: lint with flake8
-        run: flake8 pystalk/ tests/
+        run: venv/bin/flake8 pystalk/ tests/
       - name: test with pytest
-        run: pytest --cov=pystalk/ --cov-report=term-missing --cov-fail-under=60 tests/
+        run: venv/bin/pytest --cov=pystalk/ --cov-report=term-missing --cov-fail-under=60 tests/
         env:
           BEANSTALKD_PATH: ~/beanstalks/beanstalkd
       - name: check mypy
-        run: mypy pystalk/ tests/
+        run: venv/bin/mypy pystalk/ tests/

.github/workflows/release.yml

@@ -0,0 +1,27 @@
+name: release
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: extractions/setup-just@v3
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.14'
+      - name: Build package
+        run: just install build
+      - name: Publish to PyPi
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+      - name: Upload assets to release
+        uses: AButler/upload-release-assets@v3.0.1
+        with:
+          files: 'dist/*'
+          repo-token: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,6 +1,7 @@
 *.egg-info
 .cache/
 venv/
+.venv/
 .tox
 test-*.xml
 .coverage

README.md

@@ -135,10 +135,8 @@ Pretty straightforward. Develop in branches, send PRs, land on master. All tests
 ### Releasing a new version
 
    1. Land all requisite changes
-   1. Bump the version in `setup.py` and `pystalk/__init__.py` to the stable version (e.g., `0.2`)
+   1. Bump the version in `pystalk/__init__.py` to the stable version (e.g., `0.9.0`)
    1. Update [`CHANGES.rst`](docs/source/CHANGES.rst) with the changes and the new version number
-   1. Update [`conf.py`](docs/source/conf.py) with the new version number
-   1. Commit
-   1. Tag the version (e.g., `git tag -s pystalk-0.2`)
-   1. Push up to Github
-   1. Upload to PyPI with `python setup.py sdist upload`
+   1. Commit and push up to Github
+   1. Draft a [new GitHub Release](https://github.com/EasyPost/pystalk/releases/new), targeting a new tag matching the version (e.g., `0.9.0`)
+   1. Publishing the release triggers the `release` GitHub Actions workflow, which builds the sdist/wheel and publishes them to PyPI automatically

justfile

@@ -0,0 +1,9 @@
+# Install the project and build its dependencies.
+install:
+    python -m venv venv
+    venv/bin/pip install -e '.[dev]'
+
+# build sdist and wheel into dist/
+build:
+    venv/bin/pip install build
+    venv/bin/python -m build

pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pystalk"
+description = "An extremely simple Python client for beanstalkd"
+dynamic = ["version"]
+readme = "README.md"
+requires-python = ">=3.6, <4"
+license = { file = "LICENSE.txt" }
+authors = [{ name = "EasyPost", email = "oss@easypost.com" }]
+dependencies = [
+    "PyYAML>=3.0",
+    "attrs>=19.2",
+    "six",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3.6",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Intended Audience :: System Administrators",
+    "Operating System :: OS Independent",
+    "Topic :: Database",
+    "License :: OSI Approved :: ISC License (ISCL)",
+]
+[project.optional-dependencies]
+dev = [
+    "flake8",
+    "mock",
+    "mypy==0.971",
+    "pytest==7.*",
+    "pytest-cov==3.*",
+    "pytest-mock==3.*",
+    "types-PyYAML",
+    "types-six",
+]
+docs = [
+    "PyYAML>=3.0",
+    "sphinx",
+    "sphinx-autobuild",
+]
+
+[project.urls]
+Source = "https://github.com/easypost/pystalk"
+
+[tool.setuptools.dynamic]
+version = { attr = "pystalk.__version__" }
+
+[tool.setuptools.packages.find]
+exclude = ["tests", "tests.*"]