🔧 Add a reusable CI workflow with linters

Author: webknjaz

.github/workflows/ci-cd.yml

@@ -14,6 +14,9 @@ on:
   - cron: 1 0 * * *  # Run daily at 0:01 UTC
 
 jobs:
+  lint:
+    uses: ./.github/workflows/reusable-linters.yml
+
   tests:
     if: >-  # https://twitter.com/webKnjaZ/status/1308803017001652225
       github.event_name != 'create' ||

.github/workflows/reusable-linters.yml

@@ -0,0 +1,100 @@
+---
+
+name: 🚨linters
+
+on:  # yamllint disable-line rule:truthy
+  workflow_call:
+
+jobs:
+  linters:
+    name: >-
+      ${{ matrix.toxenv }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+        - 3.8
+        os:
+        - ubuntu-latest
+        toxenv:
+        - lint
+        - build-dists
+
+    env:
+      PY_COLORS: 1
+      TOX_PARALLEL_NO_SPINNER: 1
+      TOXENV: ${{ matrix.toxenv }}
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: >-
+        Calculate Python interpreter version hash value
+        for use in the cache key
+      id: calc_cache_key_py
+      run: |
+        from hashlib import sha512
+        from os import environ
+        from pathlib import Path
+        from sys import version
+
+        FILE_APPEND_MODE = 'a'
+
+        hash = sha512(version.encode()).hexdigest()
+
+        with Path(environ['GITHUB_OUTPUT']).open(
+                mode=FILE_APPEND_MODE,
+        ) as outputs_file:
+            print(f'py_hash_key={hash}', file=outputs_file)
+      shell: python
+    - name: Set up pip cache
+      uses: actions/cache@v3
+      with:
+        path: ~/.cache/pip
+        key: >-
+          ${{ runner.os }}-pip-${{
+          steps.calc_cache_key_py.outputs.py_hash_key }}-${{
+          hashFiles('setup.cfg') }}-${{
+          hashFiles('tox.ini') }}-${{
+          hashFiles('pyproject.toml') }}-${{
+          hashFiles('.pre-commit-config.yaml') }}
+        restore-keys: |
+          ${{ runner.os }}-pip-${{
+            steps.calc_cache_key_py.outputs.py_hash_key
+          }}-
+          ${{ runner.os }}-pip-
+          ${{ runner.os }}-
+    - name: Set up pre-commit cache
+      uses: actions/cache@v3
+      with:
+        path: ~/.cache/pre-commit
+        key: >-
+          ${{ runner.os }}-pre-commit-${{
+          steps.calc_cache_key_py.outputs.py_hash_key }}-${{
+          hashFiles('setup.cfg') }}-${{
+          hashFiles('tox.ini') }}-${{
+          hashFiles('pyproject.toml') }}-${{
+          hashFiles('.pre-commit-config.yaml') }}
+    - name: Install tox
+      run: |
+        python -m pip install --upgrade tox
+    - name: Log installed dists
+      run: |
+        python -m pip freeze --all
+    - name: Initialize tox envs
+      run: |
+        python -m tox --parallel auto --parallel-live --notest
+    - name: Initialize pre-commit envs if needed
+      run: >-
+        test -d .tox/lint
+        && .tox/lint/bin/python -m pre_commit install-hooks
+        || :
+    - name: Test with tox
+      run: |
+        python -m tox --parallel auto --parallel-live
+
+...