Merge pull request #131 from claudusd/api-meta

Add the /meta api part

Author: cursedcoder

doc/index.md

@@ -17,6 +17,7 @@ APIs:
   * [Releases](repo/releases.md)
     * [Assets](repo/assets.md)
 * [Users](users.md)
+* [Meta](meta.md)
 
 Additional features:
 

doc/meta.md

@@ -0,0 +1,29 @@
+## Users API
+[Back to the navigation](index.md)
+
+
+Wrap [GitHub User API](http://developer.github.com/v3/meta/).
+
+### Get information about GitHub services
+
+```php
+$service = $client->api('meta')->service();
+```
+
+return
+
+```
+array(3) {
+  'verifiable_password_authentication' => bool
+  'hooks' =>
+  array(1) {
+    [0] =>
+    string(15) "127.0.0.1/22"
+  }
+  'git' =>
+  array(1) {
+    [0] =>
+    string(15) "127.0.0.1/22"
+  }
+}
+```

lib/Github/Api/Meta.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Github\Api;
+
+/**
+ * Getting GitHub service information
+ *
+ * @link   https://developer.github.com/v3/meta/
+ * @author Claude Dioudonnat <claude.dioudonnat@gmail.com>
+ */
+class Meta extends AbstractApi
+{
+    /**
+     * Get the ip address of the hook and git servers for the GitHub.com service
+     *
+     * @return array Informations about the service of GitHub.com
+     */
+    public function service()
+    {
+        return $this->get('meta');
+    }
+}

lib/Github/Client.php

@@ -139,6 +139,10 @@ public function api($name)
                 $api = new Api\Authorizations($this);
                 break;
 
+            case 'meta':
+                $api = new Api\Meta($this);
+                break;
+
             default:
                 throw new InvalidArgumentException(sprintf('Undefined api instance called: "%s"', $name));
         }

test/Github/Tests/Api/MetaTest.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Github\Tests\Api;
+
+class MetaTest extends TestCase
+{
+    /**
+     * @test
+     */
+    public function shouldGetInformationService()
+    {
+        $expectedArray = array(
+            'hooks' => array(
+                '127.0.0.1/32'
+            ),
+            'git' => array(
+                '127.0.0.1/32'
+            ),
+            'verifiable_password_authentication' => true
+        );
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->service());
+    }
+
+    protected function getApiClass()
+    {
+        return 'Github\Api\Meta';
+    }
+}

test/Github/Tests/ClientTest.php

@@ -168,6 +168,8 @@ public function getApiClassesProvider()
 
             array('authorization', 'Github\Api\Authorizations'),
             array('authorizations', 'Github\Api\Authorizations'),
+
+            array('meta', 'Github\Api\Meta')
         );
     }