From 8a2fee171e7939034af895139de6aec85dee21c4 Mon Sep 17 00:00:00 2001
From: Jimmy Conner <jconner@ciq.com>
Date: Sun, 4 Oct 2026 21:40:03 -0500
Subject: [PATCH] Upgrade urllib3 to resolve CVE-2026-97689

---
 docs/requirements.txt |  10 +----
 docs/updater.sh       | 100 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 102 insertions(+), 8 deletions(-)
 create mode 100755 docs/updater.sh

diff --git a/docs/requirements.txt b/docs/requirements.txt
index 7e28eeb..a08b332 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,9 +1,3 @@
-#
-# This file is autogenerated by pip-compile with Python 3.12
-# by the following command:
-#
-#    pip-compile --allow-unsafe --output-file=docs/requirements.txt --strip-extras docs/requirements.in
-#
 babel==2.18.0
     # via mkdocs-material
 backrefs==8.0
@@ -99,7 +93,7 @@ mkdocs==1.6.1
     #   mkdocs-minify-plugin
     #   mkdocstrings
 mkdocs-ansible==26.4.0
-    # via -r docs/requirements.in
+    # via -r /docs/requirements.in
 mkdocs-autorefs==1.4.4
     # via
     #   mkdocstrings
@@ -194,7 +188,7 @@ tinycss2==1.5.1
     #   cssselect2
 typing-extensions==4.16.0
     # via beautifulsoup4
-urllib3==2.7.0
+urllib3==2.8.0
     # via requests
 watchdog==6.0.0
     # via
diff --git a/docs/updater.sh b/docs/updater.sh
new file mode 100755
index 0000000..2cb8954
--- /dev/null
+++ b/docs/updater.sh
@@ -0,0 +1,100 @@
+#!/bin/sh
+set -ue
+
+requirements_in="$(readlink -f ./requirements.in)"
+requirements="$(readlink -f ./requirements.txt)"
+# uv resolves the same tree as pip-compile; --refresh is its -r/--rebuild, and
+# unsafe packages (pip, setuptools) are emitted by default, so --allow-unsafe
+# has no counterpart to carry over.
+uv_compile="uv pip compile --no-strip-extras --no-header --quiet --refresh"
+
+_cleanup() {
+  cd /
+  test "${KEEP_TMP:-0}" = 1 || rm -rf "${_tmp}"
+  return 0
+}
+
+generate_requirements() {
+  local input_reqs="$1"
+  venv="$(pwd)/venv"
+  echo "$venv"
+  /usr/bin/python3.14 -m venv "${venv}"
+  # shellcheck disable=SC1090
+  source "${venv}/bin/activate"
+
+  # pip / setuptools version must match the version used in Ascender venv (see README.md UPGRADE BLOCKERs)
+  "${venv}/bin/python3" -m pip install -U 'pip==26.2.1' 'setuptools==84.0.0' uv
+
+  ${uv_compile} ${input_reqs} --output-file requirements.txt
+  return 0
+}
+
+main() {
+  local command="${1:-}"
+  base_dir=$(pwd)
+  dest_requirements="${requirements}"
+  input_requirements="${requirements_in}"
+
+  shift || true  # Remove first argument, leave remaining as package names
+
+  _tmp=$(python -c "import tempfile; print(tempfile.mkdtemp(suffix='.operator-requirements', dir='/tmp'))")
+
+  trap _cleanup INT TERM EXIT
+
+  case $command in
+    "run")
+      NEEDS_HELP=0
+    ;;
+    "upgrade")
+      NEEDS_HELP=0
+      if [[ $# -eq 0 ]]; then
+        uv_compile="${uv_compile} --upgrade"
+      else
+        for package in "$@"; do
+          uv_compile="${uv_compile} --upgrade-package $package"
+        done
+      fi
+    ;;
+    "outdated")
+      pip list --outdated
+      exit 0
+    ;;
+    "help")
+      NEEDS_HELP=1
+    ;;
+    *)
+      echo "" >&2
+      echo "ERROR: Parameter $command not valid" >&2
+      echo "" >&2
+      NEEDS_HELP=1
+    ;;
+  esac
+
+  if [[ "$NEEDS_HELP" == "1" ]] ; then
+    echo "This script generates requirements.txt from requirements.in"
+    echo ""
+    echo "Usage: $0 [run|upgrade [package-name...]|outdated]"
+    echo ""
+    echo "Commands:"
+    echo "help                   Print this message"
+    echo "run                    Run the process only upgrading pinned libraries from requirements.in"
+    echo "upgrade [package...]   Upgrade all libraries (or specific packages if specified) to latest while respecting pinnings"
+    echo "outdated               List all outdated packages"
+    echo ""
+    exit
+  fi
+
+  cp -vf requirements.txt "${_tmp}"
+  cd "${_tmp}"
+
+  generate_requirements "${input_requirements}"
+
+  echo "Changing $base_dir to /docs"
+  cat requirements.txt | sed "s:$base_dir:/docs:" > "${dest_requirements}"
+
+  _cleanup
+  return 0
+}
+
+# set EVAL=1 in case you want to source this script
+test "${EVAL:-0}" -eq "1" || main "$@"