Use pinned dependencies for repos, infer GH matrix

.github/workflows/regressions.yml

@@ -13,35 +13,28 @@ on:
         default: 'git+https://github.com/mkdocs/mkdocs.git@master'
 
 jobs:
+  collect_projects:
+    runs-on: ubuntu-latest
+    outputs:
+      projects: ${{ steps.projects.outputs.projects }}
+    steps:
+      - uses: actions/checkout@v4
+      - id: projects
+        shell: python
+        run: |
+          import json, os, sys
+          json.dump([d.replace("--", "/") for d in os.listdir("projects")], sys.stdout)
+
   regressions:
+    needs: collect_projects
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        repo:
-          - crystal-lang/crystal-book
-          - e-maxx-eng/e-maxx-eng
-          - emacs-lsp/lsp-mode
-          - gledos/ggame
-          - ikrima/gamedevguide
-          - k3d-io/k3d
-          - librenms/librenms
-          - ManticoreGamesInc/platform-documentation
-          - mkdocs/mkdocs
-          - mkdocstrings/mkdocstrings
-          - nasa-jpl/open-source-rover
-          - Noovolari/leapp
-          - ni/systemlink-operations-handbook
-          - ntno/mkdocs-terminal
-          - open-amt-cloud-toolkit/docs
-          - oprypin/mkdocs-gen-files
-          - Rat-Rig/V-core-3
-          - seleniumbase/SeleniumBase
-          - spaceship-prompt/spaceship-prompt
-          - tfeldmann/organize
+        repo: ${{ fromJson(needs.collect_projects.outputs.projects) }}
     steps:
     - name: Checkout
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
     - name: Set up Python
       uses: actions/setup-python@v4
       with:

build.sh

@@ -9,10 +9,17 @@ else
     shift
 fi
 
-repo="$1"
+repo_name="$1"
 to_upgrade="${2:-git+https://github.com/mkdocs/mkdocs.git}"
 
-project_dir="repos/${repo/\//--}"
+info_dir="projects/${repo_name/\//--}"
+repo_dir="repos/${repo_name/\//--}"
+
+[[ "$(cat "$info_dir/url.txt")" =~ ^(https://github.com/[^/]+/[^/]+)/raw/([^/]+)/(.+)$ ]]
+repo="${BASH_REMATCH[1]}"
+branch="${BASH_REMATCH[2]}"
+mkdocs_yml="${BASH_REMATCH[3]}"
+
 
 group() {
     echo "::group::$1"
@@ -28,50 +35,53 @@ setup() {
 }
 
 clone_repo() {
-    mkdir -p "$project_dir"
-    if ! [[ -d "$project_dir/repo" ]]; then
-        echo "Cloning" "https://github.com/$repo"
-        git clone "https://github.com/$repo" "$project_dir/repo" --depth=1 --recursive &>/dev/null
-    fi
-    mkdocs_yml=$(cd "$project_dir/repo" && (2>/dev/null ls *mkdocs.y*ml || ls */mkdocs.y*ml) | head -1)
-    if ! [[ -d "$project_dir/venv" ]]; then
-        venv/bin/virtualenv "$project_dir/venv"
+    mkdir -p "$repo_dir/repo"
+    (
+        cd "$repo_dir/repo"
+        git init
+        git fetch --depth=1 "$repo" "$branch"
+        git checkout FETCH_HEAD
+    )
+    if ! [[ -d "$repo_dir/venv" ]]; then
+        venv/bin/virtualenv "$repo_dir/venv"
     fi
 }
 
 _build() {
     echo "==== Building $1 ===="
-    "$project_dir/venv/bin/pip" freeze > "$project_dir/freeze-$1.txt"
-    (set -x; cd "$project_dir/repo"; ../venv/bin/mkdocs build --no-strict -f "$mkdocs_yml" -d "$(pwd)/../site-$1")
-    find "$project_dir/site-$1" -name "*.html" -print0 | xargs -0 -n16 -P4 venv/bin/python normalize_file.py
+    "$repo_dir/venv/bin/pip" freeze > "$repo_dir/freeze-$1.txt"
+    (
+        cd "$repo_dir/repo"
+        ../venv/bin/mkdocs build --no-strict -f "$mkdocs_yml" -d "$(pwd)/../site-$1"
+    )
+    find "$repo_dir/site-$1" -name "*.html" -print0 | xargs -0 -n16 -P4 venv/bin/python normalize_file.py
 }
 
 build_current() {
     clone_repo
-    deps=($(venv/bin/mkdocs get-deps -f "$project_dir/repo/$mkdocs_yml" || true))
-    group "Installing ${deps[*]}" \
-    "$project_dir/venv/bin/pip" install -U --force-reinstall "${deps[@]}"
+    group "Installing deps" \
+    "$repo_dir/venv/bin/pip" install -U --force-reinstall --no-deps -r "$info_dir/requirements.txt"
     (export PYTHONPATH=; _build current)
 }
 
 build_latest() {
     [ -n "$to_upgrade" ] || return
     clone_repo
     group "Upgrading $to_upgrade" \
-    "$project_dir/venv/bin/pip" install -U --force-reinstall "$to_upgrade"
+    "$repo_dir/venv/bin/pip" install -U --force-reinstall "$to_upgrade"
     _build latest
 }
 
 compare() {
-    diff=$(diff -U0 "$project_dir/freeze-current.txt" "$project_dir/freeze-latest.txt") ||
+    diff=$(diff -U0 "$repo_dir/freeze-current.txt" "$repo_dir/freeze-latest.txt") ||
         group "Diff of freezes" \
         echo "$diff"
     echo "==== Comparing ===="
     diff \
         -X exclude_patterns.txt \
         -B --suppress-blank-empty \
         --suppress-common-lines \
-        -U2 -w -r "$project_dir/site-current" "$project_dir/site-latest"
+        -U2 -w -r "$repo_dir/site-current" "$repo_dir/site-latest"
 }
 
 check() {

populate_projects.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+
+set -e -u -o pipefail
+
+cd projects
+
+for d in */; do (
+  d="${d%/}"
+  cd "$d"
+  printf "%s -> " "$d" >/dev/stderr
+  if [[ ! -f 'url.txt' ]]; then
+    repo="https://github.com/${d//--//}"
+    branch="$(git remote show "$repo" | grep -oP 'HEAD branch: \K.+')"
+    echo "$repo/raw/$branch/mkdocs.yml" >url.txt
+  fi
+  cat url.txt >/dev/stderr
+  if [[ ! -f 'requirements.in' ]]; then
+    curl -f -L -- $(cat url.txt) | (mkdocs get-deps -f - || true) | grep . >requirements.in
+  fi
+); done
+
+echo */requirements.in | xargs -t -n1 -P4 pip-compile -q --no-annotate -U

projects/ManticoreGamesInc--platform-documentation/requirements.in

@@ -0,0 +1,11 @@
+markdown-full-yaml-metadata
+mkdocs
+mkdocs-ezlinks-plugin
+mkdocs-git-revision-date-localized-plugin
+mkdocs-glightbox
+mkdocs-material
+mkdocs-meta-descriptions-plugin
+mkdocs-minify-plugin
+mkdocs-redirects
+mkdocs-static-i18n <1.0
+pymdown-extensions

projects/ManticoreGamesInc--platform-documentation/requirements.txt

@@ -0,0 +1,52 @@
+#
+# This file is autogenerated by pip-compile with Python 3.11
+# by the following command:
+#
+#    pip-compile --no-annotate ManticoreGamesInc--platform-documentation/requirements.in
+#
+babel==2.12.1
+beautifulsoup4==4.12.2
+certifi==2023.7.22
+charset-normalizer==3.2.0
+click==8.1.7
+colorama==0.4.6
+csscompressor==0.9.5
+ghp-import==2.1.0
+gitdb==4.0.10
+gitpython==3.1.36
+htmlmin2==0.1.13
+idna==3.4
+jinja2==3.1.2
+jsmin==3.0.1
+markdown==3.4.4
+markdown-full-yaml-metadata==2.2.1
+markupsafe==2.1.3
+mergedeep==1.3.4
+mkdocs==1.5.2
+mkdocs-ezlinks-plugin==0.1.14
+mkdocs-git-revision-date-localized-plugin==1.2.0
+mkdocs-glightbox==0.3.4
+mkdocs-material==9.3.1
+mkdocs-material-extensions==1.1.1
+mkdocs-meta-descriptions-plugin==2.3.0
+mkdocs-minify-plugin==0.7.1
+mkdocs-redirects==1.2.1
+mkdocs-static-i18n==0.56
+packaging==23.1
+paginate==0.5.6
+pathspec==0.11.2
+platformdirs==3.10.0
+pygments==2.16.1
+pygtrie==2.5.0
+pymdown-extensions==10.3
+python-dateutil==2.8.2
+pytz==2023.3.post1
+pyyaml==6.0.1
+pyyaml-env-tag==0.1
+regex==2023.8.8
+requests==2.31.0
+six==1.16.0
+smmap==5.0.0
+soupsieve==2.5
+urllib3==2.0.4
+watchdog==3.0.0

projects/ManticoreGamesInc--platform-documentation/url.txt

@@ -0,0 +1 @@
+https://github.com/ManticoreGamesInc/platform-documentation/raw/development/mkdocs.yml

projects/Noovolari--leapp/requirements.in

@@ -0,0 +1,8 @@
+mike
+mkdocs
+mkdocs-git-revision-date-plugin
+mkdocs-img2fig-plugin
+mkdocs-material
+mkdocs-minify-plugin
+mkdocs-video
+pymdown-extensions

projects/Noovolari--leapp/requirements.txt

@@ -0,0 +1,47 @@
+#
+# This file is autogenerated by pip-compile with Python 3.11
+# by the following command:
+#
+#    pip-compile --no-annotate Noovolari--leapp/requirements.in
+#
+babel==2.12.1
+certifi==2023.7.22
+charset-normalizer==3.2.0
+click==8.1.7
+colorama==0.4.6
+csscompressor==0.9.5
+ghp-import==2.1.0
+gitdb==4.0.10
+gitpython==3.1.36
+htmlmin2==0.1.13
+idna==3.4
+jinja2==3.1.2
+jsmin==3.0.1
+lxml==4.9.3
+markdown==3.4.4
+markupsafe==2.1.3
+mergedeep==1.3.4
+mike==1.1.2
+mkdocs==1.5.2
+mkdocs-git-revision-date-plugin==0.3.2
+mkdocs-img2fig-plugin==0.9.3
+mkdocs-material==9.3.1
+mkdocs-material-extensions==1.1.1
+mkdocs-minify-plugin==0.7.1
+mkdocs-video==1.5.0
+packaging==23.1
+paginate==0.5.6
+pathspec==0.11.2
+platformdirs==3.10.0
+pygments==2.16.1
+pymdown-extensions==10.3
+python-dateutil==2.8.2
+pyyaml==6.0.1
+pyyaml-env-tag==0.1
+regex==2023.8.8
+requests==2.31.0
+six==1.16.0
+smmap==5.0.0
+urllib3==2.0.4
+verspec==0.1.0
+watchdog==3.0.0

projects/Noovolari--leapp/url.txt

@@ -0,0 +1 @@
+https://github.com/Noovolari/leapp/raw/master/mkdocs.yml

projects/Rat-Rig--V-core-3/requirements.in

@@ -0,0 +1,6 @@
+mkdocs
+mkdocs-awesome-pages-plugin
+mkdocs-macros-plugin
+mkdocs-material
+mkdocs-monorepo-plugin
+pymdown-extensions

projects/Rat-Rig--V-core-3/requirements.txt

@@ -0,0 +1,43 @@
+#
+# This file is autogenerated by pip-compile with Python 3.11
+# by the following command:
+#
+#    pip-compile --no-annotate Rat-Rig--V-core-3/requirements.in
+#
+babel==2.12.1
+bracex==2.4
+certifi==2023.7.22
+charset-normalizer==3.2.0
+click==8.1.7
+colorama==0.4.6
+ghp-import==2.1.0
+idna==3.4
+jinja2==3.1.2
+markdown==3.4.4
+markupsafe==2.1.3
+mergedeep==1.3.4
+mkdocs==1.5.2
+mkdocs-awesome-pages-plugin==2.9.2
+mkdocs-macros-plugin==1.0.4
+mkdocs-material==9.3.1
+mkdocs-material-extensions==1.1.1
+mkdocs-monorepo-plugin==1.0.5
+natsort==8.4.0
+packaging==23.1
+paginate==0.5.6
+pathspec==0.11.2
+platformdirs==3.10.0
+pygments==2.16.1
+pymdown-extensions==10.3
+python-dateutil==2.8.2
+python-slugify==8.0.1
+pyyaml==6.0.1
+pyyaml-env-tag==0.1
+regex==2023.8.8
+requests==2.31.0
+six==1.16.0
+termcolor==2.3.0
+text-unidecode==1.3
+urllib3==2.0.4
+watchdog==3.0.0
+wcmatch==8.5

projects/Rat-Rig--V-core-3/url.txt

@@ -0,0 +1 @@
+https://github.com/Rat-Rig/V-core-3/raw/main/mkdocs.yml

projects/crystal-lang--crystal-book/requirements.in

@@ -0,0 +1,9 @@
+markdown-callouts
+mkdocs
+mkdocs-code-validator
+mkdocs-literate-nav
+mkdocs-material
+mkdocs-redirects
+mkdocs-section-index
+mkdocs-simple-hooks
+pymdown-extensions

projects/crystal-lang--crystal-book/requirements.txt

@@ -0,0 +1,40 @@
+#
+# This file is autogenerated by pip-compile with Python 3.11
+# by the following command:
+#
+#    pip-compile --no-annotate crystal-lang--crystal-book/requirements.in
+#
+babel==2.12.1
+certifi==2023.7.22
+charset-normalizer==3.2.0
+click==8.1.7
+colorama==0.4.6
+ghp-import==2.1.0
+idna==3.4
+jinja2==3.1.2
+markdown==3.4.4
+markdown-callouts==0.3.0
+markupsafe==2.1.3
+mergedeep==1.3.4
+mkdocs==1.5.2
+mkdocs-code-validator==0.1.3
+mkdocs-literate-nav==0.6.1
+mkdocs-material==9.3.1
+mkdocs-material-extensions==1.1.1
+mkdocs-redirects==1.2.1
+mkdocs-section-index==0.3.7
+mkdocs-simple-hooks==0.1.5
+packaging==23.1
+paginate==0.5.6
+pathspec==0.11.2
+platformdirs==3.10.0
+pygments==2.16.1
+pymdown-extensions==10.3
+python-dateutil==2.8.2
+pyyaml==6.0.1
+pyyaml-env-tag==0.1
+regex==2023.8.8
+requests==2.31.0
+six==1.16.0
+urllib3==2.0.4
+watchdog==3.0.0

projects/crystal-lang--crystal-book/url.txt

@@ -0,0 +1 @@
+https://github.com/crystal-lang/crystal-book/raw/master/mkdocs.yml