From 00a77196a8268491eaf68f33f5db16f75bd629ee Mon Sep 17 00:00:00 2001
From: Tim Heap <tim.heap@csiro.au>
Date: Mon, 18 May 2026 13:18:40 +1000
Subject: [PATCH] Cache GSHHS shapefiles in CI

The UoH server is kinda slow!
---
 .github/workflows/ci.yaml | 32 ++++++++++++++++++++++++++++++--
 1 file changed, 30 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 7f930330..7a38c50f 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -158,11 +158,39 @@ jobs:
           extras: docs
           package-artifact-name: ${{ needs.build.outputs.artifact-name }}
 
-      - run: |
+      - name: Set up cartopy cache directories
+        id: cartopy
+        run: |
+          export CARTOPY_DATA_DIR="$RUNNER_TEMP/cartopy"
+          echo "CARTOPY_DATA_DIR=$CARTOPY_DATA_DIR" >> $GITHUB_ENV
+          python3 -c 'from importlib.metadata import version; v=version("cartopy"); print(f"version={v}\n")' >> $GITHUB_OUTPUT
+          python3 -c 'import cartopy; d=cartopy.config["data_dir"]; print(f"data-dir={d}\n")' >> $GITHUB_OUTPUT
+          echo "Setting cartopy cache directory to $CARTOPY_DATA_DIR"
+        env:
+          RUNNER_TEMP: ${{ runner.temp }}
+
+      - name: Restore cartopy cached assets
+        uses: actions/cache@v5
+        with:
+          key: cartopy-data-dir-${{ steps.cartopy.outputs.version }}
+          path: ${{ env.CARTOPY_DATA_DIR }}
+
+      - name: Build docs
+        run: |
           cd docs/
           sphinx-build -b dirhtml -aEW . _build/dirhtml
 
-      - uses: actions/upload-artifact@v4
+      - name: Store compiled docs artifact
+        uses: actions/upload-artifact@v4
         with:
           name: Docs
           path: docs/_build/dirhtml
+
+      - name: Copy downloaded cartopy files to cache
+        run: |
+          if [[ -d "$CARTOPY_CACHE" ]] ; then
+            echo "$CARTOPY_CACHE exists, copying to $CARTOPY_DATA_DIR"
+            cp -RT "$CARTOPY_CACHE" "$CARTOPY_DATA_DIR"
+          fi
+        env:
+          CARTOPY_CACHE: ${{ steps.cartopy.outputs.data-dir }}