🩹[Patch]: Add a Set-GitHubRepository function

examples/Repositories.ps1

@@ -0,0 +1,21 @@
+$param = @{
+    Name        = 'test-repo2'
+    Description = 'This is a test repository'
+    Visibility  = 'Public'
+    AddReadme   = $true
+    GitIgnore   = 'VisualStudio'
+    License     = 'mit'
+    HasIssues   = $true
+    HasWiki     = $false
+    HasProjects = $false
+}
+
+New-GitHubRepository @param -Debug
+
+$repo = Get-GitHubRepository -Name 'test-repo2'
+$repo2 = Update-GitHubRepository -Name 'test-repo2' -Homepage 'https://example123.com'
+
+$diff = $repo | Compare-PSCustomObject $repo2 -OnlyChanged
+$diff.Property | Should -BeIn ('Homepage', 'UpdatedAt')
+
+

examples/Repositories/Set-GitHubRepository.ps1

@@ -0,0 +1,10 @@
+$params = @{
+    Owner                  = 'octocat'
+    Name                   = 'Hello-World'
+    AllowSquashMergingWith = 'Pull request title and description'
+    HasIssues              = $true
+    SuggestUpdateBranch    = $true
+    AllowAutoMerge         = $true
+    DeleteBranchOnMerge    = $true
+}
+Set-GitHubRepository @params

src/classes/public/Environment/GitHubEnvironment.ps1

@@ -32,7 +32,6 @@
         $this.ID = $Object.id
         $this.NodeID = $Object.node_id
         $this.Name = $Object.name
-        $this.Url = $Object.html_url
         $this.Owner = $Owner
         $this.Repository = $Repository
         $this.CreatedAt = $Object.created_at

src/classes/public/Repositories/GitHubRepository.ps1

@@ -67,6 +67,10 @@
     # Example: true
     [System.Nullable[bool]] $HasDiscussions
 
+    # Whether sponsorships are enabled.
+    # Example: false
+    [System.Nullable[bool]] $HasSponsorships
+
     # Indicates whether the repository is archived.
     # Example: false
     [System.Nullable[bool]] $IsArchived
@@ -175,10 +179,7 @@
     [GithubRepository] $TemplateRepository
 
     # The repository this repository was forked from.
-    [GithubRepository] $ForkParent
-
-    # The ultimate source for the fork network.
-    [GithubRepository] $ForkSource
+    [GithubRepository] $ForkRepository
 
     # Custom properties for the repository.
     [PSCustomObject] $CustomProperties
@@ -213,6 +214,7 @@
         HasProjects              = 'hasProjectsEnabled'
         HasWiki                  = 'hasWikiEnabled'
         HasDiscussions           = 'hasDiscussionsEnabled'
+        HasSponsorships          = 'hasSponsorshipsEnabled'
         IsArchived               = 'isArchived'
         IsTemplate               = 'isTemplate'
         IsFork                   = 'isFork'
@@ -239,8 +241,7 @@
         MergeCommitTitle         = 'mergeCommitTitle'
         MergeCommitMessage       = 'mergeCommitMessage'
         TemplateRepository       = 'templateRepository { id databaseId name owner { login } }'
-        ForkParent               = 'parent { name owner { login } }'
-        ForkSource               = 'parent { name owner { login } }'
+        ForkRepository           = 'parent { id databaseId name owner { login }  }'
         CustomProperties         = ''
         CloneUrl                 = 'url'
         SshUrl                   = 'sshUrl'
@@ -297,8 +298,7 @@
             $this.MergeCommitTitle = $Object.merge_commit_title
             $this.CustomProperties = $Object.custom_properties
             $this.TemplateRepository = $null -ne $Object.template_repository ? [GitHubRepository]::New($Object.template_repository) : $null
-            $this.ForkParent = $null -ne $Object.parent ? [GitHubRepository]::New($Object.parent) : $null
-            $this.ForkSource = $null -ne $Object.source ? [GitHubRepository]::New($Object.source) : $null
+            $this.ForkRepository = $null -ne $Object.parent ? [GitHubRepository]::New($Object.parent) : $null
             $this.CloneUrl = $Object.clone_url
             $this.SshUrl = $Object.ssh_url
             $this.GitUrl = $Object.git_url
@@ -323,6 +323,7 @@
             $this.HasProjects = $Object.hasProjectsEnabled
             $this.HasWiki = $Object.hasWikiEnabled
             $this.HasDiscussions = $Object.hasDiscussionsEnabled
+            $this.HasSponsorships = $Object.hasSponsorshipsEnabled
             $this.IsArchived = $Object.isArchived
             $this.IsTemplate = $Object.isTemplate
             $this.IsFork = $Object.isFork
@@ -349,8 +350,7 @@
             $this.MergeCommitTitle = $Object.mergeCommitTitle
             $this.MergeCommitMessage = $Object.mergeCommitMessage
             $this.TemplateRepository = $null -ne $Object.templateRepository ? [GitHubRepository]::New($Object.templateRepository) : $null
-            $this.ForkParent = $null -ne $Object.parent ? [GitHubRepository]::New($Object.parent) : $null
-            $this.ForkSource = $null -ne $Object.source ? [GitHubRepository]::New($Object.source) : $null
+            $this.ForkRepository = $null -ne $Object.parent ? [GitHubRepository]::New($Object.parent) : $null
             $this.CloneUrl = -not [string]::IsNullOrEmpty($Object.url) ? $Object.url + '.git' : $null
             $this.SshUrl = $Object.sshUrl
             $this.GitUrl = -not [string]::IsNullOrEmpty($Object.url) ? ($Object.Url + '.git').Replace('https://', 'git://') : $null

src/formats/GitHubEnvironment.Format.ps1xml

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Configuration>
+    <ViewDefinitions>
+        <View>
+            <Name>GitHubEnvironmentTable</Name>
+            <ViewSelectedBy>
+                <TypeName>GitHubEnvironment</TypeName>
+            </ViewSelectedBy>
+            <TableControl>
+                <TableHeaders>
+                    <TableColumnHeader>
+                        <Label>Name</Label>
+                    </TableColumnHeader>
+                    <TableColumnHeader>
+                        <Label>Repository</Label>
+                    </TableColumnHeader>
+                    <TableColumnHeader>
+                        <Label>Owner</Label>
+                    </TableColumnHeader>
+                    <TableColumnHeader>
+                        <Label>Url</Label>
+                    </TableColumnHeader>
+                </TableHeaders>
+                <TableRowEntries>
+                    <TableRowEntry>
+                        <TableColumnItems>
+                            <TableColumnItem>
+                                <PropertyName>Name</PropertyName>
+                            </TableColumnItem>
+                            <TableColumnItem>
+                                <PropertyName>Repository</PropertyName>
+                            </TableColumnItem>
+                            <TableColumnItem>
+                                <PropertyName>Owner</PropertyName>
+                            </TableColumnItem>
+                            <TableColumnItem>
+                                <PropertyName>Url</PropertyName>
+                            </TableColumnItem>
+                        </TableColumnItems>
+                    </TableRowEntry>
+                </TableRowEntries>
+            </TableControl>
+        </View>
+    </ViewDefinitions>
+</Configuration>

src/functions/private/Environments/Get-GitHubEnvironmentByName.ps1

@@ -88,7 +88,9 @@ filter Get-GitHubEnvironmentByName {
         }
         try {
             Invoke-GitHubAPI @inputObject | ForEach-Object {
-                [GitHubEnvironment]::new($_.Response, $Owner, $Repository)
+                $environment = [GitHubEnvironment]::new($_.Response, $Owner, $Repository)
+                $environment.Url = "https://$($Context.HostName)/$Owner/$Repository/settings/environments/$($environment.ID)/edit"
+                $environment
             }
         } catch {
             return

src/functions/private/Environments/Get-GitHubEnvironmentList.ps1

@@ -83,7 +83,9 @@ filter Get-GitHubEnvironmentList {
 
         Invoke-GitHubAPI @inputObject | ForEach-Object {
             $_.Response.environments | ForEach-Object {
-                [GitHubEnvironment]::new($_, $Owner, $Repository)
+                $environment = [GitHubEnvironment]::new($_, $Owner, $Repository)
+                $environment.Url = "https://$($Context.HostName)/$Owner/$Repository/settings/environments/$($environment.ID)/edit"
+                $environment
             }
         }
     }

src/functions/private/Repositories/Get-GitHubMyRepositoryByName.ps1

@@ -48,6 +48,7 @@
             'HasProjects',
             'HasWiki',
             'HasDiscussions',
+            'HasSponsorships',
             'IsArchived',
             'IsTemplate',
             'IsFork',
@@ -74,8 +75,7 @@
             'MergeCommitTitle',
             'MergeCommitMessage',
             'TemplateRepository',
-            'ForkParent',
-            'ForkSource',
+            'ForkRepository',
             'CustomProperties',
             'CloneUrl',
             'SshUrl',

src/functions/private/Repositories/Get-GitHubRepositoryByName.ps1

@@ -51,6 +51,7 @@
             'HasProjects',
             'HasWiki',
             'HasDiscussions',
+            'HasSponsorships',
             'IsArchived',
             'IsTemplate',
             'IsFork',
@@ -77,8 +78,7 @@
             'MergeCommitTitle',
             'MergeCommitMessage',
             'TemplateRepository',
-            'ForkParent',
-            'ForkSource',
+            'ForkRepository',
             'CustomProperties',
             'CloneUrl',
             'SshUrl',

src/functions/public/API/Invoke-GitHubAPI.ps1

@@ -107,12 +107,15 @@ filter Invoke-GitHubAPI {
     begin {
         $stackPath = Get-PSCallStackPath
         Write-Debug "[$stackPath] - Start"
+        $debug = $DebugPreference -eq 'Continue'
         $Context = Resolve-GitHubContext -Context $Context
-        Write-Debug 'Invoking GitHub API...'
-        Write-Debug 'Parent function parameters:'
-        Get-FunctionParameter -Scope 1 | Format-List | Out-String -Stream | ForEach-Object { Write-Debug $_ }
-        Write-Debug 'Parameters:'
-        Get-FunctionParameter | Format-List | Out-String -Stream | ForEach-Object { Write-Debug $_ }
+        if ($debug) {
+            Write-Debug 'Invoking GitHub API...'
+            Write-Debug 'Parent function parameters:'
+            Get-FunctionParameter -Scope 1 | Format-List | Out-String -Stream | ForEach-Object { Write-Debug $_ }
+            Write-Debug 'Parameters:'
+            Get-FunctionParameter | Format-List | Out-String -Stream | ForEach-Object { Write-Debug $_ }
+        }
     }
 
     process {
@@ -124,13 +127,15 @@ filter Invoke-GitHubAPI {
         $RetryCount = Resolve-GitHubContextSetting -Name 'RetryCount' -Value $RetryCount -Context $Context
         $RetryInterval = Resolve-GitHubContextSetting -Name 'RetryInterval' -Value $RetryInterval -Context $Context
         $TokenType = Resolve-GitHubContextSetting -Name 'TokenType' -Value $TokenType -Context $Context
-        [pscustomobject]@{
-            Token       = $Token
-            HttpVersion = $HttpVersion
-            ApiBaseUri  = $ApiBaseUri
-            ApiVersion  = $ApiVersion
-            TokenType   = $TokenType
-        } | Format-List | Out-String -Stream | ForEach-Object { Write-Debug $_ }
+        if ($debug) {
+            [pscustomobject]@{
+                Token       = $Token
+                HttpVersion = $HttpVersion
+                ApiBaseUri  = $ApiBaseUri
+                ApiVersion  = $ApiVersion
+                TokenType   = $TokenType
+            } | Format-List | Out-String -Stream | ForEach-Object { Write-Debug $_ }
+        }
         $jwt = $null
         switch ($TokenType) {
             'ghu' {
@@ -190,10 +195,19 @@ filter Invoke-GitHubAPI {
         }
 
         try {
-            Write-Debug '----------------------------------'
-            Write-Debug 'Request:'
-            [pscustomobject]$APICall | Format-List | Out-String -Stream | ForEach-Object { Write-Debug $_ }
-            Write-Debug '----------------------------------'
+            if ($debug) {
+                Write-Debug '----------------------------------'
+                Write-Debug 'Request:'
+                [pscustomobject]$APICall | Select-Object -ExcludeProperty Body, Headers | Format-List |
+                    Out-String -Stream | ForEach-Object { Write-Debug $_ }
+                Write-Debug '----------------------------------'
+                Write-Debug 'Request headers:'
+                [pscustomobject]$APICall.Headers | Select-Object * | Format-List | Out-String -Stream | ForEach-Object { Write-Debug $_ }
+                Write-Debug '----------------------------------'
+                Write-Debug 'Request body:'
+                ($APICall.Body | Out-String).Split('\n') -split '\n' | ForEach-Object { Write-Debug $_ }
+                Write-Debug '----------------------------------'
+            }
             do {
                 switch ($TokenType) {
                     'ghu' {
@@ -209,7 +223,7 @@ filter Invoke-GitHubAPI {
                         }
                     }
                 }
-                $response = Invoke-WebRequest @APICall -ProgressAction 'SilentlyContinue'
+                $response = Invoke-WebRequest @APICall -ProgressAction 'SilentlyContinue' -Debug:$false -Verbose:$false
 
                 $headers = @{}
                 foreach ($item in $response.Headers.GetEnumerator()) {
@@ -233,13 +247,15 @@ filter Invoke-GitHubAPI {
                         ($headers.'github-authentication-token-expiration').Replace('UTC', '').Trim()
                     ).ToLocalTime().ToString('s')
                 }
-                Write-Debug '----------------------------------'
-                Write-Debug 'Response headers:'
-                $headers | Out-String -Stream | ForEach-Object { Write-Debug $_ }
-                Write-Debug '---------------------------'
-                Write-Debug 'Response:'
-                $response | Out-String -Stream | ForEach-Object { Write-Debug $_ }
-                Write-Debug '---------------------------'
+                if ($debug) {
+                    Write-Debug '----------------------------------'
+                    Write-Debug 'Response:'
+                    $response | Select-Object -ExcludeProperty Content, Headers | Out-String -Stream | ForEach-Object { Write-Debug $_ }
+                    Write-Debug '---------------------------'
+                    Write-Debug 'Response headers:'
+                    $headers | Out-String -Stream | ForEach-Object { Write-Debug $_ }
+                    Write-Debug '---------------------------'
+                }
                 switch -Regex ($headers.'Content-Type') {
                     'application/.*json' {
                         $results = $response.Content | ConvertFrom-Json
@@ -253,6 +269,19 @@ filter Invoke-GitHubAPI {
                     }
                 }
 
+                if ($debug) {
+                    Write-Debug 'Response content:'
+                    $results | ConvertTo-Json -Depth 5 -WarningAction SilentlyContinue | Out-String -Stream | ForEach-Object {
+                        $content = $_
+                        $content = $content -split '\n'
+                        $content = $content.Split('\n')
+                        foreach ($item in $content) {
+                            Write-Debug $item
+                        }
+                    }
+                    Write-Debug '---------------------------'
+                }
+
                 [pscustomobject]@{
                     Request           = $APICall
                     Response          = $results
@@ -264,7 +293,12 @@ filter Invoke-GitHubAPI {
             } while ($APICall['Uri'])
         } catch {
             $failure = $_
-            $failure | Out-String -Stream | ForEach-Object { Write-Debug $_ }
+            if ($debug) {
+                Write-Debug '----------------------------------'
+                Write-Debug 'Failure:'
+                $failure | Out-String -Stream | ForEach-Object { Write-Debug $_ }
+                Write-Debug '----------------------------------'
+            }
             $headers = @{}
             foreach ($item in $failure.Exception.Response.Headers.GetEnumerator()) {
                 $headers[$item.Key] = ($item.Value).Trim() -join ', '
@@ -287,9 +321,11 @@ filter Invoke-GitHubAPI {
             }
             $sortedProperties = $headers.PSObject.Properties.Name | Sort-Object
             $headers = $headers | Select-Object $sortedProperties
-            Write-Debug 'Response headers:'
-            $headers | Out-String -Stream | ForEach-Object { Write-Debug $_ }
-            Write-Debug '---------------------------'
+            if ($debug) {
+                Write-Debug 'Response headers:'
+                $headers | Out-String -Stream | ForEach-Object { Write-Debug $_ }
+                Write-Debug '---------------------------'
+            }
 
             $errordetails = $failure.ErrorDetails | ConvertFrom-Json -AsHashtable
             $errors = $errordetails.errors
@@ -307,9 +343,15 @@ filter Invoke-GitHubAPI {
             $exception = @"
 ----------------------------------
 Request:
-$([pscustomobject]$APICall | Format-List -Property Headers, HttpVersion, Method, Uri, ContentType, Authentication, Token | Out-String)
+$([pscustomobject]$APICall | Select-Object -ExcludeProperty Body, Headers | Format-List | Out-String)
+----------------------------------
+Request headers:
+$([pscustomobject]$APICall.Headers | Format-List | Out-String)
+----------------------------------
+Request body:
+$(($APICall.Body | Out-String -Stream).Split('\n') -split '\n')
 ----------------------------------
-Response Headers:
+Response headers:
 $($headers | Format-List | Out-String)
 ----------------------------------
 Error: