Add deployment merge request listing (#869)

Co-authored-by: Chris Mitchell <2536603+chumanfu@users.noreply.github.com>

Author: GrahamCampbell

CHANGELOG.md

@@ -16,6 +16,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 * Add support for listing merge requests associated with a commit
 * Add support for `without_project_bots` in `Users::all`
 * Add support for date filters and `finished_at` ordering in `Deployments::all`
+* Add support for listing merge requests associated with a deployment
 
 
 ## [12.0.0] - 2025-02-23

src/Api/Deployments.php

@@ -77,4 +77,9 @@ public function show(int|string $project_id, int $deployment_id): mixed
     {
         return $this->get($this->getProjectPath($project_id, 'deployments/'.$deployment_id));
     }
+
+    public function mergeRequests(int|string $project_id, int $deployment_id, array $parameters = []): mixed
+    {
+        return $this->get($this->getProjectPath($project_id, 'deployments/'.$deployment_id.'/merge_requests'), $parameters);
+    }
 }

tests/Api/DeploymentsTest.php

@@ -108,6 +108,47 @@ public function shouldShowDeployment(): void
         $this->assertEquals($expectedArray, $api->show(1, 42));
     }
 
+    #[Test]
+    public function shouldGetDeploymentMergeRequests(): void
+    {
+        $expectedArray = [
+            ['id' => 1, 'title' => 'A merge request'],
+            ['id' => 2, 'title' => 'Another merge request'],
+        ];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('projects/1/deployments/42/merge_requests', [])
+            ->willReturn($expectedArray)
+        ;
+
+        $this->assertEquals($expectedArray, $api->mergeRequests(1, 42));
+    }
+
+    #[Test]
+    public function shouldGetDeploymentMergeRequestsWithParameters(): void
+    {
+        $expectedArray = [
+            ['id' => 1, 'title' => 'A merge request'],
+        ];
+        $parameters = [
+            'state' => 'merged',
+            'labels' => 'release,backend',
+            'page' => 2,
+            'per_page' => 25,
+        ];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('projects/1/deployments/42/merge_requests', $parameters)
+            ->willReturn($expectedArray)
+        ;
+
+        $this->assertEquals($expectedArray, $api->mergeRequests(1, 42, $parameters));
+    }
+
     private function getMultipleDeploymentsData(): array
     {
         return [