Merge pull request GitLabPHP#331 from woodylan/master

support impersonation tokens

Author: m1guelpf

lib/Gitlab/Api/Users.php

@@ -253,4 +253,49 @@ public function email($id)
     {
         return $this->get('user/emails/'.$this->encodePath($id));
     }
+
+    /**
+     * @param int $user_id
+     * @return mixed
+     */
+    public function userImpersonationTokens($user_id)
+    {
+        return $this->get('users/'.$this->encodePath($user_id).'/impersonation_tokens');
+    }
+
+    /**
+     * @param int $user_id
+     * @param int $impersonation_token_id
+     * @return mixed
+     */
+    public function userImpersonationToken($user_id, $impersonation_token_id)
+    {
+        return $this->get('users/'.$this->encodePath($user_id).'/impersonation_tokens/'.$this->encodePath($impersonation_token_id));
+    }
+
+    /**
+     * @param int $user_id
+     * @param string $name
+     * @param array $scopes
+     * @param null $expires_at
+     * @return mixed
+     */
+    public function createImpersonationToken($user_id, $name, array $scopes, $expires_at = null)
+    {
+        return $this->post('users/'.$this->encodePath($user_id).'/impersonation_tokens', array(
+            'name' => $name,
+            'scopes' => $scopes,
+            'expires_at' => $expires_at
+        ));
+    }
+
+    /**
+     * @param int $user_id
+     * @param int $impersonation_token_id
+     * @return mixed
+     */
+    public function removeImpersonationToken($user_id, $impersonation_token_id)
+    {
+        return $this->delete('users/'.$this->encodePath($user_id).'/impersonation_tokens/'.$this->encodePath($impersonation_token_id));
+    }
 }

test/Gitlab/Tests/Api/UsersTest.php

@@ -406,6 +406,77 @@ public function shouldGetSpecificUserEmail()
         $this->assertEquals($expectedArray, $api->email(1));
     }
 
+    /**
+     * @test
+     */
+    public function shouldGetCurrentUserImpersonationTokens()
+    {
+        $expectedArray = array(
+            array('id' => 1, 'name' => 'A Name', 'revoked' => false),
+            array('id' => 2, 'name' => 'A Name', 'revoked' => false),
+        );
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('users/1/impersonation_tokens')
+            ->will($this->returnValue($expectedArray))
+        ;
+
+        $this->assertEquals($expectedArray, $api->userImpersonationTokens(1));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldGetUserImpersonationToken()
+    {
+        $expectedArray = array('id' => 2, 'name' => 'name');
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('users/1/impersonation_tokens/1')
+            ->will($this->returnValue($expectedArray))
+        ;
+
+        $this->assertEquals($expectedArray, $api->userImpersonationToken(1, 1));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldCreateImpersonationTokenForUser()
+    {
+        $expectedArray = array('id' => 1, 'name' => 'name');
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('post')
+            ->with('users/1/impersonation_tokens', array('name' => 'name', 'scopes' => ['api'] ,'expires_at' => null))
+            ->will($this->returnValue($expectedArray))
+        ;
+
+        $this->assertEquals($expectedArray, $api->createImpersonationToken(1, 'name', ['api']));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldDeleteImpersonationTokenForUser()
+    {
+        $expectedBool = true;
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('delete')
+            ->with('users/1/impersonation_tokens/1')
+            ->will($this->returnValue($expectedBool))
+        ;
+
+        $this->assertEquals($expectedBool, $api->removeImpersonationToken(1, 1));
+    }
+
     protected function getApiClass()
     {
         return 'Gitlab\Api\Users';