Add method to obtain project users

Author: omarlopesino

lib/Gitlab/Api/Projects.php

@@ -386,6 +386,24 @@ public function hook($project_id, $hook_id)
         return $this->get($this->getProjectPath($project_id, 'hooks/'.$this->encodePath($hook_id)));
     }
 
+    /**
+     * Get project users.
+     *
+     * See https://docs.gitlab.com/ee/api/projects.html#get-project-users for more info.
+     *
+     * @param int $project_id
+     *   Project id.
+     * @param array $parameters
+     *   Url parameters.
+     *
+     * @return array
+     *   List of project users.
+     */
+    public function users($project_id, array $parameters = [])
+    {
+      return $this->get($this->getProjectPath($project_id, 'users'), $parameters);
+    }
+
     /**
      * Get project issues.
      *

test/Gitlab/Tests/Api/ProjectsTest.php

@@ -287,6 +287,24 @@ public function shouldGetProjectIssues()
         $this->assertEquals($expectedArray, $api->issues(1));
     }
 
+    /**
+     * Check we can request project issues.
+     *
+     * @test
+     */
+    public function shouldGetProjectUsers()
+    {
+      $expectedArray = $this->getProjectUsersExpectedArray();
+
+      $api = $this->getApiMock();
+      $api->expects($this->once())
+        ->method('get')
+        ->with('projects/1/users')
+        ->will($this->returnValue($expectedArray));
+
+      $this->assertEquals($expectedArray, $api->users(1));
+    }
+
     /**
      * Check we can request project issues with query parameters.
      *
@@ -379,6 +397,24 @@ public function getProjectIssuesExpectedArray()
         ];
     }
 
+    /**
+     * Get expected array for tests which check project users method.
+     *
+     * @return array
+     */
+    public function getProjectUsersExpectedArray() {
+      return [
+       [
+         'id' => 1,
+         'name'       => 'John Doe',
+         'username'   => 'john.doe',
+         'state'      => 'active',
+         'avatar_url' => 'https://example.com',
+         'web_url'    => 'gitlab.com/john.doe',
+       ],
+      ];
+    }
+
     /**
      * @test
      */