ci: 👷 Separate linting and test environments

.github/workflows/test.yml

@@ -8,8 +8,55 @@ on:
       - main
 
 jobs:
-  build:
+
+ flake8:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.8
+
+      - name: Ensure latest setuptools
+        run: |
+          python -m pip install --upgrade pip setuptools wheel
+
+      - name: Install dependencies
+        run: |
+          python -m pip install tox
+      - name: Run linting
+        run: |
+          python -m pip --version
+          python -m tox --version
+          python -m tox -e lint
+
+ docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.8
+
+      - name: Ensure latest setuptools
+        run: |
+          python -m pip install --upgrade pip setuptools wheel
+
+      - name: Install dependencies
+        run: |
+          python -m pip install tox
+      - name: Build docs
+        run: |
+          python -m pip --version
+          python -m tox --version
+          python -m tox -e docs
+
+ tests:
+    name: Python ${{ matrix.python-version }}
     runs-on: ubuntu-latest
+
     strategy:
       fail-fast: false
       max-parallel: 5
@@ -26,12 +73,17 @@ jobs:
       uses: actions/setup-python@v2
       with:
         python-version: ${{ matrix.python-version }}
-    - name: Install Python dependencies
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip setuptools wheel
+        python -m pip install --upgrade tox tox-py codecov
+
+    - name: Run tox targets for ${{ matrix.python-version }}
       run: |
-        python -m pip install --upgrade pip
-        python -m pip install --upgrade tox tox-gh-actions
-    - name: Tox tests
+        tox --py current
+
+    - name: Coverage reporting
       run: |
-        tox
-    - name: Upload coverage
-      uses: codecov/codecov-action@v1
+        coverage combine
+        codecov

.gitignore

@@ -8,7 +8,7 @@ dist
 docs/_build
 
 .tox
-.coverage
+.coverage*
 coverage*
 
 # editor files

CONTRIBUTING.rst

@@ -22,7 +22,7 @@ To start development on this project, fork this repository and follow the follow
     # activate the virtual environment(window users)
     $ venv\Scripts\activate
     # install dependencies
-    (venv) $ pip install -e . -r testapp/requirements.txt
+    (venv) $ pip install -e . Django -r testapp/requirements.txt
     # migrate the migrations to the database
     (venv) $ python manage.py migrate
     # create data

setup.cfg

@@ -55,14 +55,18 @@ known_third_party = django, rest_framework
 
 [coverage:run]
 branch = true
+source =
+    flag
+
+[coverage:report]
+show_missing = true
+skip_covered = true
 
 [tool:pytest]
 django_find_project = false
 addopts = -p no:doctest
     --ds=testapp.settings
     --reuse-db
-    --cov=flag
-    --cov-report term-missing:skip-covered
 
 [build_sphinx]
 source-dir = docs

testapp/requirements.txt

@@ -1,7 +1,5 @@
-django
 djangorestframework
 flake8
-tox
 Pillow
 pytest-django
-pytest-cov
+coverage

tox.ini

@@ -4,6 +4,7 @@ envlist =
     py37-dj{21, 22, 30, 31, 32}
     py38-dj{21, 22, 30, 31, 32, main}
     py39-dj{21, 22, 30, 31, 32, main}
+    lint, docs
 
 [gh-actions]
 python =
@@ -19,13 +20,15 @@ deps =
 commands =
    python setup.py build_sphinx
 
-[testenv]
+[testenv:lint]
 deps =
     flake8
-    Pillow
-    djangorestframework
-    pytest-django
-    pytest-cov
+commands =
+    flake8 flag tests testapp {posargs}
+
+[testenv]
+deps =
+    -rtestapp/requirements.txt
     dj21: Django>=2.1,<2.2
     dj22: Django>=2.2,<2.3
     dj30: Django>=3.0,<3.1
@@ -36,10 +39,6 @@ deps =
 usedevelop = True
 
 commands =
-    python -m pip install --upgrade pip
-    flake8
-    python manage.py migrate
-    pytest --cov-report=xml
-
+    python -m coverage run --parallel-mode -m pytest {posargs}
 setenv =
     PYTHONDONTWRITEBYTECODE=1