CI: Publish a GitHub Action to install Pog to a pipeline

Author: MatejKafka

.github/actions/install-pog/action.yml

@@ -0,0 +1,21 @@
+name: 'Install Pog'
+description: 'Install the Pog package manager (https://github.com/MatejKafka/Pog).'
+inputs:
+  path:
+    description: 'Path to the directory where Pog is installed.'
+    required: false
+    default: D:\Pog
+  version:
+    description: 'Pog version to install. Defaults to the latest available version.'
+    required: false
+runs:
+  using: "composite"
+  steps:
+    - name: Install Pog
+      shell: pwsh
+      run: |
+        $GitHubToken = ConvertTo-SecureString -AsPlainText -Force "${{ secrets.GITHUB_TOKEN }}"
+        & $env:GITHUB_ACTION_PATH\install-pog.ps1 $env:POG_PATH -GitHubToken $GitHubToken
+      env:
+        POG_PATH: ${{ inputs.path }}
+        POG_VERSION: ${{ inputs.version }}

.github/actions/install-pog/install-pog.ps1

@@ -0,0 +1,32 @@
+param(
+        [Parameter(Mandatory)]
+        [string]
+    $PogPath,
+        [version]
+    $Version,
+        [securestring]
+    $GithubToken
+)
+
+Set-StrictMode -Version 3
+$ErrorActionPreference = "Stop"
+$PSNativeCommandUseErrorActionPreference = $true
+
+$ExtraArgs = if ($GitHubToken) {@{Authentication = "Bearer"; Token = $GitHubToken}}
+$Endpoint = if ($Version) {"tags/v$Version"} else {"latest"}
+$ReleaseUrl = (Invoke-RestMethod @ExtraArgs "https://api.github.com/repos/MatejKafka/Pog/releases/$Endpoint").assets.browser_download_url
+
+Write-Host "Installing Pog from '$ReleaseUrl'..."
+$ArchivePath = "${PogPath}.zip"
+iwr $ReleaseUrl -OutFile $ArchivePath
+
+# unpack Pog, tar is much faster than Expand-Archive
+$null = mkdir $PogPath
+tar -xf $ArchivePath --directory $PogPath
+
+# setup Pog
+& $PogPath\Pog\setup.ps1 -Enable None
+
+# propagate PATH and PSModulePath for the following steps
+Add-Content $env:GITHUB_PATH (Resolve-Path $PogPath\Pog\data\package_bin)
+Add-Content $env:GITHUB_ENV "PSModulePath=$env:PSModulePath"