Add function Get-WorkflowRunUri

Author: hugoalh

README.md

@@ -60,6 +60,7 @@ Import-Module -Name 'hugoalh.GitHubActionsToolkit' -Prefix 'GitHubActions' -Scop
 - `Get-GitHubActionsState`
 - `Get-GitHubActionsStepSummary`
 - `Get-GitHubActionsWebhookEventPayload`
+- `Get-GitHubActionsWorkflowRunUri`
 - `Remove-GitHubActionsProblemMatcher`
 - `Remove-GitHubActionsStepSummary`
 - `Set-GitHubActionsEnvironmentVariable`

hugoalh.GitHubActionsToolkit/hugoalh.GitHubActionsToolkit.psd1

@@ -77,6 +77,7 @@
 		'Get-State',
 		'Get-StepSummary',
 		'Get-WebhookEventPayload',
+		'Get-WorkflowRunUri',
 		'Remove-ProblemMatcher',
 		'Remove-StepSummary',
 		'Set-EnvironmentVariable',
@@ -138,6 +139,7 @@
 		'Get-Payload',
 		'Get-WebhookEvent',
 		'Get-WebhookPayload',
+		'Get-WorkflowRunUrl',
 		'Restore-State',
 		'Save-State',
 		'Set-Env',

hugoalh.GitHubActionsToolkit/module/utility.psm1

@@ -89,6 +89,21 @@ Set-Alias -Name 'Get-WebhookEvent' -Value 'Get-WebhookEventPayload' -Option 'Rea
 Set-Alias -Name 'Get-WebhookPayload' -Value 'Get-WebhookEventPayload' -Option 'ReadOnly' -Scope 'Local'
 <#
 .SYNOPSIS
+GitHub Actions - Get Workflow Run URI
+.DESCRIPTION
+Get the workflow run's URI.
+.OUTPUTS
+String
+#>
+function Get-WorkflowRunUri {
+	[CmdletBinding(HelpUri = 'https://github.com/hugoalh-studio/ghactions-toolkit-powershell/wiki/api_function_get-githubactionsworkflowrunuri#Get-GitHubActionsWorkflowRunUri')]
+	[OutputType([String])]
+	param ()
+	return "$env:GITHUB_SERVER_URL/$env:GITHUB_REPOSITORY/actions/runs/$env:GITHUB_RUN_ID"
+}
+Set-Alias -Name 'Get-WorkflowRunUrl' -Value 'Get-WorkflowRunUri' -Option 'ReadOnly' -Scope 'Local'
+<#
+.SYNOPSIS
 GitHub Actions - Test Environment
 .DESCRIPTION
 Test the current process whether is executing inside the GitHub Actions environment.
@@ -148,12 +163,14 @@ Export-ModuleMember -Function @(
 	'Add-SecretMask',
 	'Get-IsDebug',
 	'Get-WebhookEventPayload',
+	'Get-WorkflowRunUri',
 	'Test-Environment'
 ) -Alias @(
 	'Add-Mask',
 	'Add-Secret',
 	'Get-Event',
 	'Get-Payload',
 	'Get-WebhookEvent',
-	'Get-WebhookPayload'
+	'Get-WebhookPayload',
+	'Get-WorkflowRunUrl'
 )