Add commit cherry-pick API

Co-Authored-By: hikingyo <[email protected]>

Author: GrahamCampbell

src/Api/Repositories.php

@@ -447,6 +447,30 @@ public function mergeBase($project_id, array $refs)
         return $this->get($this->getProjectPath($project_id, 'repository/merge_base'), ['refs' => $refs]);
     }
 
+    /**
+     * @param int|string $project_id
+     * @param string     $sha
+     * @param array      $params
+     *
+     * @return mixed
+     */
+    public function cherryPick($project_id, string $sha, array $params = [])
+    {
+        $resolver = $this->createOptionsResolver();
+        $booleanNormalizer = function (Options $resolver, $value) {
+            return $value ? 'true' : 'false';
+        };
+
+        $resolver->setDefined('branch')
+            ->setRequired('branch');
+
+        $resolver->setDefined('dry_run')
+            ->setAllowedTypes('dry_run', 'bool')
+            ->setNormalizer('dry_run', $booleanNormalizer);
+
+        return $this->post($this->getProjectPath($project_id, 'repository/commits/'.self::encodePath($sha).'/cherry_pick'), $params);
+    }
+
     protected function createOptionsResolver()
     {
         $allowedTypeValues = [

tests/Api/RepositoriesTest.php

@@ -626,6 +626,39 @@ public function shouldGetMergeBase(): void
         $this->assertEquals($expectedArray, $api->mergeBase(1, ['efgh5678efgh5678efgh5678efgh5678efgh5678', '1234567812345678123456781234567812345678']));
     }
 
+    /**
+     * @test
+     */
+    public function shouldCherryPick(): void
+    {
+        $expectedArray = [
+            'id' => 'abcd1234abcd1234abcd1234abcd1234abcd1234',
+            'short_id' => 'abcd1234',
+            'title' => 'A commit',
+            'author_name' => 'Example User',
+            'author_email' => '[email protected]',
+            'authored_date' => '2018-01-01T00:00:00.000Z',
+            'created_at' => '2018-01-01T00:00:00.000Z',
+            'committer_name' => 'Jane Doe',
+            'committer_email' => '[email protected]',
+            'committed_date' => '2018-01-01T00:00:00.000Z',
+            'message' => 'A commit',
+            'parent_ids' => [
+                'efgh5678efgh5678efgh5678efgh5678efgh5678',
+            ],
+            'web_url' => 'https://gitlab.example.com/thedude/gitlab-foss/-/commit/abcd1234abcd1234abcd1234abcd1234abcd1234',
+        ];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('post')
+            ->with('projects/1/repository/commits/123456123456/cherry_pick', ['branch' => 'feature_branch'])
+            ->will($this->returnValue($expectedArray))
+        ;
+
+        $this->assertEquals($expectedArray, $api->cherryPick(1, '123456123456', ['branch' => 'feature_branch']));
+    }
+
     protected function getApiClass()
     {
         return Repositories::class;