Modernize CI

Author: hynek

.github/workflows/main.yml

@@ -6,79 +6,109 @@ on:
     branches: ["main"]
   pull_request:
     branches: ["main"]
+  workflow_dispatch:
+
+
+env:
+  FORCE_COLOR: "1"  # Make tools pretty.
+  TOX_TESTENV_PASSENV: FORCE_COLOR
+  PYTHON_LATEST: "3.10"
+
 
 jobs:
   tests:
-    runs-on: "ubuntu-latest"
-
+    name: tox on ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
     strategy:
       matrix:
         python-version: ["3.8", "3.9", "3.10"]
-    name: "Python ${{ matrix.python-version }}"
 
     steps:
-      - uses: "actions/checkout@v2"
-      - uses: "actions/setup-python@v2"
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
         with:
           python-version: "${{ matrix.python-version }}"
-      - name: "Install dependencies"
+
+      - name: Install dependencies
         run: |
           set -xe
           python -VV
           python -m site
-          python -m pip install --upgrade pip setuptools
-          python -m pip install --upgrade coverage[toml] virtualenv tox tox-gh-actions
+          python -m pip install --upgrade pip setuptools wheel
+          python -m pip install --upgrade virtualenv tox tox-gh-actions
+
+      - run: python -m tox
 
-      - name: "Run tox targets for ${{ matrix.python-version }}"
-        run: "python -m tox"
+      - name: Upload coverage data
+        uses: actions/upload-artifact@v2
+        with:
+          name: coverage-data
+          path: .coverage.*
+          if-no-files-found: ignore
+
+
+  coverage:
+    name: Combine & check coverage.
+    runs-on: ubuntu-latest
+    needs: tests
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
+        with:
+          # Use latest Python, so it understands all syntax.
+          python-version: ${{env.PYTHON_LATEST}}
 
-      - name: "Get coverage"
+      - run: python -m pip install --upgrade coverage[toml]
+
+      - uses: actions/download-artifact@v2
+        with:
+          name: coverage-data
+
+      - name: Combine coverage & fail if it's <100%.
         run: |
-          set -xe
-          if compgen -G ".coverage.*" >/dev/null; then
-            python -m coverage combine
-            python -m coverage xml
-          fi
-      - name: Upload coverage to Codecov
-        uses: "codecov/codecov-action@v2"
+          python -m coverage combine
+          python -m coverage html --skip-covered --skip-empty
+          python -m coverage report --fail-under=100
+
+      - name: Upload HTML report if check failed.
+        uses: actions/upload-artifact@v2
         with:
-          fail_ci_if_error: true
+          name: html-report
+          path: htmlcov
+        if: ${{ failure() }}
+
 
   package:
-    name: "Build & verify package"
-    runs-on: "ubuntu-latest"
+    name: Build & verify package
+    runs-on: ubuntu-latest
 
     steps:
-      - uses: "actions/checkout@v2"
-      - uses: "actions/setup-python@v2"
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
         with:
-          python-version: "3.9"
-
-      - name: "Install build, check-wheel-contents, and twine"
-        run: "python -m pip install build twine check-wheel-contents"
-      - name: "Build package"
-        run: "python -m build --sdist --wheel ."
-      - name: "List result"
-        run: "ls -l dist"
-      - name: "Check wheel contents"
-        run: "check-wheel-contents dist/*.whl"
-      - name: "Check long_description"
-        run: "python -m twine check dist/*"
+          python-version: ${{env.PYTHON_LATEST}}
+
+      - run: python -m pip install build twine check-wheel-contents
+      - run: python -m build --sdist --wheel .
+      - run: ls -l dist
+      - run: check-wheel-contents dist/*.whl
+      - name: Check long_description
+        run: python -m twine check dist/*
+
 
   install-dev:
+    name: Verify dev env
+    runs-on: "${{ matrix.os }}"
     strategy:
       matrix:
-        os: ["ubuntu-latest", "windows-latest", "macos-latest"]
-
-    name: "Verify dev env"
-    runs-on: "${{ matrix.os }}"
+        os: ["ubuntu-latest", "windows-latest"]
 
     steps:
-      - uses: "actions/checkout@v2"
-      - uses: "actions/setup-python@v2"
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
         with:
-          python-version: "3.9"
-      - name: "Install in dev mode"
-        run: "python -m pip install -e .[dev]"
-      - name: "Import package"
-        run: "python -c 'import doc2dash; print(doc2dash.__version__)'"
+          python-version: ${{env.PYTHON_LATEST}}
+      - run: python -m pip install -e .[dev]
+      - run: "python -c 'import doc2dash; print(doc2dash.__version__)'"
+      - run: "python -m doc2dash"