Merge branch 'feature/api-v2-users' into develop

Author: vimishor

docs/Home.md

@@ -27,7 +27,7 @@ A simple PHP wrapper for Bitbucket API.
 * [Teams](teams.md) (API 2.0)
 * [User](user.md)
     * [Repositories](user/repositories.md)
-* [Users](users.md)
+* [Users](users.md) (API 2.0)
     * [Account](users/account.md)
     * [Emails](users/emails.md)
     * [Invitations](users/invitations.md)

docs/users.md

@@ -5,8 +5,28 @@ Get information related to an individual or team account.
 
 ### Prepare:
 ```php
-$users = new Bitbucket\API\Users();
-$users->setCredentials( new Bitbucket\API\Authentication\Basic($bb_user, $bb_pass) );
+$user = new Bitbucket\API\Users();
+$user->setCredentials( new Bitbucket\API\Authentication\Basic($bb_user, $bb_pass) );
+```
+
+### Get the public information associated with a user: (API 2.0)
+```php
+$user->get($username);
+```
+
+### Get the list of followers: (API 2.0)
+```php
+$user->followers($username);
+```
+
+### Get a list of accounts the user is following: (API 2.0)
+```php
+$user->following($username);
+```
+
+### Get the list of the user's repositories: (API 2.0)
+```php
+$user->repositories($username);
 ```
 
 ----

lib/Bitbucket/API/Users.php

@@ -11,6 +11,8 @@
 
 namespace Bitbucket\API;
 
+use Buzz\Message\MessageInterface;
+
 /**
  * Get information related to an individual or team account.
  * NOTE: For making calls against the currently authenticated account, see the `User` resource.
@@ -19,6 +21,62 @@
  */
 class Users extends Api
 {
+    /**
+     * Get the public information associated with a user
+     *
+     * @access public
+     * @param  string           $username
+     * @return MessageInterface
+     */
+    public function get($username)
+    {
+        return $this->getClient()->setApiVersion('2.0')->get(
+            sprintf('users/%s', $username)
+        );
+    }
+
+    /**
+     * Get the list of followers.
+     *
+     * @access public
+     * @param  string           $username
+     * @return MessageInterface
+     */
+    public function followers($username)
+    {
+        return $this->getClient()->setApiVersion('2.0')->get(
+            sprintf('users/%s/followers', $username)
+        );
+    }
+
+    /**
+     * Get a list of accounts the user is following
+     *
+     * @access public
+     * @param  string           $username
+     * @return MessageInterface
+     */
+    public function following($username)
+    {
+        return $this->getClient()->setApiVersion('2.0')->get(
+            sprintf('users/%s/following', $username)
+        );
+    }
+
+    /**
+     * Get the list of the user's repositories
+     *
+     * @access public
+     * @param  string           $username
+     * @return MessageInterface
+     */
+    public function repositories($username)
+    {
+        return $this->getClient()->setApiVersion('2.0')->get(
+            sprintf('repositories/%s', $username)
+        );
+    }
+
     /**
      * Get account
      *

test/Bitbucket/Tests/API/UsersTest.php

@@ -20,6 +20,78 @@ public function setUp()
         );
     }
 
+    public function testGetUserPublicInformation()
+    {
+        $endpoint       = 'users/john-doe';
+        $expectedResult = $this->fakeResponse(array('dummy'));
+
+        $client = $this->getHttpClientMock();
+        $client->expects($this->once())
+            ->method('get')
+            ->with($endpoint)
+            ->will($this->returnValue($expectedResult));
+
+        /** @var \Bitbucket\API\Users $user */
+        $user   = $this->getClassMock('Bitbucket\API\Users', $client);
+        $actual = $user->get('john-doe');
+
+        $this->assertEquals($expectedResult, $actual);
+    }
+
+    public function testGetUserFollowers()
+    {
+        $endpoint       = 'users/john-doe/followers';
+        $expectedResult = $this->fakeResponse(array('dummy'));
+
+        $client = $this->getHttpClientMock();
+        $client->expects($this->once())
+            ->method('get')
+            ->with($endpoint)
+            ->will($this->returnValue($expectedResult));
+
+        /** @var \Bitbucket\API\Users $user */
+        $user   = $this->getClassMock('Bitbucket\API\Users', $client);
+        $actual = $user->followers('john-doe');
+
+        $this->assertEquals($expectedResult, $actual);
+    }
+
+    public function testGetUserFollowing()
+    {
+        $endpoint       = 'users/john-doe/following';
+        $expectedResult = $this->fakeResponse(array('dummy'));
+
+        $client = $this->getHttpClientMock();
+        $client->expects($this->once())
+            ->method('get')
+            ->with($endpoint)
+            ->will($this->returnValue($expectedResult));
+
+        /** @var \Bitbucket\API\Users $user */
+        $user   = $this->getClassMock('Bitbucket\API\Users', $client);
+        $actual = $user->following('john-doe');
+
+        $this->assertEquals($expectedResult, $actual);
+    }
+
+    public function testGetUserRepositories()
+    {
+        $endpoint       = 'repositories/john-doe';
+        $expectedResult = $this->fakeResponse(array('dummy'));
+
+        $client = $this->getHttpClientMock();
+        $client->expects($this->once())
+            ->method('get')
+            ->with($endpoint)
+            ->will($this->returnValue($expectedResult));
+
+        /** @var \Bitbucket\API\Users $user */
+        $user   = $this->getClassMock('Bitbucket\API\Users', $client);
+        $actual = $user->repositories('john-doe');
+
+        $this->assertEquals($expectedResult, $actual);
+    }
+
     public function testGetAccountInstance()
     {
         $this->assertInstanceOf('\Bitbucket\API\Users\Account', $this->users->account());
@@ -49,4 +121,4 @@ public function testGetSshKeysInstance()
     {
         $this->assertInstanceOf('\Bitbucket\API\Users\SshKeys', $this->users->sshKeys());
     }
-}
+}