implemented Comments::get and Comments::all for Commits (API 2.0)

Author: vimishor

docs/repositories/commits.md

@@ -40,4 +40,5 @@ $commits->deleteApproval($account_name, $repo_slug, $commitSHA1);
 
 #### Related:
   * [Authentication](../authentication.md)
+  * [Commit(s) comments](commits/comments.md)
   * [BB Wiki](https://confluence.atlassian.com/x/doA7Fw)

docs/repositories/commits/comments.md

@@ -0,0 +1,26 @@
+## Commits comments
+
+---
+Manage commits comments.
+
+### Prepare:
+```php
+$commit = new Bitbucket\API\Repositories\Commits();
+$commit->setCredentials( new Bitbucket\API\Authentication\Basic($bb_user, $bb_pass) );
+```
+
+### Get a list of a commit comments: (API 2.0)
+```php
+$commit->comments()->all($account_name, $repo_slug, $commitSHA1)
+```
+
+### Get an individual commit comment: (API 2.0)
+```php
+$commit->comments()->get($account_name, $repo_slug, $commitSHA1, $commentID)
+```
+
+----
+
+#### Related:
+  * [Authentication](../../authentication.md)
+  * [Commit(s)](../commits.md)

lib/Bitbucket/API/Repositories/Commits.php

@@ -92,4 +92,16 @@ public function deleteApproval($account, $repo, $revision)
             sprintf('repositories/%s/%s/commit/%s/approve', $account, $repo, $revision)
         );
     }
+
+    /**
+     * Get comments
+     *
+     * @access public
+     * @return Commits\Comments
+     * @codeCoverageIgnore
+     */
+    public function comments()
+    {
+        return $this->childFactory('Repositories\\Commits\\Comments');
+    }
 }

lib/Bitbucket/API/Repositories/Commits/Comments.php

@@ -0,0 +1,54 @@
+<?php
+
+/**
+ * This file is part of the bitbucket-api package.
+ *
+ * (c) Alexandru G. <alex@gentle.ro>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Bitbucket\API\Repositories\Commits;
+
+use Bitbucket\API\Api;
+use Buzz\Message\MessageInterface;
+
+/**
+ * @author  Alexandru G.    <alex@gentle.ro>
+ */
+class Comments extends Api
+{
+    /**
+     * Get a list of a commit comments
+     *
+     * @access public
+     * @param  string           $account  The team or individual account owning the repository.
+     * @param  string           $repo     The repository identifier.
+     * @param  string           $revision A SHA1 value for the commit.
+     * @return MessageInterface
+     */
+    public function all($account, $repo, $revision)
+    {
+        return $this->getClient()->setApiVersion('2.0')->get(
+            sprintf('repositories/%s/%s/commit/%s/comments', $account, $repo, $revision)
+        );
+    }
+
+    /**
+     * Get an individual commit comment
+     *
+     * @access public
+     * @param  string           $account   The team or individual account owning the repository.
+     * @param  string           $repo      The repository identifier.
+     * @param  string           $revision  A SHA1 value for the commit.
+     * @param  int              $commentID The comment identifier.
+     * @return MessageInterface
+     */
+    public function get($account, $repo, $revision, $commentID)
+    {
+        return $this->getClient()->setApiVersion('2.0')->get(
+            sprintf('repositories/%s/%s/commit/%s/comments/%d', $account, $repo, $revision, $commentID)
+        );
+    }
+}

test/Bitbucket/Tests/API/Repositories/Commits/CommentsTest.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Bitbucket\Tests\API\Repositories\PullRequest;
+
+use Bitbucket\Tests\API as Tests;
+use Bitbucket\API;
+
+class CommitsTest extends Tests\TestCase
+{
+    public function testGetAllComments()
+    {
+        $endpoint       = 'repositories/gentle/eof/commit/SHA1/comments';
+        $expectedResult = $this->fakeResponse(array('dummy'));
+
+        $client = $this->getHttpClientMock();
+        $client->expects($this->once())
+            ->method('get')
+            ->with($endpoint)
+            ->will($this->returnValue($expectedResult));
+
+        /** @var \Bitbucket\API\Repositories\Commits\Comments $comments */
+        $comments   = $this->getClassMock('Bitbucket\API\Repositories\Commits\Comments', $client);
+        $actual     = $comments->all('gentle', 'eof', 'SHA1');
+
+        $this->assertEquals($expectedResult, $actual);
+    }
+
+    public function testGetSingleComment()
+    {
+        $endpoint       = 'repositories/gentle/eof/commit/SHA1/comments/1';
+        $expectedResult = $this->fakeResponse(array('dummy'));
+
+        $client = $this->getHttpClientMock();
+        $client->expects($this->once())
+            ->method('get')
+            ->with($endpoint)
+            ->will($this->returnValue($expectedResult));
+
+        /** @var \Bitbucket\API\Repositories\Commits\Comments $comments */
+        $comments   = $this->getClassMock('Bitbucket\API\Repositories\Commits\Comments', $client);
+        $actual     = $comments->get('gentle', 'eof', 'SHA1', 1);
+
+        $this->assertEquals($expectedResult, $actual);
+    }
+}