Packaging: Migrate build recipe to poethepoet definition

Makefile

@@ -44,7 +44,7 @@ test-coverage: install-tests
 # ----------------------
 # Linting and Formatting
 # ----------------------
-format: install-releasetools
+format: install-tests
 	$(poe) format
 
 
@@ -53,7 +53,8 @@ format: install-releasetools
 # -------
 
 # Release this piece of software
-release: push build pypi-upload
+release:
+	poe release
 
 
 # -------------
@@ -74,22 +75,10 @@ docs-autobuild: install-doctools
 # ===============
 # Utility targets
 # ===============
-push:
-	git push && git push --tags
-
-build: install-releasetools
-	@$(python) -m build
-
-pypi-upload: install-releasetools
-	$(twine) upload --skip-existing --verbose dist/*{.tar.gz,.whl}
-
 install-doctools:
 	@test -e $(python) || python3 -m venv $(venvpath)
 	$(pip) install --quiet --upgrade --requirement=docs/requirements.txt
 
-install-releasetools: setup-virtualenv
-	@$(pip) install --requirement requirements-release.txt --upgrade
-
 install-tests: setup-virtualenv
 	@test -e $(pytest) || $(pip) install --editable=.[test,develop] --upgrade
 	@touch $(venvpath)/bin/activate

pyproject.toml

@@ -128,3 +128,14 @@ test = [
 ]
 build = {cmd="python -m build"}
 check = ["lint", "test"]
+release = [
+  { cmd = "pip install --upgrade --editable=.[develop]" },
+  { cmd = "pip install --upgrade --requirement requirements-release.txt" },
+  # TODO: Add a basic bump step, which only runs the `git tag` and `git push` commands,
+  #       but offers a convenience option to bump by "patch", "minor", or "major" levels.
+  # TODO: Remind user about updating the changelog file accordingly. Or use `towncrier`?
+  { cmd = "git push" },
+  { cmd = "git push --tags" },
+  { cmd = "python -m build" },
+  { cmd = "twine upload --skip-existing --verbose dist/*" },
+]

requirements-release.txt

@@ -1,2 +1,2 @@
-twine
 keyring
+twine