EXP-1213: Add GitHub Actions release automation by Adonis-Diaz · Pull Request #25 · EasyPost/pystalk

Adonis-Diaz · 2026-07-22T16:26:29Z

This PR adds GitHub Actions–based release automation for pystalk: a new .github/workflows/release.yml that builds the sdist/wheel (via a new justfile with install/build targets using uv) and publishes to PyPI plus uploads release assets whenever a GitHub release is published, along with a minimal pyproject.toml setuptools build-system config, a .gitignore entry for .venv/, and a README.md update describing the new tag-and-publish release workflow in place of the old manual python setup.py sdist upload process.

…ignore - justfile: add missing 'install' recipe header (was a bare unindented command with no recipe name, breaking the whole file's parsing), and rename 'Build' -> 'build' to match idiomatic naming and the call site in release.yml. - pyproject.toml: fix 'requies' -> 'requires' typo (mandatory PEP 518 key) and 'setup-tools' -> 'setuptools' (correct PyPI package name). - release.yml: fix invalid YAML (missing space after 'uses:', and the 'Upload assets to release' step was mis-indented as a nested item under the previous step instead of a sibling step). - .gitignore: add .venv/ alongside the existing venv/ entry so the new uv-based tooling's virtualenv isn't accidentally committed.

Justin Hammond (Justintime50) · 2026-07-22T17:08:48Z

+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6


Suggested change

- uses: actions/checkout@v6

- uses: actions/checkout@v7

Justin Hammond (Justintime50) · 2026-07-22T17:08:55Z

+      - uses: actions/checkout@v6
+      - uses: extractions/setup-just@v3
+      - uses: astral-sh/setup-uv@v7
+      - uses: actions/setup-python@v6


Suggested change

- uses: actions/setup-python@v6

- uses: actions/setup-python@v7

Justin Hammond (Justintime50) · 2026-07-22T17:10:46Z

@@ -0,0 +1,7 @@
+# Install the project and build its dependencies.
+install:
+    uv pip install --system -e . -r requirements-tests.txt


Python project must use their own virtual environments to ensure that dependencies don't mix or conflict with other projects. Installing system-wide as written can create various problems, best to be avoided.

Suggested change

uv pip install --system -e . -r requirements-tests.txt

uv venv

uv pip install -e . -r requirements-tests.txt

Note that you still need to remove the --system flag as that'll install them system-wide.

Justin Hammond (Justintime50) · 2026-07-22T17:19:23Z

+
+# build sdist and wheel into dist/
+build:
+    uv build


praise: nice, TIL uv has a build command!

Justin Hammond (Justintime50) · 2026-07-22T17:19:40Z

-   1. Bump the version in `setup.py` and `pystalk/__init__.py` to the stable version (e.g., `0.2`)
+   1. Bump the version in `setup.py` and `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


this line isn't needed

Suggested change

1. Update [`conf.py`](docs/source/conf.py) with the new version number

Justin Hammond (Justintime50) · 2026-07-22T17:25:23Z

@@ -0,0 +1,3 @@
+[build-system]


if we're committing to switching to uv over standard venv (which I'm fine with but wasn't intending to be included here), then we should convert the setup.py file to be in this pyproject.toml file to consolidate build metadata. You can use the easypost-python file as a template to follow. You'll then want to remove this repos setup.py file.

Justin Hammond (Justintime50) · 2026-07-22T17:26:14Z

-   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., `pystalk-0.9.0`)


versions don't include the name, not sure why that's suggested here.

Suggested change

1. Draft a [new GitHub Release](https://github.com/EasyPost/pystalk/releases/new), targeting a new tag matching the version (e.g., `pystalk-0.9.0`)

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`)

+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: extractions/setup-just@v3
+      - uses: astral-sh/setup-uv@v7
+      - 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 }}


+    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 }}


Justin Hammond (Justintime50) · 2026-07-24T18:19:15Z

+dependencies = { file = ["requirements.txt"] }
+
+[tool.setuptools.dynamic.optional-dependencies]
+dev = { file = ["requirements-tests.txt"] }


suggestion: this works but we could consolidate one more level by moving the dependencies into this file instead of keeping a separate requirements file(s)

Justin Hammond (Justintime50) · 2026-07-24T18:23:53Z

+    python -m pip install --upgrade pip
+    python -m pip install -e . -r requirements-tests.txt


We first need to install a virtual environment (we can use the pip version that comes with that python interpreter) before we can install deps.

If we move the deps to the pyproject.toml file, we can then simplify to something like this:

Suggested change

python -m pip install --upgrade pip

python -m pip install -e . -r requirements-tests.txt

python -m venv venv

python -m pip install -e '.[dev]'

Justin Hammond (Justintime50) · 2026-07-24T18:23:58Z

+
+[project]
+name = "pystalk"
+description = "Beanstalkd"


This description should match the one in the README or github description for the repo (it should be a single sentence describing what it does).

Adonis-Diaz added 2 commits July 22, 2026 12:26

Readme update to release version

46305a7

Adonis-Diaz requested a review from a team as a code owner July 22, 2026 16:26

Adonis-Diaz mentioned this pull request Jul 22, 2026

Exp 1213 #24

Closed

github-advanced-security AI found potential problems Jul 22, 2026

View reviewed changes

Comment thread .github/workflows/release.yml Fixed

Justin Hammond (Justintime50) requested changes Jul 22, 2026

View reviewed changes

Adonis-Diaz added 2 commits July 22, 2026 15:09

reviewer corrections

b0d0b69

Reviewer corrections

f970780

github-advanced-security AI found potential problems Jul 22, 2026

View reviewed changes

Removal of uv

541da38

github-advanced-security AI found potential problems Jul 23, 2026

View reviewed changes

Justin Hammond (Justintime50) reviewed Jul 24, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

EXP-1213: Add GitHub Actions release automation#25

EXP-1213: Add GitHub Actions release automation#25
Adonis-Diaz wants to merge 5 commits into
masterfrom
EXP-1213-release-tooling

Adonis-Diaz commented Jul 22, 2026

Uh oh!

Uh oh!

Justin Hammond (Justintime50) Jul 22, 2026

Uh oh!

Justin Hammond (Justintime50) Jul 22, 2026

Uh oh!

Justin Hammond (Justintime50) Jul 22, 2026

Uh oh!

Justin Hammond (Justintime50) Jul 22, 2026

Uh oh!

Justin Hammond (Justintime50) Jul 22, 2026

Uh oh!

Justin Hammond (Justintime50) Jul 22, 2026

Uh oh!

Justin Hammond (Justintime50) Jul 22, 2026

Uh oh!

Justin Hammond (Justintime50) Jul 22, 2026

Uh oh!

Justin Hammond (Justintime50) Jul 24, 2026

Uh oh!

Justin Hammond (Justintime50) Jul 24, 2026

Uh oh!

Justin Hammond (Justintime50) Jul 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

	- uses: actions/setup-python@v6
	- uses: actions/setup-python@v7

	uv pip install --system -e . -r requirements-tests.txt
	uv venv
	uv pip install -e . -r requirements-tests.txt

	1. Draft a [new GitHub Release](https://github.com/EasyPost/pystalk/releases/new), targeting a new tag matching the version (e.g., `pystalk-0.9.0`)
	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`)

		python -m pip install --upgrade pip
		python -m pip install -e . -r requirements-tests.txt

Uh oh!

Conversation

Adonis-Diaz commented Jul 22, 2026

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants