feature #1141 Add API to rerequest a check run (Spea)

This PR was merged into the 3.15-dev branch.

Discussion
----------

This change adds a new method to rerequest a check run (see also https://docs.github.com/en/rest/checks/runs?apiVersion=2022-11-28#rerequest-a-check-run).

Commits
-------

48e025e Add API to rerequest a check run

doc/repo/check_runs.md

@@ -62,6 +62,10 @@ $params = [/*...*/];
 $checks = $client->api('repo')->checkRuns()->allForReference('KnpLabs', 'php-github-api', $reference, $params);
 ```
 
+### Rerequest a check run
 
+https://docs.github.com/en/rest/reference/checks#rerequest-a-check-run
 
-
+```php
+$checks = $client->api('repo')->checkRuns()->rerequest('KnpLabs', 'php-github-api', $checkRunId);
+```

lib/Github/Api/Repository/Checks/CheckRuns.php

@@ -83,4 +83,14 @@ public function allForReference(string $username, string $repository, string $re
 
         return $this->get('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/commits/'.rawurlencode($ref).'/check-runs', $params);
     }
+
+    /**
+     * @link https://docs.github.com/en/rest/reference/checks#rerequest-a-check-run
+     *
+     * @return array
+     */
+    public function rerequest(string $username, string $repository, int $checkRunId)
+    {
+        return $this->post('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/check-runs/'.$checkRunId.'/rerequest');
+    }
 }

test/Github/Tests/Api/Repository/Checks/CheckRunsTest.php

@@ -102,6 +102,20 @@ public function shouldGetAllChecksForReference()
         $api->allForReference('KnpLabs', 'php-github-api', 'cb4abc15424c0015b4468d73df55efb8b60a4a3d', $params);
     }
 
+    /**
+     * @test
+     */
+    public function shouldRerequestCheckRun()
+    {
+        /** @var CheckRuns|MockObject $api */
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('post')
+            ->with('/repos/KnpLabs/php-github-api/check-runs/123/rerequest');
+
+        $api->rerequest('KnpLabs', 'php-github-api', 123);
+    }
+
     protected function getApiClass(): string
     {
         return CheckRuns::class;