20230207B

hugoalh · hugoalh · commit e100c4db4c9b · 2023-02-07T17:41:19.000+08:00
diff --git a/README.md b/README.md
@@ -91,7 +91,6 @@ Import-Module -Name 'hugoalh.GitHubActionsToolkit' -Prefix 'GitHubActions' -Scop
 - `Test-GitHubActionsEnvironment`
 - `Test-GitHubActionsNodeJsEnvironment`
 - `Write-GitHubActionsAnnotation`
-- `Write-GitHubActionsCommand`
 - `Write-GitHubActionsDebug`
 - `Write-GitHubActionsError`
 - `Write-GitHubActionsFail`
diff --git a/hugoalh.GitHubActionsToolkit/module/artifact.psm1 b/hugoalh.GitHubActionsToolkit/module/artifact.psm1
@@ -39,7 +39,7 @@ Function Export-Artifact {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('RetentionDay')][Byte]$RetentionTime
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Artifact)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Artifact)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions artifact resources!' -Category 'ResourceUnavailable'
 		}
@@ -107,7 +107,7 @@ Function Import-Artifact {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Dest', 'Path', 'Target')][String]$Destination = $Env:GITHUB_WORKSPACE
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Artifact)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Artifact)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions artifact resources!' -Category 'ResourceUnavailable'
 		}
diff --git a/hugoalh.GitHubActionsToolkit/module/cache.psm1 b/hugoalh.GitHubActionsToolkit/module/cache.psm1
@@ -42,7 +42,7 @@ Function Restore-Cache {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][ValidateRange(1, 360)][UInt16]$SegmentTimeout = 60
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Cache)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Cache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions cache resources!' -Category 'ResourceUnavailable'
 		}
@@ -108,7 +108,7 @@ Function Save-Cache {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][ValidateRange(1, 16)][Alias('Concurrency')][Byte]$UploadConcurrency
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Cache)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Cache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions cache resources!' -Category 'ResourceUnavailable'
 		}
diff --git a/hugoalh.GitHubActionsToolkit/module/open-id-connect.psm1 b/hugoalh.GitHubActionsToolkit/module/open-id-connect.psm1
@@ -28,7 +28,7 @@ Function Get-OpenIdConnectToken {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('NodeJs', 'NodeJsWrapper', 'UseNodeJs')][Switch]$UseNodeJsWrapper
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -OpenIDConnect)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -OpenIDConnect)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions OpenID Connect (OIDC) resources!' -Category 'ResourceUnavailable'
 		}
diff --git a/hugoalh.GitHubActionsToolkit/module/step-summary.psm1 b/hugoalh.GitHubActionsToolkit/module/step-summary.psm1
@@ -31,7 +31,7 @@ Function Add-StepSummary {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Switch]$NoNewLine
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -StepSummary)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -StepSummary)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions step summary resources!' -Category 'ResourceUnavailable'
 		}
@@ -288,7 +288,7 @@ Function Set-StepSummary {
 		[Switch]$NoNewLine
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -StepSummary)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -StepSummary)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions step summary resources!' -Category 'ResourceUnavailable'
 		}
diff --git a/hugoalh.GitHubActionsToolkit/module/tool-cache.psm1 b/hugoalh.GitHubActionsToolkit/module/tool-cache.psm1
@@ -38,7 +38,7 @@ Function Expand-ToolCacheCompressedFile {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Flags')][String]$Flag
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions tool cache resources!' -Category 'ResourceUnavailable'
 		}
@@ -118,7 +118,7 @@ Function Find-ToolCache {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Arch')][String]$Architecture
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions tool cache resources!' -Category 'ResourceUnavailable'
 		}
@@ -170,7 +170,7 @@ Function Invoke-ToolCacheToolDownloader {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Headers')][Hashtable]$Header
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions tool cache resources!' -Category 'ResourceUnavailable'
 		}
@@ -221,7 +221,7 @@ Function Register-ToolCacheDirectory {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Arch')][String]$Architecture
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions tool cache resources!' -Category 'ResourceUnavailable'
 		}
@@ -271,7 +271,7 @@ Function Register-ToolCacheFile {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Arch')][String]$Architecture
 	)
 	Begin {
-		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, only stop this function but not others.
+		[Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.
 		If ($NoOperation) {
 			Write-Error -Message 'Unable to get GitHub Actions tool cache resources!' -Category 'ResourceUnavailable'
 		}

Original file line number	Diff line number	Diff line change
`@@ -39,7 +39,7 @@ Function Export-Artifact {`
`39`	`39`	`[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('RetentionDay')][Byte]$RetentionTime`
`40`	`40`	`)`
`41`	`41`	`Begin {`
`42`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Artifact)# When the requirements are not fulfill, only stop this function but not others.`
	`42`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Artifact)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`43`	`43`	`If ($NoOperation) {`
`44`	`44`	`Write-Error -Message 'Unable to get GitHub Actions artifact resources!' -Category 'ResourceUnavailable'`
`45`	`45`	`}`
`@@ -107,7 +107,7 @@ Function Import-Artifact {`
`107`	`107`	`[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Dest', 'Path', 'Target')][String]$Destination = $Env:GITHUB_WORKSPACE`
`108`	`108`	`)`
`109`	`109`	`Begin {`
`110`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Artifact)# When the requirements are not fulfill, only stop this function but not others.`
	`110`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Artifact)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`111`	`111`	`If ($NoOperation) {`
`112`	`112`	`Write-Error -Message 'Unable to get GitHub Actions artifact resources!' -Category 'ResourceUnavailable'`
`113`	`113`	`}`
Original file line number	Diff line number	Diff line change
`@@ -42,7 +42,7 @@ Function Restore-Cache {`
`42`	`42`	`[Parameter(ValueFromPipelineByPropertyName = $True)][ValidateRange(1, 360)][UInt16]$SegmentTimeout = 60`
`43`	`43`	`)`
`44`	`44`	`Begin {`
`45`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Cache)# When the requirements are not fulfill, only stop this function but not others.`
	`45`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Cache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`46`	`46`	`If ($NoOperation) {`
`47`	`47`	`Write-Error -Message 'Unable to get GitHub Actions cache resources!' -Category 'ResourceUnavailable'`
`48`	`48`	`}`
`@@ -108,7 +108,7 @@ Function Save-Cache {`
`108`	`108`	`[Parameter(ValueFromPipelineByPropertyName = $True)][ValidateRange(1, 16)][Alias('Concurrency')][Byte]$UploadConcurrency`
`109`	`109`	`)`
`110`	`110`	`Begin {`
`111`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Cache)# When the requirements are not fulfill, only stop this function but not others.`
	`111`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -Cache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`112`	`112`	`If ($NoOperation) {`
`113`	`113`	`Write-Error -Message 'Unable to get GitHub Actions cache resources!' -Category 'ResourceUnavailable'`
`114`	`114`	`}`
Original file line number	Diff line number	Diff line change
`@@ -28,7 +28,7 @@ Function Get-OpenIdConnectToken {`
`28`	`28`	`[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('NodeJs', 'NodeJsWrapper', 'UseNodeJs')][Switch]$UseNodeJsWrapper`
`29`	`29`	`)`
`30`	`30`	`Begin {`
`31`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -OpenIDConnect)# When the requirements are not fulfill, only stop this function but not others.`
	`31`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -OpenIDConnect)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`32`	`32`	`If ($NoOperation) {`
`33`	`33`	`Write-Error -Message 'Unable to get GitHub Actions OpenID Connect (OIDC) resources!' -Category 'ResourceUnavailable'`
`34`	`34`	`}`
Original file line number	Diff line number	Diff line change
`@@ -31,7 +31,7 @@ Function Add-StepSummary {`
`31`	`31`	`[Parameter(ValueFromPipelineByPropertyName = $True)][Switch]$NoNewLine`
`32`	`32`	`)`
`33`	`33`	`Begin {`
`34`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -StepSummary)# When the requirements are not fulfill, only stop this function but not others.`
	`34`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -StepSummary)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`35`	`35`	`If ($NoOperation) {`
`36`	`36`	`Write-Error -Message 'Unable to get GitHub Actions step summary resources!' -Category 'ResourceUnavailable'`
`37`	`37`	`}`
`@@ -288,7 +288,7 @@ Function Set-StepSummary {`
`288`	`288`	`[Switch]$NoNewLine`
`289`	`289`	`)`
`290`	`290`	`Begin {`
`291`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -StepSummary)# When the requirements are not fulfill, only stop this function but not others.`
	`291`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -StepSummary)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`292`	`292`	`If ($NoOperation) {`
`293`	`293`	`Write-Error -Message 'Unable to get GitHub Actions step summary resources!' -Category 'ResourceUnavailable'`
`294`	`294`	`}`
Original file line number	Diff line number	Diff line change
`@@ -38,7 +38,7 @@ Function Expand-ToolCacheCompressedFile {`
`38`	`38`	`[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Flags')][String]$Flag`
`39`	`39`	`)`
`40`	`40`	`Begin {`
`41`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, only stop this function but not others.`
	`41`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`42`	`42`	`If ($NoOperation) {`
`43`	`43`	`Write-Error -Message 'Unable to get GitHub Actions tool cache resources!' -Category 'ResourceUnavailable'`
`44`	`44`	`}`
`@@ -118,7 +118,7 @@ Function Find-ToolCache {`
`118`	`118`	`[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Arch')][String]$Architecture`
`119`	`119`	`)`
`120`	`120`	`Begin {`
`121`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, only stop this function but not others.`
	`121`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`122`	`122`	`If ($NoOperation) {`
`123`	`123`	`Write-Error -Message 'Unable to get GitHub Actions tool cache resources!' -Category 'ResourceUnavailable'`
`124`	`124`	`}`
`@@ -170,7 +170,7 @@ Function Invoke-ToolCacheToolDownloader {`
`170`	`170`	`[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Headers')][Hashtable]$Header`
`171`	`171`	`)`
`172`	`172`	`Begin {`
`173`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, only stop this function but not others.`
	`173`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`174`	`174`	`If ($NoOperation) {`
`175`	`175`	`Write-Error -Message 'Unable to get GitHub Actions tool cache resources!' -Category 'ResourceUnavailable'`
`176`	`176`	`}`
`@@ -221,7 +221,7 @@ Function Register-ToolCacheDirectory {`
`221`	`221`	`[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Arch')][String]$Architecture`
`222`	`222`	`)`
`223`	`223`	`Begin {`
`224`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, only stop this function but not others.`
	`224`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`225`	`225`	`If ($NoOperation) {`
`226`	`226`	`Write-Error -Message 'Unable to get GitHub Actions tool cache resources!' -Category 'ResourceUnavailable'`
`227`	`227`	`}`
`@@ -271,7 +271,7 @@ Function Register-ToolCacheFile {`
`271`	`271`	`[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('Arch')][String]$Architecture`
`272`	`272`	`)`
`273`	`273`	`Begin {`
`274`		`- [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, only stop this function but not others.`
	`274`	`+ [Boolean]$NoOperation = !(Test-GitHubActionsEnvironment -ToolCache)# When the requirements are not fulfill, use this variable to skip this function but keep continue invoke the script.`
`275`	`275`	`If ($NoOperation) {`
`276`	`276`	`Write-Error -Message 'Unable to get GitHub Actions tool cache resources!' -Category 'ResourceUnavailable'`
`277`	`277`	`}`