Add user email listing (GitLabPHP#147)

see https://docs.gitlab.com/ce/api/users.html#list-emails

Author: mash1t

lib/Gitlab/Api/Users.php

@@ -207,4 +207,21 @@ public function removeUserKey($user_id, $key_id)
     {
         return $this->delete('users/'.$this->encodePath($user_id).'/keys/'.$this->encodePath($key_id));
     }
+
+    /**
+     * @return mixed
+     */
+    public function emails()
+    {
+        return $this->get('user/emails');
+    }
+
+    /**
+     * @param $id
+     * @return mixed
+     */
+    public function email($id)
+    {
+        return $this->get('user/emails/'.$this->encodePath($id));
+    }
 }

test/Gitlab/Tests/Api/UsersTest.php

@@ -417,6 +417,41 @@ public function shouldAttemptLogin()
         $this->assertEquals($expectedArray, $api->login('matt', 'password'));
     }
 
+    /**
+     * @test
+     */
+    public function shouldGetUserEmails()
+    {
+        $expectedArray = array(
+            array('id' => 1, 'email' => '[email protected]'),
+            array('id' => 2, 'email' => '[email protected]'),
+        );
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('user/emails')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->emails());
+    }
+
+    /**
+     * @test
+     */
+    public function shouldGetSpecificUserEmail()
+    {
+        $expectedArray = array('id' => 1, 'email' => '[email protected]');
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('user/emails/1')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->email(1));
+    }
+
     protected function getApiClass()
     {
         return 'Gitlab\Api\Users';