Merge pull request KnpLabs#463 from styxit/show-deployment

Add Deployment show method

Author: cursedcoder

doc/repo/deployments.md

@@ -15,6 +15,12 @@ You can also filter the returned results (see [the documentation](https://develo
 $deployments = $client->api('deployment')->all('KnpLabs', 'php-github-api', array('environment' => 'production'));
 ```
 
+### List one deployment.
+
+```php
+$deployment = $client->api('deployment')->show('KnpLabs', 'php-github-api', $id);
+```
+
 #### Create a new deployments.
 
 The `ref` parameter is required.

lib/Github/Api/Deployment.php

@@ -25,6 +25,20 @@ public function all($username, $repository, array $params = array())
         return $this->get('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/deployments', $params);
     }
 
+    /**
+     * Get a deployment in selected repository.
+     *
+     * @param string $username   the user who owns the repo
+     * @param string $repository the name of the repo
+     * @param int    $id         the id of the deployment
+     *
+     * @return array
+     */
+    public function show($username, $repository, $id)
+    {
+        return $this->get('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/deployments/'.rawurlencode($id));
+    }
+
     /**
      * Create a new deployment for the given username and repo.
      * @link https://developer.github.com/v3/repos/deployments/#create-a-deployment

test/Github/Tests/Api/DeploymentTest.php

@@ -46,6 +46,22 @@ public function shouldGetAllDeploymentsWithFilterParameters()
         $api->all('KnpLabs', 'php-github-api', $filterData);
     }
 
+    /**
+     * @test
+     */
+    public function shouldShowProject()
+    {
+        $expectedValue = array('id' => 123, 'ref' => 'master');
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/repos/KnpLabs/php-github-api/deployments/123')
+            ->will($this->returnValue($expectedValue));
+
+        $this->assertEquals($expectedValue, $api->show('KnpLabs', 'php-github-api', 123));
+    }
+
     /**
      * @test
      */