Merge pull request #668 from planetlabs/automate-release

create noxfile session and github action for publishing to testpypi

Author: jreiberkyle

.github/workflows/autopublish-testpypi.yml

@@ -0,0 +1,35 @@
+name: Autopublish to TestPyPi
+
+on:
+  push:
+    tags:
+      - '*'
+
+jobs:
+  publish:
+    name: Build, verify, & upload package
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Set up Python
+        uses: actions/setup-python@v3
+        with:
+          python-version: 3.7
+
+      - name: Pip cache
+        uses: actions/cache@v2
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip
+          restore-keys: |
+            ${{ runner.os }}-pip
+
+      - name: Build, verify, and upload to TestPyPI
+        run: |
+          pip install --upgrade nox
+          nox -s build publish
+          env:
+            TWINE_USERNAME: __token__
+            TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}

noxfile.py

@@ -1,3 +1,6 @@
+from pathlib import Path
+import shutil
+
 import nox
 
 nox.options.stop_on_first_error = True
@@ -7,6 +10,8 @@
 
 source_files = ("planet", "examples", "tests", "setup.py", "noxfile.py")
 
+BUILD_DIRS = ['build', 'dist']
+
 
 @nox.session
 def analyze(session):
@@ -91,3 +96,40 @@ def examples(session):
     # Because these example scripts can be long-running, output the
     # example's stdout so we know what's happening
     session.run('pytest', '--no-cov', 'examples/', '-s', *options)
+
+
+@nox.session
+def build(session):
+    # check preexisting
+    exist_but_should_not = [p for p in BUILD_DIRS if Path(p).is_dir()]
+    if exist_but_should_not:
+        session.error(
+            f"Pre-existing {', '.join(exist_but_should_not)}. Run clean session and try again"
+        )
+
+    session.install('build', 'twine', 'check-wheel-contents')
+
+    session.run(*'python -m build --sdist --wheel'.split())
+    session.run('check-wheel-contents', 'dist')
+
+
+@nox.session
+def clean(session):
+    to_remove = [Path(d) for d in BUILD_DIRS if Path(d).is_dir()]
+    for p in to_remove:
+        shutil.rmtree(p)
+
+
+@nox.session
+def publish(session):
+    missing = [p for p in BUILD_DIRS if not Path(p).is_dir()]
+    if missing:
+        session.error(
+            f"Missing one or more build directories: {', '.join(missing)}. Run build session and try again"
+        )
+
+    session.install('twine')
+
+    files = [str(f) for f in Path('dist').iterdir()]
+    session.run("twine", "check", *files)
+    session.run("twine", "upload", "--repository=testpypi", *files)