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

Author: MatejKafka

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

@@ -0,0 +1,20 @@
+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. By default, downloads the version matching this GitHub Action ref.'
+    required: false
+    default: 0.12.0
+runs:
+  using: "composite"
+  steps:
+    - shell: pwsh
+      run: |
+        & $env:GITHUB_ACTION_PATH\install-pog.ps1 $env:POG_PATH $env:POG_VERSION
+      env:
+        POG_PATH: ${{ inputs.path }}
+        POG_VERSION: ${{ inputs.version }}

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

@@ -0,0 +1,31 @@
+param(
+        [Parameter(Mandatory)]
+        [string]
+    $PogPath,
+        [Parameter(Mandatory)]
+        [version]
+    $Version
+)
+
+Set-StrictMode -Version 3
+$ErrorActionPreference = "Stop"
+$PSNativeCommandUseErrorActionPreference = $true
+
+$ArchivePath = "${PogPath}.zip"
+$ReleaseUrl = "https://github.com/MatejKafka/Pog/releases/download/v$Version/Pog-v$Version.zip"
+
+Write-Host "Installing Pog v$Version from '$ReleaseUrl'..."
+
+# download Pog
+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"

app/Pog/_scripts/release/build-release.ps1

@@ -43,6 +43,9 @@ try {
 
     cd ./Pog
 
+    # need to store this one before we delete it
+    $GhActionYaml = Get-Content -Raw ./.github/actions/install-pog/action.yml
+
     rm -Recurse @(
         ".github"
         ".gitignore"
@@ -67,6 +70,14 @@ try {
         $PogPackageVersion = (Import-PowerShellDataFile ./pog.psd1).Version
         $PogDllVersion = (Get-Item ./app/Pog/lib_compiled/Pog.dll).VersionInfo.ProductVersion
 
+        if ($GhActionYaml -notmatch "\s+default: (\d+\.\d+\.\d+)`n") {
+            throw "Could not parse 'install-pog' GitHub Action Pog version."
+        }
+
+        if ([version]$Matches[1] -ne $Version) {
+            throw "GitHub Action Pog download version does not match."
+        }
+
         if ($PogPSModuleVersion -ne $Version) {
             throw "Pog.psd1 PS module version does not match."
         }