public/driver_gh.ps1
|
Set-MyinvokeCommandAlias -Alias GetToken -Command "gh auth token" <# .SYNOPSIS Retrieves a GitHub organization project with fields. .DESCRIPTION This is an integration function that is not intended to be used directly by the user. It fetches project details including fields and items from a GitHub organization project. .EXAMPLE Invoke-GitHubOrgProjectWithFields -Owner "someOwner" -ProjectNumber 164 #> function Invoke-GitHubOrgProjectWithFields { param( [Parameter(Mandatory=$true)] [string]$Owner, [Parameter(Mandatory=$true)] [string]$ProjectNumber, [Parameter(Mandatory=$false)] [string]$afterFields = $null, [Parameter(Mandatory=$false)] [int]$firstFields = 100, [Parameter(Mandatory=$false)] [string]$afterItems = $null, [Parameter(Mandatory=$false)] [int]$firstItems = 100 ) # Use the environmentraviable $token = Get-GithubToken if(-not $token){ throw "GH Cli Auth Token not available. Run 'gh auth login' in your terminal." } # Define the GraphQL query with variables $qlPath = $PSScriptRoot | Join-Path -ChildPath "graphql" -AdditionalChildPath "orgprojectwithfieldsAndItems.query" $query = get-content -path $qlPath | Out-String # Define the headers for the request $headers = @{ "Authorization" = "Bearer $token" "Content-Type" = "application/json" } # Define the variables for the request [int]$pn = $ProjectNumber $variables = @{ login = $Owner number = $pn afterFields = $afterFields afterItems = $afterItems firstFields = $firstFields firstItems = $firstItems } # Define the body for the request $body = @{ query = $query variables = $variables } | ConvertTo-Json # Send the request $response = Invoke-RestMethod -Uri 'https://api.github.com/graphql' -Method Post -Body $body -Headers $headers # Check if here are errors if($response.errors){ "[$($response.errors[0].type)] $($response.errors[0].message)" | Write-MyError return } # Return the field names return $response } Export-ModuleMember -Function Invoke-GitHubOrgProjectWithFields <# .SYNOPSIS Invokes a GitHub organization project query .DESCRIPTION This is an integration function that is not intended to be used directly by the user. Retrieves information about a GitHub organization project using GraphQL. #> function Invoke-GitHubOrgProject{ [CmdletBinding()] param( [Parameter(Mandatory=$true)] [string]$Owner, [Parameter(Mandatory=$true)] [string]$ProjectNumber ) return InvokeGitHubOrgProject -Owner $Owner -ProjectNumber $ProjectNumber -QueryFileName "orgproject.query" } Export-ModuleMember -Function Invoke-GitHubOrgProject function InvokeGitHubOrgProject { param( [Parameter(Mandatory=$true)] [string]$Owner, [Parameter(Mandatory=$true)] [string]$ProjectNumber, [Parameter(Mandatory=$false)] [string]$QueryFileName, [Parameter(Mandatory=$false)] [string]$afterFields = $null, [Parameter(Mandatory=$false)] [string]$afterItems = $null ) # Use the environmentraviable $token = Get-GithubToken if(-not $token){ throw "GH Cli Auth Token not available. Run 'gh auth login' in your terminal." } # Define the GraphQL query with variables $qlPath = $PSScriptRoot | Join-Path -ChildPath "graphql" -AdditionalChildPath $QueryFileName $query = get-content -path $qlPath | Out-String # Define the headers for the request $headers = @{ "Authorization" = "Bearer $token" "Content-Type" = "application/json" } # Define the variables for the request [int]$pn = $ProjectNumber $variables = @{ login = $Owner number = $pn afterFields = $afterFields afterItems = $afterItems firstFields = 100 firstItems = 100 } # Define the body for the request $body = @{ query = $query variables = $variables } | ConvertTo-Json # Send the request $response = Invoke-RestMethod -Uri 'https://api.github.com/graphql' -Method Post -Body $body -Headers $headers # Check if here are errors if($response.errors){ "[$($response.errors[0].type)] $($response.errors[0].message)" | Write-MyError return } # Return the field names return $response } <# .SYNOPSIS Updates item values in a GitHub project .DESCRIPTION This is an integration function that is not intended to be used directly by the user. Updates the values of specific fields for an item in a GitHub project. #> function Invoke-GitHubUpdateItemValues{ param( [Parameter(Mandatory=$true)] [string]$ProjectId, [Parameter(Mandatory=$true)] [string]$ItemId, [Parameter(Mandatory=$true)] [string]$FieldId, [Parameter(Mandatory=$true)] [object]$Value, [Parameter(Mandatory=$true)] [ValidateSet("singleSelectOptionId", "text", "number", "date", "iterationId")] [string]$Type ) # Use the environmentraviable $token = Get-GithubToken if(-not $token){ throw "GH Cli Auth Token not available. Run 'gh auth login' in your terminal." } # Define the GraphQL query with variables $qlPath = $PSScriptRoot | Join-Path -ChildPath "graphql" -AdditionalChildPath "updateItemValues.mutant" $mutation = get-content -path $qlPath | Out-String # Define the headers for the request $headers = @{ "Authorization" = "Bearer $token" "Content-Type" = "application/json" } # Ensure that if the $type is number the value is a number # API fails if when updaring a number the value type in the Input payload s not a number if($Type -eq "number"){ $Value = [decimal]$Value } # Define the variables for the request $variables = @{ input = @{ projectId = $ProjectId itemId = $ItemId fieldId = $FieldId value = @{ $Type=$Value } } } # Define the body for the request $body = @{ query= $mutation variables = $variables } | ConvertTo-Json -Depth 10 # Send the request $response = Invoke-RestMethod -Uri 'https://api.github.com/graphql' -Method Post -Body $body -Headers $headers # Check if here are errors if($response.errors){ $response.errors | ForEach-Object { "RESPONSE Type[$($_.type)] $($_.message)" | Write-MyError } return $null } # Return the field names return $response } Export-ModuleMember -Function Invoke-GitHubUpdateItemValues <# .SYNOPSIS Gets issue or pull request information .DESCRIPTION This is an integration function that is not intended to be used directly by the user. Retrieves detailed information about an issue or pull request from GitHub. #> function Invoke-GetIssueOrPullRequest{ param( [Parameter(Mandatory)] [string] $Url ) # Use the environmentraviable $token = Get-GithubToken if(-not $token){ throw "GH Cli Auth Token not available. Run 'gh auth login' in your terminal." } # Define the GraphQL query with variables $qlPath = $PSScriptRoot | Join-Path -ChildPath "graphql" -AdditionalChildPath "getIssueOrPullRequest.query" $query = get-content -path $qlPath | Out-String # Define the headers for the request $headers = @{ "Authorization" = "Bearer $token" "Content-Type" = "application/json" } # Define the variables for the request $variables = @{ url = $Url } # Define the body for the request $body = @{ query = $query variables = $variables } | ConvertTo-Json # Send the request $response = Invoke-RestMethod -Uri 'https://api.github.com/graphql' -Method Post -Body $body -Headers $headers # Check if here are errors if($response.errors){ "[$($response.errors[0].type)] $($response.errors[0].message)" | Write-MyError return } # Return the field names return $response } Export-ModuleMember -Function Invoke-GetIssueOrPullRequest # function Invoke-GetIContentId { # param( # [Parameter(Mandatory)] [string] $Url # ) # # Use the environmentraviable # $token = Get-GithubToken # if(-not $token){ # throw "GH Cli Auth Token not available. Run 'gh auth login' in your terminal." # } # # Define the GraphQL query with variables # $qlPath = $PSScriptRoot | Join-Path -ChildPath "graphql" -AdditionalChildPath "getContentId.query" # $query = get-content -path $qlPath | Out-String # # Define the headers for the request # $headers = @{ # "Authorization" = "Bearer $token" # "Content-Type" = "application/json" # } # # get owner, reponame and issue number from the URL # $repoOwner, $repoName, [int] $issueNumber = Get-RepoOwnerNameNumberFromUrl -Url $Url # # Define the variables for the request # $variables = @{ # owner = $repoOwner # name = $repoName # number = $issueNumber # } # # Define the body for the request # $body = @{ # query = $query # variables = $variables # } | ConvertTo-Json # # Send the request # $response = Invoke-RestMethod -Uri 'https://api.github.com/graphql' -Method Post -Body $body -Headers $headers # # Check if here are errors # if($response.errors){ # "[$($response.errors[0].type)] $($response.errors[0].message)" | Write-MyError # return # } # # Return the field names # return $response # } Export-ModuleMember -Function Invoke-GetIContentId <# .SYNOPSIS Adds an item to a GitHub project .DESCRIPTION This is an integration function that is not intended to be used directly by the user. Adds a GitHub issue or pull request to a project board. #> function Invoke-AddItemToProject{ param( [Parameter(Mandatory=$true)] [string]$ProjectId, [Parameter(Mandatory=$true)] [string]$ContentId ) # Use the environmentraviable $token = Get-GithubToken if(-not $token){ throw "GH Cli Auth Token not available. Run 'gh auth login' in your terminal." } # Define the GraphQL query with variables $qlPath = $PSScriptRoot | Join-Path -ChildPath "graphql" -AdditionalChildPath "addItemToProject.mutant" $mutation = get-content -path $qlPath | Out-String # Define the headers for the request $headers = @{ "Authorization" = "Bearer $token" "Content-Type" = "application/json" } # Define the variables for the request $variables = @{ input = @{ projectId = $ProjectId contentId = $ContentId } } # Define the body for the request $body = @{ query= $mutation variables = $variables } | ConvertTo-Json -Depth 10 # Send the request $response = Invoke-RestMethod -Uri 'https://api.github.com/graphql' -Method Post -Body $body -Headers $headers # Check if here are errors if($response.errors){ $response.errors | ForEach-Object { "RESPONSE Type[$($_.type)] $($_.message)" | Write-MyError } return $null } # Return the field names return $response } Export-ModuleMember -Function Invoke-AddItemToProject <# .SYNOPSIS Removes an item from a GitHub project .DESCRIPTION This is an integration function that is not intended to be used directly by the user. Removes a GitHub issue or pull request from a project board. #> function Invoke-RemoveItemFromProject{ param( [Parameter(Mandatory=$true)] [string]$ProjectId, [Parameter(Mandatory=$true)] [string]$ItemId ) # Use the environmentraviable $token = Get-GithubToken if(-not $token){ throw "GH Cli Auth Token not available. Run 'gh auth login' in your terminal." } # Define the GraphQL query with variables $qlPath = $PSScriptRoot | Join-Path -ChildPath "graphql" -AdditionalChildPath "removeItemFromProject.mutant" $mutation = get-content -path $qlPath | Out-String # Define the headers for the request $headers = @{ "Authorization" = "Bearer $token" "Content-Type" = "application/json" } # Define the variables for the request $variables = @{ input = @{ projectId = $ProjectId itemId = $ItemId } } # Define the body for the request $body = @{ query= $mutation variables = $variables } | ConvertTo-Json -Depth 10 # Send the request $response = Invoke-RestMethod -Uri 'https://api.github.com/graphql' -Method Post -Body $body -Headers $headers # Check if here are errors if($response.errors){ $response.errors | ForEach-Object { "RESPONSE Type[$($_.type)] $($_.message)" | Write-MyError } return $null } # Return the field names return $response } Export-ModuleMember -Function Invoke-RemoveItemFromProject <# .SYNOPSIS Gets a GitHub authentication token .DESCRIPTION Retrieves a GitHub authentication token using the GitHub CLI. #> function Get-GithubToken{ [CmdletBinding()] param() $token = Invoke-MyCommand -Command GetToken if(-not $token){ throw "Token not available. Check `gh auth token` output." } return $token } |