feature #994 Add create a repository using a template endpoint (martinbean)

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

Discussion
----------

Adds methods to [create a repository using a template][1], and also contributes a few test cases for the various options.

Resolves #976

[1]: https://docs.github.com/en/rest/reference/repos#create-a-repository-using-a-template

Commits
-------

58b294f Add create a repository using a template endpoint
9fabcf7 Make parameters array instead
c70f39f Document create repository from template
79ebd98 Type-hint parameters

Author: martinbean

doc/repos.md

@@ -370,3 +370,14 @@ Example when you want to configure custom github action workflows.
 ```php
 $client->api('repo')->dispatch('KnpLabs', 'php-github-api', 'acme-event', ['foo'=>'bar']);
 ```
+
+### Create a repository using a template
+
+Create a new repository using a repository template.
+
+```php
+$client->api('repo')->createFromTemplate('template-owner', 'template-repo', [
+    'name' => 'name-of-new-repo',
+    'owner' => 'name-of-new-repo-owner', // can be user or org
+]);
+```

lib/Github/Api/Repo.php

@@ -793,4 +793,16 @@ public function transfer($username, $repository, $newOwner, $teamId = [])
     {
         return $this->post('/repos/'.rawurldecode($username).'/'.rawurldecode($repository).'/transfer', ['new_owner' => $newOwner, 'team_id' => $teamId]);
     }
+
+    /**
+     * Create a repository using a template.
+     *
+     * @link https://developer.github.com/v3/repos/#create-a-repository-using-a-template
+     *
+     * @return array
+     */
+    public function createFromTemplate(string $templateOwner, string $templateRepo, array $parameters = [])
+    {
+        return $this->post('/repos/'.rawurldecode($templateOwner).'/'.rawurldecode($templateRepo).'/generate', $parameters);
+    }
 }

test/Github/Tests/Api/RepoTest.php

@@ -626,6 +626,32 @@ public function shouldTransferRepository()
         $this->assertEquals($expectedArray, $api->transfer('KnpLabs', 'php-github-api', 'github', [1234, 1235]));
     }
 
+    /**
+     * @test
+     */
+    public function shouldCreateRepositoryUsingTemplate()
+    {
+        $expectedArray = [
+            'id' => 1,
+            'name' => 'newrepo',
+            'full_name' => 'johndoe/newrepo',
+        ];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('post')
+            ->with('/repos/acme/template/generate', [
+                'name' => 'newrepo',
+                'owner' => 'johndoe',
+            ])
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->createFromTemplate('acme', 'template', [
+            'name' => 'newrepo',
+            'owner' => 'johndoe',
+        ]));
+    }
+
     /**
      * @return string
      */