feature #1006 Add endpoint for approve workflow run (Nyholm)

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

Discussion
----------

See https://docs.github.com/en/rest/reference/actions#approve-a-workflow-run-for-a-fork-pull-request

Commits
-------

b987f19 Add endpoint for approve workflow run
cd1b74b Bugfix
ec0ae3b Use asertSame()

Author: Nyholm

doc/repo/actions/workflow_runs.md

@@ -74,3 +74,11 @@ https://docs.github.com/en/rest/reference/actions#delete-workflow-run-logs
 ```php
 $client->api('repo')->workflowRuns()->deleteLogs('KnpLabs', 'php-github-api', $runId);
 ```
+
+### Approve workflow run
+
+https://docs.github.com/en/rest/reference/actions#approve-a-workflow-run-for-a-fork-pull-request
+
+```php
+$client->api('repo')->workflowRuns()->approve('KnpLabs', 'php-github-api', $runId);
+```

lib/Github/Api/Repository/Actions/WorkflowRuns.php

@@ -136,4 +136,20 @@ public function deleteLogs(string $username, string $repository, int $runId)
     {
         return $this->delete('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/actions/runs/'.$runId.'/logs');
     }
+
+    /**
+     * @link https://docs.github.com/en/rest/reference/actions#approve-a-workflow-run-for-a-fork-pull-request
+     *
+     * @param string $username
+     * @param string $repository
+     * @param int    $runId
+     *
+     * @return array|string
+     *
+     * @experimental This endpoint is currently in beta.
+     */
+    public function approve(string $username, string $repository, int $runId)
+    {
+        return $this->post('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/actions/runs/'.$runId.'/approve');
+    }
 }

test/Github/Tests/Api/Repository/Actions/WorkflowRunsTest.php

@@ -198,6 +198,24 @@ public function shouldDeleteWorkflowRunLogs()
         $this->assertEquals($expectedValue, $api->deleteLogs('KnpLabs', 'php-github-api', 374473304));
     }
 
+    /**
+     * @test
+     */
+    public function shouldApproveWorkflowRunLogs()
+    {
+        $expectedValue = 'response';
+
+        /** @var WorkflowRuns|MockObject $api */
+        $api = $this->getApiMock();
+
+        $api->expects($this->once())
+            ->method('post')
+            ->with('/repos/KnpLabs/php-github-api/actions/runs/374473304/approve')
+            ->will($this->returnValue($expectedValue));
+
+        $this->assertSame($expectedValue, $api->approve('KnpLabs', 'php-github-api', 374473304));
+    }
+
     protected function getApiClass()
     {
         return WorkflowRuns::class;