🩹 [Patch]: Add debug-logging

scripts/main.ps1

@@ -1,93 +1,108 @@
 [CmdletBinding()]
 param()
 
-$env:PSMODULE_GITHUB_SCRIPT = $true
-Write-Host '┏━━━━━┫ GitHub-Script ┣━━━━━┓'
-Write-Host '::group:: - Setup GitHub PowerShell'
+begin {
+    Write-Debug '[main] - Start'
+}
 
-$Name = 'GitHub'
-$Version = [string]::IsNullOrEmpty($env:GITHUB_ACTION_INPUT_Version) ? $null : $env:GITHUB_ACTION_INPUT_Version
-$Prerelease = $env:GITHUB_ACTION_INPUT_Prerelease -eq 'true'
+process {
+    try {
+        $env:PSMODULE_GITHUB_SCRIPT = $true
+        Write-Host '┏━━━━━┫ GitHub-Script ┣━━━━━┓'
+        Write-Host '::group:: - Setup GitHub PowerShell'
 
-$alreadyInstalled = Get-InstalledPSResource -Name $Name -ErrorAction SilentlyContinue
-if ($Version) {
-    Write-Verbose "Filtering by version: $Version"
-    $alreadyInstalled = $alreadyInstalled | Where-Object Version -EQ $Version
-}
-if ($Prerelease) {
-    Write-Verbose 'Filtering by prerelease'
-    $alreadyInstalled = $alreadyInstalled | Where-Object Prerelease -EQ $Prerelease
-}
-Write-Verbose 'Already installed:'
-$alreadyInstalled | Format-Table
-if (-not $alreadyInstalled) {
-    $params = @{
-        Name            = $Name
-        Repository      = 'PSGallery'
-        TrustRepository = $true
-        Prerelease      = $Prerelease
-    }
-    if ($Version) {
-        $params['Version'] = $Version
-    }
-    $Count = 5
-    $Delay = 10
-    for ($i = 1; $i -le $Count; $i++) {
-        try {
-            Install-PSResource @params
-            break
-        } catch {
-            if ($i -eq $Count) {
-                throw $_
+        $Name = 'GitHub'
+        $Version = [string]::IsNullOrEmpty($env:GITHUB_ACTION_INPUT_Version) ? $null : $env:GITHUB_ACTION_INPUT_Version
+        $Prerelease = $env:GITHUB_ACTION_INPUT_Prerelease -eq 'true'
+
+        $alreadyInstalled = Get-InstalledPSResource -Name $Name -ErrorAction SilentlyContinue
+        if ($Version) {
+            Write-Verbose "Filtering by version: $Version"
+            $alreadyInstalled = $alreadyInstalled | Where-Object Version -EQ $Version
+        }
+        if ($Prerelease) {
+            Write-Verbose 'Filtering by prerelease'
+            $alreadyInstalled = $alreadyInstalled | Where-Object Prerelease -EQ $Prerelease
+        }
+        Write-Verbose 'Already installed:'
+        $alreadyInstalled | Format-Table
+        if (-not $alreadyInstalled) {
+            $params = @{
+                Name            = $Name
+                Repository      = 'PSGallery'
+                TrustRepository = $true
+                Prerelease      = $Prerelease
+            }
+            if ($Version) {
+                $params['Version'] = $Version
+            }
+            $Count = 5
+            $Delay = 10
+            for ($i = 1; $i -le $Count; $i++) {
+                try {
+                    Install-PSResource @params -ErrorAction Stop
+                    break
+                } catch {
+                    Write-Warning $_.Exception.Message
+                    if ($i -eq $Count) {
+                        throw $_
+                    }
+                    Start-Sleep -Seconds $Delay
+                }
             }
-            Start-Sleep -Seconds $Delay
         }
-    }
-}
 
-$alreadyImported = Get-Module -Name $Name
-Write-Verbose 'Already imported:'
-$alreadyImported | Format-Table
-if (-not $alreadyImported) {
-    Write-Verbose "Importing module: $Name"
-    Import-Module -Name $Name
-}
+        $alreadyImported = Get-Module -Name $Name
+        Write-Verbose 'Already imported:'
+        $alreadyImported | Format-Table
+        if (-not $alreadyImported) {
+            Write-Verbose "Importing module: $Name"
+            Import-Module -Name $Name
+        }
 
-$providedToken = -not [string]::IsNullOrEmpty($env:GITHUB_ACTION_INPUT_Token)
-$providedClientID = -not [string]::IsNullOrEmpty($env:GITHUB_ACTION_INPUT_ClientID)
-$providedPrivateKey = -not [string]::IsNullOrEmpty($env:GITHUB_ACTION_INPUT_PrivateKey)
-[pscustomobject]@{
-    Name                  = $Name
-    Version               = [string]::IsNullOrEmpty($Version) ? 'latest' : $Version
-    Prerelease            = $Prerelease
-    'Already installed'   = $null -ne $alreadyInstalled
-    'Already imported'    = $null -ne $alreadyImported
-    'Provided Token'      = $providedToken
-    'Provided ClientID'   = $providedClientID
-    'Provided PrivateKey' = $providedPrivateKey
-} | Format-List
-Write-Host '::endgroup::'
+        $providedToken = -not [string]::IsNullOrEmpty($env:GITHUB_ACTION_INPUT_Token)
+        $providedClientID = -not [string]::IsNullOrEmpty($env:GITHUB_ACTION_INPUT_ClientID)
+        $providedPrivateKey = -not [string]::IsNullOrEmpty($env:GITHUB_ACTION_INPUT_PrivateKey)
+        [pscustomobject]@{
+            Name                  = $Name
+            Version               = [string]::IsNullOrEmpty($Version) ? 'latest' : $Version
+            Prerelease            = $Prerelease
+            'Already installed'   = $null -ne $alreadyInstalled
+            'Already imported'    = $null -ne $alreadyImported
+            'Provided Token'      = $providedToken
+            'Provided ClientID'   = $providedClientID
+            'Provided PrivateKey' = $providedPrivateKey
+        } | Format-List
+        Write-Host '::endgroup::'
 
-LogGroup ' - Installed modules' {
-    Get-InstalledPSResource | Select-Object Name, Version, Prerelease | Sort-Object -Property Name | Format-Table -AutoSize
-}
+        LogGroup ' - Installed modules' {
+            Get-InstalledPSResource | Select-Object Name, Version, Prerelease | Sort-Object -Property Name | Format-Table -AutoSize
+        }
+
+        if ($providedClientID -and $providedPrivateKey) {
+            LogGroup ' - GitHub connection - GitHub App' {
+                Connect-GitHub -ClientID $env:GITHUB_ACTION_INPUT_ClientID -PrivateKey $env:GITHUB_ACTION_INPUT_PrivateKey -Silent -PassThru |
+                    Format-List
+            }
+        } elseif ($providedToken) {
+            LogGroup ' - GitHub connection - Token' {
+                Connect-GitHub -Token $env:GITHUB_ACTION_INPUT_Token -Silent -PassThru |
+                    Format-List
+            }
+        }
+
+        LogGroup ' - Configuration' {
+            Get-GitHubConfig | Format-List
+        }
 
-LogGroup ' - GitHub connection' {
-    if ($providedClientID -and $providedPrivateKey) {
-        Write-Verbose 'Connected using provided GitHub App'
-        Connect-GitHub -ClientID $env:GITHUB_ACTION_INPUT_ClientID -PrivateKey $env:GITHUB_ACTION_INPUT_PrivateKey -Silent
-    } elseif ($providedToken) {
-        Write-Verbose 'Connected using provided token'
-        Connect-GitHub -Token $env:GITHUB_ACTION_INPUT_Token -Silent
+        Write-Host '┗━━━━━━━━━━━━━━━━━━━━━━━━━━━┛'
+    } catch {
+        throw $_
     }
-    Get-GitHubContext | Format-List
 }
 
-LogGroup ' - Configuration' {
-    Get-GitHubConfig | Format-List
+end {
+    Write-Debug '[main] - End'
+    $DebugPreference = $env:GITHUB_ACTION_INPUT_Debug -eq 'true' ? 'Continue' : 'SilentlyContinue'
+    $VerbosePreference = $env:GITHUB_ACTION_INPUT_Verbose -eq 'true' ? 'Continue' : 'SilentlyContinue'
 }
-
-Write-Host '┗━━━━━━━━━━━━━━━━━━━━━━━━━━━┛'
-
-$DebugPreference = $env:GITHUB_ACTION_INPUT_Debug -eq 'true' ? 'Continue' : 'SilentlyContinue'
-$VerbosePreference = $env:GITHUB_ACTION_INPUT_Verbose -eq 'true' ? 'Continue' : 'SilentlyContinue'

scripts/outputs.ps1

@@ -1,31 +1,43 @@
 [CmdletBinding()]
 param()
 
-$DebugPreference = 'SilentlyContinue'
-$VerbosePreference = 'SilentlyContinue'
-
-if ($env:GITHUB_ACTION_INPUT_ShowOutput -ne 'true') {
-    return
-}
-
-$result = (Get-GitHubOutput).result
-if (-not $result) {
-    return
+begin {
+    $DebugPreference = 'SilentlyContinue'
+    $VerbosePreference = 'SilentlyContinue'
+    Write-Debug '[outputs] - Start'
 }
 
-Write-Host '┏━━━━━┫ GitHub-Script ┣━━━━━┓'
-
-LogGroup ' - Outputs' {
-    if ([string]::IsNullOrEmpty($env:GITHUB_ACTION)) {
-        Write-GitHubWarning 'Outputs cannot be accessed as the step has no ID.'
+process {
+    try {
+        Write-Debug "[outputs] - ShowOutput: $env:GITHUB_ACTION_INPUT_ShowOutput"
+        if ($env:GITHUB_ACTION_INPUT_ShowOutput -ne 'true') {
+            return
+        }
+
+        $result = (Get-GitHubOutput).result
+        Write-Debug "[outputs] - Result: $(-not $result)"
+        if (-not $result) {
+            return
+        }
+        Write-Host '┏━━━━━┫ GitHub-Script ┣━━━━━┓'
+        LogGroup ' - Outputs' {
+            if ([string]::IsNullOrEmpty($env:GITHUB_ACTION)) {
+                Write-GitHubWarning 'Outputs cannot be accessed as the step has no ID.'
+            }
+
+            if (-not (Test-Path -Path $env:GITHUB_OUTPUT)) {
+                Write-Warning "File not found: $env:GITHUB_OUTPUT"
+            }
+
+            $result | Format-List
+            Write-Host "Access outputs using `${{ fromJson(steps.$env:GITHUB_ACTION.outputs.result).<output-name> }}"
+        }
+        Write-Host '┗━━━━━━━━━━━━━━━━━━━━━━━━━━━┛'
+    } catch {
+        throw $_
     }
-
-    if (-not (Test-Path -Path $env:GITHUB_OUTPUT)) {
-        Write-Warning "File not found: $env:GITHUB_OUTPUT"
-    }
-
-    $result | Format-List
-    Write-Host "Access outputs using `${{ fromJson(steps.$env:GITHUB_ACTION.outputs.result).<output-name> }}"
 }
 
-Write-Host '┗━━━━━━━━━━━━━━━━━━━━━━━━━━━┛'
+end {
+    Write-Debug '[outputs] - End'
+}