Public/Get-GitHubRelease.ps1
|
Function Get-GitHubRelease { <# .SYNOPSIS Returns latest version and URI from a GitHub repository release list. .DESCRIPTION Returns latest version and URI from a GitHub repository release list. The releases URI is expected in the following format: https://api.github.com/repos/<account>/<repository>/releases/latest. More information on the GitHub releases API can be found here: https://developer.github.com/v3/repos/releases/. .NOTES Author: Aaron Parker Twitter: @stealthpuppy .LINK https://github.com/aaronparker/Evergreen .EXAMPLE Get-GitHubRelease -Uri "https://api.github.com/repos/Open-Shell/Open-Shell-Menu/releases/latest" Description: Returns version and download URIs from the supplied GitHub repository URL. #> [OutputType([System.Management.Automation.PSObject])] [CmdletBinding()] Param( [Parameter(Mandatory = $False, Position = 0)] [ValidateScript( { If ($_ -match "^(https://api\.github\.com/repos/)([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)(/releases/latest)$") { $True } else { Throw "'$_' must be in the format 'https://api.github.com/repos/user/repository/releases/latest'. Replace 'user' with the user or organisation and 'repository' with the target repository name." } })] [System.String] $Uri = "https://api.github.com/repos/atom/atom/releases/latest" ) # Get application resource strings from its manifest $res = Get-FunctionResource -AppName ("$($MyInvocation.MyCommand)".Split("-"))[1] # If -Uri isn't used, we'll use the default value to show at least something If (-not($PSBoundParameters.ContainsKey('Uri'))) { Write-Warning -Message "$($MyInvocation.MyCommand): -Uri parameter not specified. Using the default repository." } # Get latest version and download latest release via GitHub API $iwcParams = @{ Uri = $Uri ContentType = $res.Get.ContentType } $Content = Invoke-WebContent @iwcParams # Convert the returned release data into a useable object with Version, URI etc. $object = ConvertFrom-GitHubReleasesJson -Content $Content -MatchVersion $res.Get.MatchVersion Write-Output -InputObject $object } |