Tox for pytest within GitHub Actions (GHA) (dbt-labs#200)

.github/workflows/main.yml

@@ -35,3 +35,33 @@ jobs:
           python -m pip install -r requirements-dev.txt
       - name: Run pre-commit hooks
         run: pre-commit run --all-files --show-diff-on-failure
+
+  unit:
+    name: unit test / python ${{ matrix.python-version }} / ${{ matrix.os }}
+
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 10
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9"]
+        os: [ubuntu-latest]
+
+    steps:
+      - name: Check out the repository
+        uses: actions/checkout@v2
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/[email protected]
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install python tools
+        run: |
+          python -m pip install --user --upgrade pip
+          python -m pip --version
+          python -m pip install tox
+          tox --version
+      - name: Run tests
+        run: tox

CONTRIBUTING.md

@@ -61,7 +61,25 @@ python3 hubcap/hubcap.py
 ## Testing locally
 
 ```shell
-PYTHONPATH=hubcap python -m pytest
+python -m pytest
+```
+
+Or just:
+```shell
+tox
+```
+
+## GitHub Actions (GHA) locally
+
+Download and install [`act`](https://github.com/nektos/act) then:
+
+```shell
+act
+```
+
+For Apple M1 Mac users, might need to do this:
+```shell
+act --container-architecture linux/amd64
 ```
 
 ## Generate requirements.txt

requirements-dev.txt

@@ -2,3 +2,4 @@ black==22.6.0
 pip-tools
 pre-commit
 pytest
+tox

tox.ini

@@ -0,0 +1,12 @@
+[tox]
+skipsdist = True
+envlist = unit
+
+[testenv:{unit,py39,py}]
+description = unit testing
+download = true
+skip_install = true
+commands =
+  {envpython} -m pytest
+deps =
+  -rrequirements-dev.txt