From d72323c433b3b1ee78cbb29689872c526ec6a36e Mon Sep 17 00:00:00 2001
From: Luke Spencer <luke.mjh.spencer@gmail.com>
Date: Thu, 7 Nov 2024 19:34:12 +0000
Subject: [PATCH] feature #1146 List pull requests associated with a commit
 (lmjhs)

This PR was squashed before being merged into the 3.15-dev branch.

Discussion
----------

Added missing `pulls` method to repository commits to allow fetching of pull requests for a commit sha.

[List pull requests associated with a commit](https://docs.github.com/en/rest/commits/commits?apiVersion=2022-11-28#list-pull-requests-associated-with-a-commit)

Commits
-------

46c18965fec4ca72d3e78769f760580926cf766c Commit Pulls
5727a4327e30301e448820750d8a98841e1ad866 Update tests
c0a48e2196b8e77cc65fa71af69d7d284ecd8123 Added documentation
---
 doc/commits.md                                |  8 ++++++++
 lib/Github/Api/Repository/Commits.php         |  5 +++++
 .../Tests/Api/Repository/CommitsTest.php      | 19 +++++++++++++++++++
 3 files changed, 32 insertions(+)

diff --git a/doc/commits.md b/doc/commits.md
index 741af0713a2..165d71ecae2 100644
--- a/doc/commits.md
+++ b/doc/commits.md
@@ -35,3 +35,11 @@ $commit = $client->api('repo')->commits()->compare('KnpLabs', 'php-github-api',
 ```
 
 Returns an array of commits.
+
+### List pull requests associated with a commit
+
+```php
+$commit = $client->api('repo')->commits()->pulls('KnpLabs', 'php-github-api', '839e5185da9434753db47959bee16642bb4f2ce4');
+```
+
+Returns an array of pull requests.
\ No newline at end of file
diff --git a/lib/Github/Api/Repository/Commits.php b/lib/Github/Api/Repository/Commits.php
index 383905d28f2..0bc5598cbff 100644
--- a/lib/Github/Api/Repository/Commits.php
+++ b/lib/Github/Api/Repository/Commits.php
@@ -30,4 +30,9 @@ public function show($username, $repository, $sha)
     {
         return $this->get('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/commits/'.rawurlencode($sha));
     }
+
+    public function pulls($username, $repository, $sha, array $params = [])
+    {
+        return $this->get('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/commits/'.rawurlencode($sha).'/pulls', $params);
+    }
 }
diff --git a/test/Github/Tests/Api/Repository/CommitsTest.php b/test/Github/Tests/Api/Repository/CommitsTest.php
index 25ef2536a1c..9d1b3288afe 100644
--- a/test/Github/Tests/Api/Repository/CommitsTest.php
+++ b/test/Github/Tests/Api/Repository/CommitsTest.php
@@ -55,6 +55,25 @@ public function shouldShowCommitUsingSha()
         $this->assertEquals($expectedValue, $api->show('KnpLabs', 'php-github-api', 123));
     }
 
+    /**
+     * @test
+     */
+    public function shouldGetAllPullRequestsUsingSha()
+    {
+        $expectedValue = [
+            ['number' => '1', 'title' => 'My first PR'],
+            ['number' => '2', 'title' => 'Another PR'],
+        ];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/repos/KnpLabs/php-github-api/commits/123/pulls')
+            ->will($this->returnValue($expectedValue));
+
+        $this->assertEquals($expectedValue, $api->pulls('KnpLabs', 'php-github-api', 123));
+    }
+
     /**
      * @return string
      */