20230628A

Author: hugoalh

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -18,6 +18,7 @@ body:
       description: "What versions are affected? Versions must be listed as supported in the Security Policy (file: `SECURITY.md`)."
       multiple: true
       options:
+        - "v1.6.0-beta.1"
         - "v1.5.0"
         - "v1.4.1"
         - "v1.4.0"

SECURITY.md

@@ -13,8 +13,9 @@
 
 | **Versions** | **Status** | **Target - GitHub Actions Runner** | **Target - PowerShell** | **Target - NodeJS (Wrapper API)** | **Target - NPM (Wrapper API)** |
 |:-:|:-:|:-:|:-:|:-:|:-:|
-| v1.5.X | L | >= v2.303.0 | >= v7.2.0 | >= v14.15.0 | *N/A* |
-| v1.4.X | L | >= v2.303.0 | >= v7.2.0 | >= v14.15.0 | *N/A* |
+| v1.6.X | L | >= v2.303.0 | >= v7.2.0 | >= v14.15.0 | *N/A* |
+| v1.5.X | ✔ | >= v2.303.0 | >= v7.2.0 | >= v14.15.0 | *N/A* |
+| v1.4.X | ✔ | >= v2.303.0 | >= v7.2.0 | >= v14.15.0 | *N/A* |
 | v1.3.X | ❌{🐛🧓} | *Unspecified* | >= v7.2.0 | >= v14.15.0 | >= v6.14.8 |
 | v1.2.0 \~ v1.3.1 | ❌{🐛🧓} | *Unspecified* | >= v7.2.0 | >= v14.15.0 | *N/A* |
 | < v1.2.0 | ❌{🐛🧓} | *Unspecified* | >= v7.2.0 | >= v14.15.0 | >= v6.14.8 |

hugoalh.GitHubActionsToolkit/hugoalh.GitHubActionsToolkit.psd1

@@ -3,7 +3,7 @@
 	RootModule = 'hugoalh.GitHubActionsToolkit.psm1'
 
 	# Version number of this module.
-	ModuleVersion = '1.5.0'
+	ModuleVersion = '1.6.0'
 
 	# Supported PSEditions
 	# CompatiblePSEditions = @()
@@ -72,10 +72,10 @@
 		'Add-StepSummarySuperscriptText',
 		'ConvertFrom-CsvM',
 		'ConvertFrom-CsvS',
-		'Disable-EchoingCommands',
-		'Disable-ProcessingCommands',
-		'Enable-EchoingCommands',
-		'Enable-ProcessingCommands',
+		'Disable-StdOutCommandEcho',
+		'Disable-StdOutCommandProcess',
+		'Enable-StdOutCommandEcho',
+		'Enable-StdOutCommandProcess',
 		'Enter-LogGroup',
 		'Exit-LogGroup',
 		'Expand-ToolCacheCompressedFile',
@@ -139,9 +139,11 @@
 		'Disable-EchoCommand',
 		'Disable-EchoCommands',
 		'Disable-EchoingCommand',
+		'Disable-EchoingCommands',
 		'Disable-ProcessCommand',
 		'Disable-ProcessCommands',
 		'Disable-ProcessingCommand',
+		'Disable-ProcessingCommands',
 		'Enable-CommandEcho',
 		'Enable-CommandEchoing',
 		'Enable-CommandProcess',
@@ -153,9 +155,11 @@
 		'Enable-EchoCommand',
 		'Enable-EchoCommands',
 		'Enable-EchoingCommand',
+		'Enable-EchoingCommands',
 		'Enable-ProcessCommand',
 		'Enable-ProcessCommands',
 		'Enable-ProcessingCommand',
+		'Enable-ProcessingCommands',
 		'Enter-Group',
 		'Exit-Group',
 		'Expand-ToolCacheArchive',
@@ -173,6 +177,8 @@
 		'Import-Cache',
 		'Restore-Artifact',
 		'Restore-State',
+		'Resume-CommandProcess',
+		'Resume-StdOutCommandProcess',
 		'Save-Artifact',
 		'Save-State',
 		'Set-Env',
@@ -193,6 +199,8 @@
 		'Start-ProcessCommands',
 		'Start-ProcessingCommand',
 		'Start-ProcessingCommands',
+		'Start-StdOutCommandEcho',
+		'Start-StdOutCommandProcess',
 		'Stop-CommandEcho',
 		'Stop-CommandEchoing',
 		'Stop-CommandProcess',
@@ -209,6 +217,10 @@
 		'Stop-ProcessCommands',
 		'Stop-ProcessingCommand',
 		'Stop-ProcessingCommands',
+		'Stop-StdOutCommandEcho',
+		'Stop-StdOutCommandProcess',
+		'Suspend-CommandProcess',
+		'Suspend-StdOutCommandProcess',
 		'Write-Command',
 		'Write-Note',
 		'Write-Warn'
@@ -254,7 +266,7 @@
 			ReleaseNotes = '(Please visit https://github.com/hugoalh-studio/ghactions-toolkit-powershell/releases.)'
 
 			# Prerelease string of this module
-			# Prerelease = ''
+			Prerelease = 'beta1'
 
 			# Flag to indicate whether the module requires explicit user acceptance for install/update/save
 			RequireLicenseAcceptance = $False

hugoalh.GitHubActionsToolkit/module/artifact.psm1

@@ -34,7 +34,7 @@ Function Export-Artifact {
 		[Parameter(Mandatory = $True, ParameterSetName = 'LiteralPath', ValueFromPipelineByPropertyName = $True)][Alias('LiteralFile', 'LiteralFiles', 'LiteralPaths', 'LP', 'PSPath', 'PSPaths')][String[]]$LiteralPath,
 		[Parameter(ValueFromPipelineByPropertyName = $True)][ValidateScript({ [System.IO.Path]::IsPathRooted($_) -and (Test-Path -LiteralPath $_ -PathType 'Container') }, ErrorMessage = '`{0}` is not an exist and valid directory!')][Alias('Root')][String]$BaseRoot = $Env:GITHUB_WORKSPACE,
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('ContinueOnError')][Switch]$ContinueOnIssue,
-		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('RetentionDay')][UInt16]$RetentionTime
+		[Parameter(ValueFromPipelineByPropertyName = $True)][ValidateRange(1, [Int16]::MaxValue)][Alias('RetentionDay')][Int16]$RetentionTime
 	)
 	Process {
 		Switch ($PSCmdlet.ParameterSetName) {

hugoalh.GitHubActionsToolkit/module/command-control.psm1

@@ -278,7 +278,7 @@ Set-Alias -Name 'Write-Note' -Value 'Write-Notice' -Option 'ReadOnly' -Scope 'Lo
 .SYNOPSIS
 GitHub Actions - Write Raw
 .DESCRIPTION
-Print anything to the log without accidentally execute any commands.
+Print anything to the log without accidentally execute any stdout command.
 .PARAMETER InputObject
 Item that need to log.
 .PARAMETER GroupTitle

hugoalh.GitHubActionsToolkit/module/log.psm1

@@ -1,6 +1,6 @@
 {
 	"name": "@hugoalh/ghactions-toolkit-powershell-nodejs-wrapper",
-	"version": "1.5.0",
+	"version": "1.6.0-beta.1",
 	"description": "A PowerShell module to provide a better and easier way for GitHub Actions to communicate with the runner machine, and the toolkit for developing GitHub Actions in PowerShell.",
 	"keywords": [
 		"gh-actions",

hugoalh.GitHubActionsToolkit/module/nodejs-wrapper/main.js

@@ -81,8 +81,8 @@ Function Expand-ToolCacheCompressedFile {
 	}
 }
 Set-Alias -Name 'Expand-ToolCacheArchive' -Value 'Expand-ToolCacheCompressedFile' -Option 'ReadOnly' -Scope 'Local'
-Set-Alias -Name 'Expand-ToolCacheCompressedArchive' -Value 'Expand-ToolCacheCompressedFile' -Option 'ReadOnly' -Scope 'Local'
-Set-Alias -Name 'Expand-ToolCacheFile' -Value 'Expand-ToolCacheCompressedFile' -Option 'ReadOnly' -Scope 'Local'
+Set-Alias -Name 'Expand-ToolCacheCompressedArchive' -Value 'Expand-ToolCacheCompressedFile' -Option 'ReadOnly' -Scope 'Local'# Deprecated.
+Set-Alias -Name 'Expand-ToolCacheFile' -Value 'Expand-ToolCacheCompressedFile' -Option 'ReadOnly' -Scope 'Local'# Deprecated.
 <#
 .SYNOPSIS
 GitHub Actions - Find Tool Cache
@@ -103,7 +103,7 @@ Function Find-ToolCache {
 	[OutputType(([String], [String[]]))]
 	Param (
 		[Parameter(Mandatory = $True, Position = 0, ValueFromPipeline = $True, ValueFromPipelineByPropertyName = $True)][Alias('ToolName')][String]$Name,
-		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('V', 'Ver')][SemVer]$Version,
+		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('V', 'Ver')][String]$Version,
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Arch')][String]$Architecture
 	)
 	Process {

hugoalh.GitHubActionsToolkit/module/nodejs-wrapper/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hugoalh/ghactions-toolkit-powershell-nodejs-wrapper",
-	"version": "1.5.0",
+	"version": "1.6.0-beta.1",
 	"description": "A PowerShell module to provide a better and easier way for GitHub Actions to communicate with the runner machine, and the toolkit for developing GitHub Actions in PowerShell.",
 	"keywords": [
 		"gh-actions",