tasks: add release task for publishing Pip

Author: stanislaw

pyproject.toml

@@ -23,7 +23,7 @@ name = "hpdf"
 dynamic = ["version"]
 description = "Python client for HTML2PDF JavaScript library."
 readme = "README.md"
-license = "TBD"
+license = { file = "LICENSE" }
 requires-python = ">=3.8"
 authors = [
     { name = "Stanislav Pankevich", email = "s.pankevich@gmail.com" },

tasks.py

@@ -191,3 +191,57 @@ def clean_itest_artifacts(context):
     # The command sometimes exits with 1 even if the files are deleted.
     # warn=True ensures that the execution continues.
     run_invoke(context, find_command, warn=True)
+
+
+@task
+def release(context, test_pypi=False, username=None, password=None):
+    """
+    A release can be made to PyPI or test package index (TestPyPI):
+    https://pypi.org/project/hpdf/
+    https://test.pypi.org/project/hpdf/
+    """
+
+    # When a username is provided, we also need password, and then we don't use
+    # tokens set up on a local machine.
+    assert username is None or password is not None
+
+    repository_argument_or_none = (
+        ""
+        if username
+        else (
+            "--repository hpdf_test"
+            if test_pypi
+            else "--repository hpdf_release"
+        )
+    )
+    user_password = f"-u{username} -p{password}" if username is not None else ""
+
+    run_invoke(
+        context,
+        """
+            rm -rfv dist/
+        """,
+    )
+    run_invoke(
+        context,
+        """
+            python3 -m build
+        """,
+    )
+    run_invoke(
+        context,
+        """
+            twine check dist/*
+        """,
+    )
+    # The token is in a core developer's .pypirc file.
+    # https://test.pypi.org/manage/account/token/
+    # https://packaging.python.org/en/latest/specifications/pypirc/#pypirc
+    run_invoke(
+        context,
+        f"""
+            twine upload dist/hpdf-*.tar.gz
+                {repository_argument_or_none}
+                {user_password}
+        """,
+    )