Merge a branch of a repository

GitHubRepositoryMerge.ps1

@@ -0,0 +1,113 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+function Merge-GitHubRepositoryBranches
+{
+<#
+    .SYNOPSIS
+        Branch a branch into another
+
+    .DESCRIPTION
+        Merge a branch into another
+        Calls the API: https://developer.github.com/v3/repos/merging/
+
+        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub
+
+    .PARAMETER OwnerName
+        Owner of the repository.
+        If not supplied here, the DefaultOwnerName configuration property value will be used.
+
+    .PARAMETER RepositoryName
+        Name of the repository.
+        If not supplied here, the DefaultRepositoryName configuration property value will be used.
+
+    .PARAMETER Uri
+        Uri for the repository.
+        The OwnerName and RepositoryName will be extracted from here instead of needing to provide
+        them individually.
+
+    .PARAMETER State
+        The state of the pull requests that should be returned back.
+
+    .PARAMETER Base
+        The name of the base branch that the head will be merged into.
+
+    .PARAMETER Head
+        The head to merge. This can be a branch name or a commit SHA1.
+
+    .PARAMETER CommitMessage
+        Commit message to use for the merge commit. If omitted, a default message will be used.
+
+    .PARAMETER AccessToken
+        If provided, this will be used as the AccessToken for authentication with the
+        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.
+
+    .PARAMETER NoStatus
+        If this switch is specified, long-running commands will run on the main thread
+        with no commandline status update.  When not specified, those commands run in
+        the background, enabling the command prompt to provide status information.
+        If not supplied here, the DefaultNoStatus configuration property value will be used.
+
+    .OUTPUTS
+        //TODO: FInd the output for POST commands and put it here
+
+    .EXAMPLE
+        //TODO: Give an example here
+#>
+
+[CmdletBinding(
+        SupportsShouldProcess,
+        DefaultParametersetName='Elements')]
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]
+    param(
+        [Parameter(ParameterSetName='Elements')]
+        [string] $OwnerName,
+
+        [Parameter(ParameterSetName='Elements')]
+        [string] $RepositoryName,
+
+        [Parameter(
+            Mandatory,
+            ParameterSetName='Uri')]
+        [string] $Uri,
+
+        [string] $Base,
+
+        [string] $CommitMessage,
+
+        [string] $Head,
+
+        [string] $AccessToken,
+
+        [switch] $NoStatus
+    )
+    Write-InvocationLog
+
+    $elements = Resolve-RepositoryElements -DisableValidation
+    $OwnerName = $elements.ownerName
+    $RepositoryName = $elements.repositoryName
+
+    $telemetryProperties = @{
+        'OwnerName' = (Get-PiiSafeString -PlainText $OwnerName)
+        'RepositoryName' = (Get-PiiSafeString -PlainText $RepositoryName)
+    }
+
+    $hashBody = @{
+        'base'= $Base;
+        'head' = $Head;
+        'commit_message' = $CommitMessage;
+    }
+
+    $params = @{
+        'UriFragment' = "repos/$OwnerName/$RepositoryName/merges"
+        'Body' = (ConvertTo-Json -InputObject $hashBody)
+        'Method' = 'Post'
+        'Description' =  "Merging branch $Head to $Base in $RepositoryName"
+        'AccessToken' = $AccessToken
+        'TelemetryEventName' = $MyInvocation.MyCommand.Name
+        'TelemetryProperties' = $telemetryProperties
+        'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)
+    }
+
+    return Invoke-GHRestMethod @params
+}

PowerShellForGitHub.psd1

@@ -34,6 +34,7 @@
         'GitHubPullRequests.ps1',
         'GitHubRepositories.ps1',
         'GitHubRepositoryForks.ps1',
+        'GitHubRepositoryMerge.ps1',
         'GitHubRepositoryTraffic.ps1',
         'GitHubTeams.ps1',
         'GitHubUsers.ps1',
@@ -85,6 +86,7 @@
         'Invoke-GHRestMethod',
         'Invoke-GHRestMethodMultipleResult',
         'Lock-GitHubIssue',
+        'Merge-GitHubRepositoryBranches',
         'Move-GitHubRepositoryOwnership',
         'New-GithubAssignee',
         'New-GitHubComment',