module/tool-cache.psm1
|
#Requires -PSEdition Core -Version 7.2 Import-Module -Name @( (Join-Path -Path $PSScriptRoot -ChildPath 'internal\nodejs-wrapper.psm1') ) -Prefix 'GitHubActions' -Scope 'Local' <# .SYNOPSIS GitHub Actions - Expand Tool Cache Compressed File .DESCRIPTION Expand an archive or a compressed file. .PARAMETER File Path of the archive or the compressed file. .PARAMETER Destination Path for the expand destination. .PARAMETER Method Method to expand the archive or the compressed file; Define this parameter will enforce to use the defined method. .PARAMETER 7zrPath Literal path of the 7zr application, for long path support (only when parameter `Method` is `7z`). Most of the `.7z` archives do not have this problem, if `.7z` archive contains very long path, pass the path to 7zr which will gracefully handle long paths, by default 7zdec is used because it is a very small program and is bundled with the GitHub Actions NodeJS toolkit, however it does not support long paths, 7zr is the reduced command line interface, it is smaller than the full command line interface, and it does support long paths, at the time of this writing, it is freely available from the LZMA SDK that is available on the 7-Zip website, be sure to check the current license agreement, if 7zr is bundled with your action, then the path to 7zr can be pass to this function. .PARAMETER Flag Flags to use for expand (only when parameter `Method` is `Tar` or `Xar`). .OUTPUTS [String] Absolute path of the expand destination. #> Function Expand-ToolCacheCompressedFile { [CmdletBinding(HelpUri = 'https://github.com/hugoalh-studio/ghactions-toolkit-powershell/wiki/api_function_expandgithubactionstoolcachecompressedfile')] [OutputType([String])] Param ( [Parameter(Mandatory = $True, Position = 0, ValueFromPipeline = $True, ValueFromPipelineByPropertyName = $True)][ValidatePattern('^.+$', ErrorMessage = 'Value is not a single line string!')][Alias('Source')][String]$File, [Parameter(ValueFromPipelineByPropertyName = $True)][ValidatePattern('^.+$', ErrorMessage = 'Value is not a single line string!')][Alias('Target')][String]$Destination, [Parameter(ValueFromPipelineByPropertyName = $True)][ValidateSet('7z', 'Tar', 'Xar', 'Zip')][String]$Method, [String]$7zrPath, [Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Flags')][String[]]$Flag ) Process { If (!(Test-Path -LiteralPath $File -PathType 'Leaf')) { Write-Error -Message "``$File`` is not a valid and exist file path!" -Category 'ResourceUnavailable' Return } If ($Method.Length -eq 0) { Switch -RegEx ($File) { '\.7z$' { $Method = '7z' Break } '\.pkg$' { $Method = 'Xar' Break } '\.t(?:ar(?:\.gz)?|gz)$' { $Method = 'Tar' Break } '\.zip$' { $Method = 'Zip' Break } Default { $Method = '7z' Break } } } [Hashtable]$Argument = @{ 'file' = $File } If ($Destination.Length -gt 0) { $Argument.('destination') = $Destination } If ($7zrPath.Length -gt 0) { $Argument.('7zrPath') = $7zrPath } If ($Flag.Count -gt 0) { $Argument.('flags') = $Flag } Invoke-GitHubActionsNodeJsWrapper -Name "tool-cache/extract-$($Method.ToLower())" -Argument $Argument | Write-Output } } Set-Alias -Name 'Expand-ToolCacheArchive' -Value 'Expand-ToolCacheCompressedFile' -Option 'ReadOnly' -Scope 'Local' <# .SYNOPSIS GitHub Actions - Find Tool Cache .DESCRIPTION Find the path of a tool in the local installed tool cache. .PARAMETER Name Name of the tool. .PARAMETER Version Version of the tool, by Semantic Versioning (SemVer); Default to all of the versions. .PARAMETER Architecture Architecture of the tool; Default to the architecture of the current machine. .OUTPUTS [String] Absolute path of a version of a tool. [String[]] Absolute path of all of the versions of a tool. #> Function Find-ToolCache { [CmdletBinding(DefaultParameterSetName = 'All', HelpUri = 'https://github.com/hugoalh-studio/ghactions-toolkit-powershell/wiki/api_function_findgithubactionstoolcache')] [OutputType([String], ParameterSetName = 'Single')] [OutputType([String[]], ParameterSetName = 'All')] Param ( [Parameter(Mandatory = $True, Position = 0, ValueFromPipeline = $True, ValueFromPipelineByPropertyName = $True)][ValidatePattern('^.+$', ErrorMessage = 'Value is not a single line string!')][Alias('ToolName')][String]$Name, [Parameter(Mandatory = $True, ParameterSetName = 'Single', ValueFromPipelineByPropertyName = $True)][SemVer]$Version, [Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Arch')][String]$Architecture ) Process { [Hashtable]$Argument = @{ 'name' = $Name } If ($Architecture.Length -gt 0) { $Argument.('architecture') = $Architecture } If ($PSCmdlet.ParameterSetName -ieq 'All') { Invoke-GitHubActionsNodeJsWrapper -Name 'tool-cache/find-all-versions' -Argument $Argument | Write-Output } Else { $Argument.('version') = $Version.ToString() Invoke-GitHubActionsNodeJsWrapper -Name 'tool-cache/find' -Argument $Argument | Write-Output } } } <# .SYNOPSIS GitHub Actions - Invoke Tool Cache Tool Downloader .DESCRIPTION Download a tool from URI and stream it into a file. .PARAMETER Uri URI of the tool. .PARAMETER Destination Path for the tool destination. .PARAMETER Authorization Authorization of the URI request. .PARAMETER Headers Headers of the URI request. .OUTPUTS [String] Absolute path of the downloaded tool. #> Function Invoke-ToolCacheToolDownloader { [CmdletBinding(HelpUri = 'https://github.com/hugoalh-studio/ghactions-toolkit-powershell/wiki/api_function_invokegithubactionstoolcachetooldownloader')] [OutputType([String])] Param ( [Parameter(Mandatory = $True, Position = 0, ValueFromPipeline = $True, ValueFromPipelineByPropertyName = $True)][ValidateScript({ $Null -ine $_.AbsoluteUri -and $_.Scheme -imatch '^https?$' }, ErrorMessage = '`{0}` is not a valid URI!')][Alias('Source', 'Url')][Uri]$Uri, [Parameter(ValueFromPipelineByPropertyName = $True)][ValidatePattern('^.+$', ErrorMessage = 'Value is not a single line string!')][Alias('Target')][String]$Destination, [Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Auth')][String]$Authorization, [Parameter(ValueFromPipelineByPropertyName = $True)][Hashtable]$Headers = @{} ) Process { [Hashtable]$Argument = @{ 'url' = $Uri.OriginalString() } If ($Destination.Length -gt 0) { $Argument.('destination') = $Destination } If ($Authorization.Length -gt 0) { $Argument.('authorization') = $Authorization } If ($Headers.Count -gt 0) { $Argument.('headers') = $Headers } Invoke-GitHubActionsNodeJsWrapper -Name 'tool-cache/download-tool' -Argument $Argument | Write-Output } } <# .SYNOPSIS GitHub Actions - Register Tool Cache Directory .DESCRIPTION Register a tool directory to cache and install in the tool cache. .PARAMETER Source Path of the tool directory. .PARAMETER Name Name for the tool. .PARAMETER Version Version for the tool, by Semantic Versioning (SemVer). .PARAMETER Architecture Architecture for the tool; Default to the architecture of the current machine. .OUTPUTS [String] Absolute path of the tool cached. #> Function Register-ToolCacheDirectory { [CmdletBinding(HelpUri = 'https://github.com/hugoalh-studio/ghactions-toolkit-powershell/wiki/api_function_registergithubactionstoolcachedirectory')] [OutputType([String])] Param ( [Parameter(Mandatory = $True, Position = 0, ValueFromPipelineByPropertyName = $True)][ValidatePattern('^.+$', ErrorMessage = 'Value is not a single line string!')][Alias('SourceDirectory')][String]$Source, [Parameter(Mandatory = $True, Position = 1, ValueFromPipelineByPropertyName = $True)][ValidatePattern('^.+$', ErrorMessage = 'Value is not a single line string!')][Alias('ToolName')][String]$Name, [Parameter(Mandatory = $True, Position = 2, ValueFromPipelineByPropertyName = $True)][SemVer]$Version, [Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Arch')][String]$Architecture ) Process { [Hashtable]$Argument = @{ 'source' = $Source 'name' = $Name 'version' = $Version.ToString() } If ($Architecture.Length -gt 0) { $Argument.('architecture') = $Architecture } Invoke-GitHubActionsNodeJsWrapper -Name 'tool-cache/cache-directory' -Argument $Argument | Write-Output } } <# .SYNOPSIS GitHub Actions - Register Tool Cache File .DESCRIPTION Register a tool file to cache and install in the tool cache. .PARAMETER Source Path of the tool file. .PARAMETER Target Path for the tool file in the tool cache. .PARAMETER Name Name for the tool. .PARAMETER Version Version for the tool, by Semantic Versioning (SemVer). .PARAMETER Architecture Architecture for the tool; Default to the architecture of the current machine. .OUTPUTS [String] Absolute path of the tool cached. #> Function Register-ToolCacheFile { [CmdletBinding(HelpUri = 'https://github.com/hugoalh-studio/ghactions-toolkit-powershell/wiki/api_function_registergithubactionstoolcachefile')] [OutputType([String])] Param ( [Parameter(Mandatory = $True, Position = 0, ValueFromPipelineByPropertyName = $True)][ValidatePattern('^.+$', ErrorMessage = 'Value is not a single line string!')][Alias('SourceFile')][String]$Source, [Parameter(Mandatory = $True, Position = 1, ValueFromPipelineByPropertyName = $True)][ValidatePattern('^.+$', ErrorMessage = 'Value is not a single line string!')][Alias('TargetFile')][String]$Target, [Parameter(Mandatory = $True, Position = 2, ValueFromPipelineByPropertyName = $True)][ValidatePattern('^.+$', ErrorMessage = 'Value is not a single line string!')][Alias('ToolName')][String]$Name, [Parameter(Mandatory = $True, Position = 3, ValueFromPipelineByPropertyName = $True)][SemVer]$Version, [Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Arch')][String]$Architecture ) Process { [Hashtable]$Argument = @{ 'source' = $Source 'target' = $Target 'name' = $Name 'version' = $Version.ToString() } If ($Architecture.Length -gt 0) { $Argument.('architecture') = $Architecture } Invoke-GitHubActionsNodeJsWrapper -Name 'tool-cache/cache-file' -Argument $Argument | Write-Output } } Export-ModuleMember -Function @( 'Expand-ToolCacheCompressedFile', 'Find-ToolCache', 'Invoke-ToolCacheToolDownloader', 'Register-ToolCacheDirectory', 'Register-ToolCacheFile' ) -Alias @( 'Expand-ToolCacheArchive' ) |