trial composite nox-cache

Author: bjlittle

.github/workflows/ci-docs-linkcheck.yml

@@ -83,13 +83,10 @@ jobs:
           conda list
 
       - name: "nox cache"
-        uses: actions/cache@v3
-        env:
-          # Increment the build number to force a cache refresh.
-          CACHE_BUILD: 0
+        uses: ./.github/workflows/composite/nox-cache
         with:
-          path: ${{ github.workspace }}/.nox
-          key: ${{ runner.os }}-nox-${{ env.ENV_NAME }}-py${{ matrix.python-version }}-b${{ env.CACHE_BUILD }}-${{ hashFiles(env.LOCK_FILE) }}
+          # Increment the build number to force a cache refresh.
+          cache_build: 0
 
       - name: "iris linkcheck"
         env:

.github/workflows/ci-docs-tests.yml

@@ -122,13 +122,10 @@ jobs:
           python cartopy_feature_download.py physical --output ${CARTOPY_SHARE_DIR} --no-warn
 
       - name: "nox cache"
-        uses: actions/cache@v3
-        env:
-          # Increment the build number to force a cache refresh.
-          CACHE_BUILD: 0
+        uses: ./.github/workflows/composite/nox-cache
         with:
-          path: ${{ github.workspace }}/.nox
-          key: ${{ runner.os }}-nox-${{ env.ENV_NAME }}-py${{ matrix.python-version }}-b${{ env.CACHE_BUILD }}-${{ hashFiles(env.LOCK_FILE) }}
+          # Increment the build number to force a cache refresh.
+          cache_build: 0
 
       - name: "iris configure"
         env:

.github/workflows/ci-tests.yml

@@ -122,13 +122,10 @@ jobs:
           python cartopy_feature_download.py physical --output ${CARTOPY_SHARE_DIR} --no-warn
 
       - name: "nox cache"
-        uses: actions/cache@v3
-        env:
-          # Increment the build number to force a cache refresh.
-          CACHE_BUILD: 0
+        uses: ./.github/workflows/composite/nox-cache
         with:
-          path: ${{ github.workspace }}/.nox
-          key: ${{ runner.os }}-nox-${{ env.ENV_NAME }}-py${{ matrix.python-version }}-b${{ env.CACHE_BUILD }}-${{ hashFiles(env.LOCK_FILE) }}
+          # Increment the build number to force a cache refresh.
+          cache_build: 0
 
       - name: "iris configure"
         env:

.github/workflows/composite/nox-cache/action.yml

@@ -0,0 +1,21 @@
+name: "nox cache"
+description: "cache the nox test environments"
+
+#
+# Assumes the environment contains the following variables:
+#   - ENV_NAME
+#   - LOCK_FILE
+#
+inputs:
+  cache_build:
+    description: "nox cache version build number"
+    required: false
+    default: "0"
+
+runs:
+  using: "composite"
+  steps:
+    - uses: actions/cache@v3
+      with:
+        path: ${{ github.workspace }}/.nox
+        key: ${{ runner.os }}-nox-${{ env.ENV_NAME }}-py${{ matrix.python-version }}-b${{ inputs.cache_build }}-${{ hashFiles(env.LOCK_FILE) }}