Use inline dependency metadata for update-rtd-redirects.py (#13274)

* Use inline dependency metadata for update-rtd-redirects.py
* ci: Skip redirect updates if config unchanged

Author: ichard26

.github/workflows/update-rtd-redirects.yml

@@ -3,6 +3,9 @@ name: Update documentation redirects
 on:
   push:
     branches: [main]
+    paths:
+      - ".readthedocs-custom-redirects.yml"
+      - ".readthedocs.yml"
   schedule:
     - cron: 0 0 * * MON # Run every Monday at 00:00 UTC
 
@@ -22,7 +25,6 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: "3.11"
-      - run: pip install httpx pyyaml rich
-      - run: python tools/update-rtd-redirects.py
+      - run: pipx run tools/update-rtd-redirects.py
         env:
           RTD_API_TOKEN: ${{ secrets.RTD_API_TOKEN }}

tools/update-rtd-redirects.py

@@ -3,6 +3,11 @@
 Relevant API reference: https://docs.readthedocs.io/en/stable/api/v3.html#redirects
 """
 
+# /// script
+# requires-python = ">=3.11"
+# dependencies = ["httpx", "rich", "pyyaml"]
+# ///
+
 import operator
 import os
 import sys