Support in Set-GitHubContent to upload binary files

GitHubContents.ps1

@@ -231,6 +231,9 @@ filter Set-GitHubContent
     .PARAMETER Content
         The new file content.
 
+    .PARAMETER ContentPath
+        The local path to file content.
+
     .PARAMETER Sha
         The SHA value of the current file if present. If this parameter is not provided, and the
         file currently exists in the specified branch of the repo, it will be read to obtain this
@@ -323,9 +326,16 @@ filter Set-GitHubContent
 
         [Parameter(
             Mandatory,
-            Position = 4)]
+            Position = 4,
+            ParameterSetName = 'Content')]
         [string] $Content,
 
+        [Parameter(
+            Mandatory,
+            Position = 4,
+            ParameterSetName = 'Content')]
+        [string] $ContentPath,
+
         [Parameter(ValueFromPipelineByPropertyName)]
         [string] $Sha,
 
@@ -358,7 +368,14 @@ filter Set-GitHubContent
 
     $uriFragment = "/repos/$OwnerName/$RepositoryName/contents/$Path"
 
-    $encodedContent = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($Content))
+    if ($ContentPath)
+    {
+        $encodedContent = [Convert]::ToBase64String((Get-Content -Path $ContentPath -AsByteStream -Raw))
+    }
+    else
+    {
+        $encodedContent = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($Content))
+    }
 
     $hashBody = @{
         message = $CommitMessage

Tests/GitHubContents.tests.ps1

@@ -335,6 +335,67 @@ try
             }
         }
 
+        Context 'When setting new file content by path' {
+            BeforeAll {
+                $filePath = 'notes'
+                $fileName = 'hello.txt'
+                $commitMessage = 'Commit Message'
+                $content = 'This is the content for test.txt'
+                $branchName = 'master'
+                $committerName = 'John Doe'
+                $committerEmail = '[email protected]'
+                $authorName = 'Jane Doe'
+                $authorEmail = '[email protected]'
+
+                $contentPath = New-TemporaryFile
+                $content | Out-File -FilePath $contentPath
+
+                $setGitHubContentParms = @{
+                    Path = "$filePath/$fileName"
+                    CommitMessage = $commitMessage
+                    Branch = $branchName
+                    ContentPath = $contentPath
+                    Uri = $repo.svn_url
+                    CommitterName = $committerName
+                    CommitterEmail = $committerEmail
+                    authorName = $authorName
+                    authorEmail = $authorEmail
+                }
+
+                $result = Set-GitHubContent @setGitHubContentParms -PassThru
+            }
+
+            It 'Should have the expected type and additional properties' {
+                $result.PSObject.TypeNames[0] | Should -Be 'GitHub.Content'
+                $result.content.name | Should -Be $fileName
+                $result.content.path | Should -Be "$filePath/$fileName"
+                $result.content.url | Should -Be ("https://api.github.com/repos/$($script:ownerName)" +
+                    "/$repoName/contents/$filePath/$($fileName)?ref=$BranchName")
+                $result.commit.author.name | Should -Be $authorName
+                $result.commit.author.email | Should -Be $authorEmail
+                $result.commit.committer.name | Should -Be $committerName
+                $result.commit.committer.email | Should -Be $committerEmail
+                $result.commit.message | Should -Be $commitMessage
+            }
+
+            It 'Should have written the correct content' {
+                $getGitHubContentParms = @{
+                    Path = "$filePath/$fileName"
+                    Uri = $repo.svn_url
+                    MediaType = 'Raw'
+                    ResultAsString = $true
+                }
+
+                $writtenContent = Get-GitHubContent @getGitHubContentParms
+
+                $content | Should -Be $writtenContent
+            }
+
+            AfterAll {
+                Remove-Item -Path $contentPath
+            }
+        }
+
         Context 'When overwriting file content' {
             BeforeAll {
                 $filePath = 'notes'