ci: cached pip install step

Since this is one of the slowest actions it is good to cache.

Author: Tygo-van-den-Hurk

.github/workflows/push--deploy-github-pages.yaml

@@ -29,28 +29,26 @@ jobs:
       - name: Setup Pages
         uses: actions/[email protected]
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v6.1.0
         with: { python-version: '3.x' }
       - name: Install pip
         run: python -m pip install --upgrade pip
+      - name: Cache pip
+        uses: actions/[email protected]
+        with:
+          path: ~/.cache/pip
+          key: pip-${{ runner.os }}-${{ hashFiles('docs/requirements.txt') }}
+          restore-keys: pip-${{ runner.os }}-
       - name: Install MkDocs and dependencies
-        run: >
-          pip install mkdocs==1.6.1 mkdocs-shadcn==0.9.8 Pygments==2.19.2
-          mkdocstrings-python==2.0.1 pymdown-extensions==10.19.1
-          click==8.3.1 ghp-import==2.1.0 jinja2==3.1.6 markdown==3.10
-          markupsafe==3.0.3 mergedeep==1.3.4 mkdocs-get-deps==0.2.0
-          pathspec==0.12.1 pyyaml-env-tag==1.1 pyyaml==6.0.3 bottle==0.13.4
-          watchdog==6.0.0 gitpython==3.1.45 mkdocstrings==1.0.0 griffe==1.15.0
-          mkdocs-autorefs==1.4.3 python-dateutil==2.9.0.post0 gitdb==4.0.12
-          smmap==5.0.2 colorama==0.4.6 platformdirs==4.5.1 six==1.17.0
+        run: pip install --requirement 'docs/requirements.txt'
       - name: Build site with MkDocs
         run: mkdocs --verbose --color build --site-dir ./_site
       - name: Restore lychee cache
         uses: actions/[email protected]
         id: restore-cache
         with:
           path: .lycheecache
-          key: cache-docs-lychee-${{ github.sha }}
+          key: cache-lychee-${{ hashFiles('docs/**/*.html', 'docs/**/*.htm') }}
           restore-keys: cache-docs-lychee-
       - name: Check the links
         uses: lycheeverse/[email protected]

docs/requirements.txt

@@ -0,0 +1,27 @@
+mkdocs==1.6.1
+mkdocs-shadcn==0.9.8
+Pygments==2.19.2
+mkdocstrings-python==2.0.1
+pymdown-extensions==10.19.1
+click==8.3.1
+ghp-import==2.1.0
+jinja2==3.1.6
+markdown==3.10
+markupsafe==3.0.3
+mergedeep==1.3.4
+mkdocs-get-deps==0.2.0
+pathspec==0.12.1
+pyyaml-env-tag==1.1
+pyyaml==6.0.3
+bottle==0.13.4
+watchdog==6.0.0
+gitpython==3.1.45
+mkdocstrings==1.0.0
+griffe==1.15.0
+mkdocs-autorefs==1.4.3
+python-dateutil==2.9.0.post0
+gitdb==4.0.12
+smmap==5.0.2
+colorama==0.4.6
+platformdirs==4.5.1
+six==1.17.0