Missing miscellaneous api endpoints (KnpLabs#534)

Author: acrobat

doc/README.md

@@ -14,6 +14,10 @@ APIs:
 * [Issues](issues.md)
   * [Comments](issue/comments.md)
   * [Labels](issue/labels.md)
+* Miscellaneous
+  * [Emojis](miscellaneous/emojis.md)
+  * [Gitignore](miscellaneous/gitignore.md)
+  * [Markdown](miscellaneous/markdown.md)
 * [Organization](organization.md)
   * [Members](organization/members.md)
   * [Teams](organization/teams.md)

doc/miscellaneous/emojis.md

@@ -0,0 +1,8 @@
+## Emojis API
+[Back to the navigation](../README.md)
+
+### Lists all available emojis on GitHub.
+
+```php
+$emojis = $client->api('emojis')->all();
+```

doc/miscellaneous/gitignore.md

@@ -0,0 +1,14 @@
+## Gitignore API
+[Back to the navigation](../README.md)
+
+### Lists all available gitignore templates
+
+```php
+$gitignoreTemplates = $client->api('gitignore')->all();
+```
+
+### Get a single template
+
+```php
+$gitignore = $client->api('gitignore')->show('C');
+```

doc/miscellaneous/markdown.md

@@ -0,0 +1,14 @@
+## Markdown API
+[Back to the navigation](../README.md)
+
+### Render an arbitrary Markdown document
+
+```php
+$gitignoreTemplates = $client->api('markdown')->render('Hello world github/linguist#1 **cool**, and #1!', 'markdown');
+```
+
+### Render a Markdown document in raw mode
+
+```php
+$gitignore = $client->api('markdown')->renderRaw('path/to/file');
+```

lib/Github/Api/Miscellaneous/Emojis.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Github\Api\Miscellaneous;
+
+use Github\Api\AbstractApi;
+
+class Emojis extends AbstractApi
+{
+    /**
+     * Lists all the emojis available to use on GitHub.
+     *
+     * @link https://developer.github.com/v3/emojis/
+     *
+     * @return array
+     */
+    public function all()
+    {
+        return $this->get('/emojis');
+    }
+}

lib/Github/Api/Miscellaneous/Gitignore.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Github\Api\Miscellaneous;
+
+use Github\Api\AbstractApi;
+
+class Gitignore extends AbstractApi
+{
+    /**
+     * List all templates available to pass as an option when creating a repository.
+     *
+     * @link https://developer.github.com/v3/gitignore/#listing-available-templates
+     *
+     * @return array
+     */
+    public function all()
+    {
+        return $this->get('/gitignore/templates');
+    }
+
+    /**
+     * Get a single template.
+     *
+     * @link https://developer.github.com/v3/gitignore/#get-a-single-template
+     *
+     * @param string $template
+     *
+     * @return array
+     */
+    public function show($template)
+    {
+        return $this->get('/gitignore/templates/' . rawurlencode($template));
+    }
+}

lib/Github/Client.php

@@ -23,10 +23,12 @@
  * @method Api\CurrentUser me()
  * @method Api\Enterprise ent()
  * @method Api\Enterprise enterprise()
+ * @method Api\Miscellaneous\Emojis emojis()
  * @method Api\GitData git()
  * @method Api\GitData gitData()
  * @method Api\Gists gist()
  * @method Api\Gists gists()
+ * @method Api\Miscellaneous\Gitignore gitignore()
  * @method Api\Integrations integration()
  * @method Api\Integrations integrations()
  * @method Api\Issue issue()
@@ -177,6 +179,10 @@ public function api($name)
                 $api = new Api\Enterprise($this);
                 break;
 
+            case 'emojis':
+                $api = new Api\Miscellaneous\Emojis($this);
+                break;
+
             case 'git':
             case 'git_data':
             case 'gitData':
@@ -188,6 +194,10 @@ public function api($name)
                 $api = new Api\Gists($this);
                 break;
 
+            case 'gitignore':
+                $api = new Api\Miscellaneous\Gitignore($this);
+                break;
+
             case 'integration':
             case 'integrations':
                 $api = new Api\Integrations($this);

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

@@ -0,0 +1,36 @@
+<?php
+
+namespace Github\Tests\Api\Miscellaneous;
+
+use Github\Api\Miscellaneous\Emojis;
+use Github\Tests\Api\TestCase;
+
+class EmojisTest extends TestCase
+{
+    /**
+     * @test
+     */
+    public function shouldGetAllEmojis()
+    {
+        $expectedArray = array(
+            '+1' => 'https://github.global.ssl.fastly.net/images/icons/emoji/+1.png?v5',
+            '-1' => 'https://github.global.ssl.fastly.net/images/icons/emoji/-1.png?v5',
+        );
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/emojis')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->all());
+    }
+
+    /**
+     * @return string
+     */
+    protected function getApiClass()
+    {
+        return Emojis::class;
+    }
+}

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

@@ -0,0 +1,61 @@
+<?php
+
+namespace Github\Tests\Api\Miscellaneous;
+
+use Github\Api\Miscellaneous\Emojis;
+use Github\Api\Miscellaneous\Gitignore;
+use Github\Tests\Api\TestCase;
+
+class GitignoreTest extends TestCase
+{
+    /**
+     * @test
+     */
+    public function shouldGetAllTemplates()
+    {
+        $expectedArray = array(
+            'Actionscript',
+            'Android',
+            'AppceleratorTitanium',
+            'Autotools',
+            'Bancha',
+            'C',
+            'C++'
+        );
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/gitignore/templates')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->all());
+    }
+
+    /**
+     * @test
+     */
+    public function shouldGetTemplate()
+    {
+        $expectedArray = array(
+            'name' => 'C',
+            'source' => "# Object files\n*.o\n\n# Libraries\n*.lib\n*.a"
+        );
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/gitignore/templates/C')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->show('C'));
+    }
+
+    /**
+     * @return string
+     */
+    protected function getApiClass()
+    {
+        return Gitignore::class;
+    }
+}

test/Github/Tests/Api/MarkdownTest.php renamed to test/Github/Tests/Api/Miscellaneous/MarkdownTest.php

@@ -1,6 +1,8 @@
 <?php
 
-namespace Github\Tests\Api;
+namespace Github\Tests\Api\Miscellaneous;
+
+use Github\Tests\Api\TestCase;
 
 class MarkdownTest extends TestCase
 {