Added support for triggering a pipeline (#612)

Co-authored-by: Graham Campbell <[email protected]>

Author: sjadema

CHANGELOG.md

@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [11.1.0] - UPCOMING
 
 * Added CI schedule variables endpoints
+* Added support for triggering a pipeline
 
 [11.1.0]: https://github.com/GitLabPHP/Client/compare/11.0.0...11.1.0
 

src/Api/Projects.php

@@ -231,6 +231,23 @@ public function createTrigger($project_id, string $description)
         ]);
     }
 
+    /**
+     * @param int|string $project_id
+     * @param string     $ref
+     * @param string     $token
+     * @param array      $variables
+     *
+     * @return mixed
+     */
+    public function triggerPipeline($project_id, string $ref, string $token, array $variables = [])
+    {
+        return $this->post($this->getProjectPath($project_id, 'trigger/pipeline'), [
+            'ref' => $ref,
+            'token' => $token,
+            'variables' => $variables,
+        ]);
+    }
+
     /**
      * @param int|string $project_id
      * @param array      $parameters {

tests/Api/ProjectsTest.php

@@ -569,6 +569,30 @@ public function shouldCreateTrigger(): void
         $this->assertEquals($expectedArray, $api->createTrigger(1, 'foobar'));
     }
 
+    /**
+     * @test
+     */
+    public function shouldTriggerPipeline(): void
+    {
+        $expectedArray = [
+            'id' => 4,
+            'sha' => 'commit_hash',
+            'ref' => 'master',
+            'status' => 'pending',
+        ];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('post')
+            ->with(
+                'projects/1/trigger/pipeline',
+                ['ref' => 'master', 'token' => 'some_token', 'variables' => ['VAR_1' => 'value 1']]
+            )
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->triggerPipeline(1, 'master', 'some_token', ['VAR_1' => 'value 1']));
+    }
+
     /**
      * @test
      */