feat: add "append-items" input

.github/workflows/test-hosted-runners.yml

@@ -25,7 +25,7 @@ jobs:
       uses: actions/checkout@v4
 
     - name: Generate files
-      run: mkdir artifact && mkdir artifact2 && cd artifact && ../script/new-artifact.sh
+      run: mkdir artifact && mkdir artifact2 && cd artifact && ../script/new-artifact.sh && cd .. && cp -R artifact artifact3 && mkdir artifact4
       shell: bash
 
     - name: Upload Pages artifact
@@ -50,10 +50,32 @@ jobs:
 
     - name: Compare files
       run: |
-        rm artifact/.hidden
+        rm -r -f artifact/.hidden*
         diff -qr artifact artifact2
       shell: bash
 
     - name: Check for absence of symlinks
       run: if [ $(find artifact2 -type l | wc -l) != 0 ]; then echo "Symlinks found"; exit 1; fi
       shell: bash
+
+    - name: Upload Pages artifact appended
+      uses: ./
+      with:
+        name: pages-artifact-appended-${{ matrix.os }}
+        path: artifact3
+        append-items: .hidden .hidden2
+
+    - name: Download artifact appended
+      uses: actions/download-artifact@v4
+      with:
+          name: pages-artifact-appended-${{ matrix.os }}
+          path: artifact4
+
+    - name: Extract artifact appended
+      run: tar -xf artifact4/artifact.tar -C artifact4 && rm artifact4/artifact.tar
+      shell: bash
+
+    - name: Compare files appended
+      run: |
+        diff -qr artifact3 artifact4
+      shell: bash

README.md

@@ -48,6 +48,7 @@ jobs:
 | `name`           | `false`   | `github-pages` | Artifact name                                      |
 | `path`           | `true`    | `_site/`       | Path of the directory containing the static assets |
 | `retention-days` | `false`   | `1`            | Duration after which artifact will expire in days  |
+| `append`         | `false`   | ``             | Append files and folders                           |
 
 ### Outputs 📤
 

action.yml

@@ -14,6 +14,11 @@ inputs:
     description: "Duration after which artifact will expire in days."
     required: false
     default: "1"
+  append-items:
+    description: "Append files and directories."
+    required: false
+    default: ""
+
 outputs:
   artifact_id:
     description: "The ID of the artifact that was uploaded."
@@ -34,9 +39,17 @@ runs:
           --exclude=.github \
           --exclude=".[^/]*" \
           .
+        if [ -n "$APPEND_ITEMS" ]; then
+          tar \
+            --dereference --hard-dereference \
+            --directory "$INPUT_PATH" \
+            -rvf "$RUNNER_TEMP/artifact.tar" \
+            $APPEND_ITEMS
+        fi
         echo ::endgroup::
       env:
         INPUT_PATH: ${{ inputs.path }}
+        APPEND_ITEMS: ${{ inputs.append-items }}
 
     # Switch to gtar (GNU tar instead of bsdtar which is the default in the MacOS runners so we can use --hard-dereference)
     - name: Archive artifact
@@ -52,9 +65,17 @@ runs:
           --exclude=.github \
           --exclude=".[^/]*" \
           .
+        if [ -n "$APPEND_ITEMS" ]; then
+          gtar \
+            --dereference --hard-dereference \
+            --directory "$INPUT_PATH" \
+            -rvf "$RUNNER_TEMP/artifact.tar" \
+            $APPEND_ITEMS
+        fi
         echo ::endgroup::
       env:
         INPUT_PATH: ${{ inputs.path }}
+        APPEND_ITEMS: ${{ inputs.append-items }}
 
     # Massage the paths for Windows only
     - name: Archive artifact
@@ -71,9 +92,18 @@ runs:
           --exclude=".[^/]*" \
           --force-local \
           "."
+          if [ -n "$APPEND_ITEMS" ]; then
+            tar \
+              --dereference --hard-dereference \
+              --directory "$INPUT_PATH" \
+              -rvf "$RUNNER_TEMP\artifact.tar" \
+              --force-local \
+              $APPEND_ITEMS
+          fi
         echo ::endgroup::
       env:
         INPUT_PATH: ${{ inputs.path }}
+        APPEND_ITEMS: ${{ inputs.append-items }}
 
     - name: Upload artifact
       id: upload-artifact

script/new-artifact.sh

@@ -9,5 +9,6 @@ echo 'world' > subdir/world.txt
 ln -s subdir subdir-link
 ln -s hello.txt bonjour.txt
 
-# Create some hidden files
+# Create some hidden files or folders
 echo 'foo' > .hidden
+mkdir -p .hidden2 && echo 'bar' > .hidden2/bar