Add refs endpoint from v2.0

Add `refs` endpoint from 2.0 to fetch both tags and branches in one call

Author: odi-um

lib/Bitbucket/API/Repositories/Refs.php

@@ -0,0 +1,38 @@
+<?php
+/**
+ * This file is part of the bitbucket-api package.
+ *
+ * (c) Alexandru Guzinschi <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;
+
+use Bitbucket\API;
+use Buzz\Message\MessageInterface;
+
+/**
+ * @author  Kevin Howe    <kjhowe@gmail.com>
+ */
+class Refs extends API\Api
+{
+    /**
+     * Get a list of refs
+     *
+     * @access public
+     * @param  string           $account The team or individual account owning the repository.
+     * @param  string           $repo    The repository identifier.
+     * @param  string|array     $params  GET parameters
+     * @return MessageInterface
+     *
+     * @throws \InvalidArgumentException
+     */
+    public function all($account, $repo, array $params = array())
+    {
+        return $this->getClient()->setApiVersion('2.0')->get(
+            sprintf('repositories/%s/%s/refs', $account, $repo),
+            $params
+        );
+    }
+}

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

@@ -0,0 +1,47 @@
+<?php
+
+namespace Bitbucket\Tests\API\Repositories;
+
+use Bitbucket\Tests\API as Tests;
+
+class RefsTest extends Tests\TestCase
+{
+    public function testAll()
+    {
+        $endpoint       = 'repositories/gentle/eof/refs';
+        $expectedResult = json_encode('dummy');
+
+        $client = $this->getHttpClientMock();
+        $client->expects($this->once())
+            ->method('get')
+            ->with($endpoint)
+            ->will($this->returnValue($expectedResult));
+
+        $refs = $this->getClassMock('Bitbucket\API\Repositories\Refs', $client);
+
+        /** @var $refs \Bitbucket\API\Repositories\Refs */
+        $actual = $refs->all('gentle', 'eof');
+
+        $this->assertEquals($expectedResult, $actual);
+    }
+
+    public function testAllParams()
+    {
+        $params         = ['pagelen' => 36];
+        $endpoint       = 'repositories/gentle/eof/refs';
+        $expectedResult = json_encode('dummy');
+
+        $client = $this->getHttpClientMock();
+        $client->expects($this->once())
+            ->method('get')
+            ->with($endpoint, $params)
+            ->will($this->returnValue($expectedResult));
+
+        $refs = $this->getClassMock('Bitbucket\API\Repositories\Refs', $client);
+
+        /** @var $refs \Bitbucket\API\Repositories\Refs */
+        $actual = $refs->all('gentle', 'eof', $params);
+
+        $this->assertEquals($expectedResult, $actual);
+    }
+}