Get-GitPubRelease.ps.ps1
|
function Get-GitPubRelease { <# .SYNOPSIS Gets GitHub Releases as Posts .DESCRIPTION Gets GitHub Releases as Posts. The release content will be considered the body of the post. #> [Reflection.AssemblyMetaData("GitPub.Source",$true)] param( # The GitHub Username or Organization. [Alias('Owner')] [string] $UserName, # The repository [Parameter(Mandatory)] [Alias('Repo')] [string] $Repository, # One or more tags used for releases. # By default, `release`. [string[]] $ReleaseTag = 'release', # The GitHub Access token. # If this is not provided, $env:GITHUB_TOKEN is present, $env:GITHUB_TOKEN will be used. [Alias('PersonalAccessToken','GitHubPat', 'PAT')] [string] $GitHubAccessToken ) process { $invokeSplat = @{ Headers = @{} } if (-not $GitHubAccessToken -and $env:GITHUB_TOKEN) { $GitHubAccessToken = $env:GITHUB_TOKEN } if ($GitHubAccessToken) { $invokeSplat.Headers.Authentication = "Bearer $gitHubAccessToken" } if ($Repository -like '*/*' -and -not $UserName) { $UserName, $Repository = $Repository -split '\/', 2 } if (-not $UserName) { Write-Error "Must Provide -UserName or provide -Repository in the form username/repository" return } $releases = https://api.github.com/repos/$UserName/$repository/releases @invokeSplat foreach ($rel in $releases) { $rel | Add-Member NoteProperty 'Tags' @($ReleaseTag) -Force [decorate('GitPub.Post.Release',Clear)]$rel [decorate('GitPub.Post',PassThru)]$rel } } } |