Added support for Miscellaneous Licenses (#744)

* Added support for Miscellaneous Licenses

* Class fix

Author: drobee

doc/README.md

@@ -34,6 +34,7 @@ v3 APIs:
   * [Code of conduct](miscellaneous/codeofconduct.md)
   * [Emojis](miscellaneous/emojis.md)
   * [Gitignore](miscellaneous/gitignore.md)
+  * [Licenses](miscellaneous/licenses.md)
   * [Markdown](miscellaneous/markdown.md)
 * [Organization](organization.md)
   * [Members](organization/members.md)

doc/miscellaneous/licenses.md

@@ -0,0 +1,14 @@
+## Licenses API
+[Back to the navigation](../README.md)
+
+### Lists all licenses.
+
+```php
+$licenses = $client->api('licenses')->all();
+```
+
+### Get a license.
+
+```php
+$license = $client->api('licenses')->show('gpl-2.0');
+```

lib/Github/Api/Miscellaneous/Licenses.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Github\Api\Miscellaneous;
+
+use Github\Api\AbstractApi;
+
+class Licenses extends AbstractApi
+{
+    /**
+     * Lists all the licenses available on GitHub.
+     *
+     * @link https://developer.github.com/v3/licenses/
+     *
+     * @return array
+     */
+    public function all()
+    {
+        return $this->get('/licenses');
+    }
+
+    /**
+     * Get an individual license by its license key.
+     *
+     * @link https://developer.github.com/v3/licenses/#get-an-individual-license
+     *
+     * @param string $license
+     *
+     * @return array
+     */
+    public function show($license)
+    {
+        return $this->get('/licenses/'.rawurlencode($license));
+    }
+}

lib/Github/Client.php

@@ -25,6 +25,7 @@
  * @method Api\Enterprise enterprise()
  * @method Api\Miscellaneous\CodeOfConduct codeOfConduct()
  * @method Api\Miscellaneous\Emojis emojis()
+ * @method Api\Miscellaneous\Licenses licenses()
  * @method Api\GitData git()
  * @method Api\GitData gitData()
  * @method Api\Gists gist()
@@ -221,6 +222,10 @@ public function api($name)
                 $api = new Api\Markdown($this);
                 break;
 
+            case 'licenses':
+                $api = new Api\Miscellaneous\Licenses($this);
+                break;
+
             case 'notification':
             case 'notifications':
                 $api = new Api\Notification($this);

test/Github/Tests/Api/Miscellaneous/LicensesTest.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace Github\Tests\Api\Miscellaneous;
+
+use Github\Api\Miscellaneous\Licenses;
+use Github\Tests\Api\TestCase;
+
+class LicensesTest extends TestCase
+{
+    /**
+     * @test
+     */
+    public function shouldGetAllLicenses()
+    {
+        $expectedArray = [
+            ['key' => 'mit'],
+            ['key' => 'apache-2.0'],
+        ];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/licenses')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->all());
+    }
+
+    /**
+     * @test
+     */
+    public function shouldGetSingleLicenses()
+    {
+        $expectedArray = [
+            'key' => 'gpl-2.0',
+        ];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/licenses/gpl-2.0')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->show('gpl-2.0'));
+    }
+
+    /**
+     * @return string
+     */
+    protected function getApiClass()
+    {
+        return Licenses::class;
+    }
+}