implemented Users::get (API 2.0)

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

@@ -9,6 +9,13 @@ $users = new Bitbucket\API\Users();
 $users->setCredentials( new Bitbucket\API\Authentication\Basic($bb_user, $bb_pass) );
 ```
 
+### Get the public information associated with a user: (API 2.0)
+```php
+$users->get($username);
+```
+
+
+
 ----
 
 #### Related:

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,20 @@
  */
 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 account
      *

test/Bitbucket/Tests/API/UsersTest.php

@@ -20,6 +20,24 @@ 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 testGetAccountInstance()
     {
         $this->assertInstanceOf('\Bitbucket\API\Users\Account', $this->users->account());
@@ -49,4 +67,4 @@ public function testGetSshKeysInstance()
     {
         $this->assertInstanceOf('\Bitbucket\API\Users\SshKeys', $this->users->sshKeys());
     }
-}
+}