Add automatic testing of the d.p.o redirects via Hurl (#505)

* Split d.p.o redirects to a new config file

* Add header note

* Add Hurl specs

* Add CI testing

* fix fix merge conflictf

---------

Co-authored-by: Ee Durbin <[email protected]>
Co-authored-by: Ee Durbin <[email protected]>

Author: AA-Turner

.github/workflows/docs-redirects.yml

@@ -0,0 +1,46 @@
+name: Test d.p.o redirects
+
+on:
+  push:
+    paths:
+      - ".github/workflows/docs-redirects.yml"
+      - "salt/docs/**"
+      - "tests/docs-redirects/**"
+  pull_request:
+    paths:
+      - ".github/workflows/docs-redirects.yml"
+      - "salt/docs/**"
+      - "tests/docs-redirects/**"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+env:
+  FORCE_COLOR: "1"
+
+jobs:
+  docs-redirects:
+    name: Hurl
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Download Hurl ${{ env.HURL_VERSION }}
+      run: > 
+        curl --no-progress-meter --location --fail
+        --proto '=https' --tlsv1.2
+        --output '/tmp/hurl.deb' 
+        "https://github.com/Orange-OpenSource/hurl/releases/download/${{ env.HURL_VERSION }}/hurl_${{ env.HURL_VERSION }}_amd64.deb"
+      env:
+        HURL_VERSION: "5.0.1"
+
+    - name: Install Hurl
+      run: sudo apt install --yes /tmp/hurl.deb
+
+    - name: Run tests
+      run: bash tests/docs-redirects/test.sh

salt/docs/config/nginx.docs-redirects.conf

@@ -1,5 +1,6 @@
 # This file contains redirect configuration for docs.python.org.
-# It is included by ``nginx.docs-backend.conf``.
+# It is included by ``nginx.docs-backend.conf``,
+# and tested in ``tests/docs-redirects/``.
 
 # Python 3 docs are the default at the root.
 location = / {

tests/docs-redirects/nginx.conf

@@ -0,0 +1,4 @@
+server {
+    listen 10000;
+    include docs-redirects.conf;
+}