action.yml

name: 'Download and untar an artifact, preserving permissions'
description: 'Download a build artifact that was previously uploaded in the workflow by the gha-upload-tar-artifact action, with permissions preserved.'
author: 'The Browser Company of New York'

inputs:
  name:
    description: 'The name of the artifact to download.'
    default: 'artifact'
    required: true
  path:
    description: 'Destination path. Defaults to $GITHUB_WORKSPACE.'
    default: ${{ github.workspace }}

  outputs:
    download-path:
      description: 'Path of artifact download'

runs:
  using: composite

  steps:
    - name: Create Temporary Directory
      shell: pwsh
      id: create-temp-dir
      run: |
        $TempDir = New-TemporaryFile | % { Remove-Item $_; New-Item -ItemType Directory -Path $_ }
        echo "temp-dir=$TempDir" >> $env:GITHUB_OUTPUT

    - name: Download Artifact
      uses: actions/download-artifact@v4
      with:
        name: ${{ inputs.name }}
        path: ${{ steps.create-temp-dir.outputs.temp-dir }}

    - name: Extract Tar Archive
      shell: pwsh
      id: extract-tar
      run: |
        New-Item -ItemType Directory -Path "${{ inputs.path }}" -Force | Out-Null
        $TarFile = Join-Path "${{ steps.create-temp-dir.outputs.temp-dir }}" "${{ inputs.name }}.tar"
        $tar = if ($IsWindows) { "${env:WINDIR}\System32\tar.exe" } else { "tar" }
        & $tar xf $TarFile -C ${{ inputs.path }}

    - name: Delete Temporary Directory
      shell: pwsh
      run: Remove-Item -Recurse ${{ steps.create-temp-dir.outputs.temp-dir }}

    - name: Export Output
      shell: pwsh
      run: |
        Write-Output "download-path=${{ inputs.path }}" >> $env:GITHUB_OUTPUT