implemented PullRequests::decline (API 2.0)

Author: vimishor

docs/repositories/pullrequests.md

@@ -91,6 +91,13 @@ $pull->accept($account_name, $repo_slug, 1, array(
 ));
 ```
 
+### Decline a pull request:
+```php
+$pull->accept($account_name, $repo_slug, 1, array(
+    'message' => 'Please update the docs to reflect new changes.'
+));
+```
+
 ----
 
 #### Related:

lib/Bitbucket/API/Repositories/PullRequests.php

@@ -254,4 +254,22 @@ public function accept($account, $repo, $id, $params = array())
             $params
         );
     }
+
+    /**
+     * Decline a pull request
+     *
+     * @access public
+     * @param  string           $account The team or individual account owning the repository.
+     * @param  string           $repo    The repository identifier.
+     * @param  int              $id      (Optional) ID of the pull request
+     * @param  array            $params  Additional parameters.
+     * @return MessageInterface
+     */
+    public function decline($account, $repo, $id, $params = array())
+    {
+        return $this->getClient()->setApiVersion('2.0')->post(
+            sprintf('repositories/%s/%s/pullrequests/%d/decline', $account, $repo, $id),
+            $params
+        );
+    }
 }

test/Bitbucket/Tests/API/Repositories/PullRequestsTest.php

@@ -273,4 +273,22 @@ public function testAcceptAndMergeAPullRequest()
 
         $pull->accept('gentle', 'eof', 1, $params);
     }
+
+    public function testDeclineAPullRequest()
+    {
+        $endpoint   = 'repositories/gentle/eof/pullrequests/1/decline';
+        $params     = array(
+            'message' => 'Please update the test suite.',
+        );
+
+        $client = $this->getHttpClientMock();
+        $client->expects($this->once())
+            ->method('post')
+            ->with($endpoint, $params);
+
+        /** @var \Bitbucket\API\Repositories\PullRequests $pull */
+        $pull   = $this->getClassMock('Bitbucket\API\Repositories\PullRequests', $client);
+
+        $pull->decline('gentle', 'eof', 1, $params);
+    }
 }