Merge pull request #275 from KnpLabs/feature/latest-release

Latest actual release + release by tag

Author: cursedcoder

doc/repo/releases.md

@@ -3,6 +3,17 @@
 
 This Github API Endpoint is currently undocumented because it's new, but works just fine.
 
+### Get latest actual release
+
+```php
+$release = $client->api('repo')->releases()->latest('twbs', 'bootstrap');
+```
+
+### List releases for a tag
+
+```php
+$release = $client->api('repo')->releases()->all('twbs', 'bootstrap', 'd890eec');
+```
 
 ### List all releases
 

lib/Github/Api/Repository/Releases.php

@@ -12,6 +12,33 @@
  */
 class Releases extends AbstractApi
 {
+    /**
+     * Get the latest release.
+     *
+     * @param $username
+     * @param $repository
+     * 
+     * @return array
+     */
+    public function latest($username, $repository)
+    {
+        return $this->get('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/releases/latest');
+    }
+
+    /**
+     * List releases for a tag.
+     *
+     * @param $username
+     * @param $repository
+     * @param $tag
+     *
+     * @return array
+     */
+    public function tag($username, $repository, $tag)
+    {
+        return $this->get('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/releases/tags/'.rawurlencode($tag));
+    }
+
     /**
      * List releases in selected repository.
      *

test/Github/Tests/Api/Repository/ReleasesTest.php

@@ -6,6 +6,42 @@
 
 class ReleasesTest extends TestCase
 {
+    /**
+     * @test
+     */
+    public function shouldGetLatestRelease()
+    {
+        $expectedValue = array('latest_release_data');
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('repos/KnpLabs/php-github-api/releases/latest')
+            ->will($this->returnValue($expectedValue));
+
+        $this->assertEquals($expectedValue, $api->latest('KnpLabs', 'php-github-api'));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldGetReleaseByTag()
+    {
+        $expectedValue = array('latest_release_data');
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('repos/KnpLabs/php-github-api/releases/tags/5f078080e01e0365690920d618f12342d2c941c8')
+            ->will($this->returnValue($expectedValue));
+
+        $this->assertEquals($expectedValue, $api->tag(
+            'KnpLabs',
+            'php-github-api',
+            '5f078080e01e0365690920d618f12342d2c941c8'
+        ));
+    }
+
     /**
      * @test
      */