Added missing Apps endpoints (#814)

* add Apps endpoint /apps/installations/:installation_id:

* add Apps endpoint delete /apps/installations/:installation_id:

* add Apps endpoint get /org/:org:/installation

* add Apps endpoint get /repos/:owner/:repo/installation

* add Apps endpoint get /users/:username/installation

* fix styling of comments

* use the configurePreviewHeader() function in newly added endpoints

* switch to camel casing for some arg names

Author: jamiehuson

lib/Github/Api/Apps.php

@@ -53,6 +53,85 @@ public function findInstallations()
         return $this->get('/app/installations');
     }
 
+    /**
+     * Get an installation of the application.
+     *
+     * @link https://developer.github.com/v3/apps/#get-an-installation
+     *
+     * @param $installationId An integration installation id
+     *
+     * @return array
+     */
+    public function getInstallation($installationId)
+    {
+        $this->configurePreviewHeader();
+
+        return $this->get('/app/installations/'.rawurldecode($installationId));
+    }
+
+    /**
+     * Get an installation of the application for an organization.
+     *
+     * @link https://developer.github.com/v3/apps/#get-an-organization-installation
+     *
+     * @param $org An organization
+     *
+     * @return array
+     */
+    public function getInstallationForOrganization($org)
+    {
+        $this->configurePreviewHeader();
+
+        return $this->get('/org/'.rawurldecode($org).'/installation');
+    }
+
+    /**
+     * Get an installation of the application for a repository.
+     *
+     * @link https://developer.github.com/v3/apps/#get-a-repository-installation
+     *
+     * @param $owner the owner of a repository
+     * @param $repo the name of the repository
+     *
+     * @return array
+     */
+    public function getInstallationForRepo($owner, $repo)
+    {
+        $this->configurePreviewHeader();
+
+        return $this->get('/repos/'.rawurldecode($owner).'/'.rawurldecode($repo).'/installation');
+    }
+
+    /**
+     * Get an installation of the application for a user.
+     *
+     * @link https://developer.github.com/v3/apps/#get-a-user-installation
+     *
+     * @param $username
+     *
+     * @return array
+     */
+    public function getInstallationForUser($username)
+    {
+        $this->configurePreviewHeader();
+
+        return $this->get('/users/'.rawurldecode($username).'/installation');
+    }
+
+    /**
+     * Delete an installation of the application.
+     *
+     * @link https://developer.github.com/v3/apps/#delete-an-installation
+     *
+     * @param $installationId An integration installation id
+     */
+    public function removeInstallation($installationId)
+    {
+        $this->configurePreviewHeader();
+
+        $this->delete('/app/installations/'.rawurldecode($installationId));
+    }
+
     /**
      * List repositories that are accessible to the authenticated installation.
      *

test/Github/Tests/Api/AppTest.php

@@ -27,7 +27,7 @@ public function shouldCreateInstallationTokenForInstallation()
     /**
      * @test
      */
-    public function shouldFindRepositoriesForApplication()
+    public function shouldFindInstallationsForApplication()
     {
         $result = ['installation1', 'installation2'];
 
@@ -40,6 +40,84 @@ public function shouldFindRepositoriesForApplication()
         $this->assertEquals($result, $api->findInstallations());
     }
 
+    /**
+     * @test
+     */
+    public function shouldGetInstallationForApplication()
+    {
+        $result = ['installation1'];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/app/installations/1234')
+            ->willReturn($result);
+
+        $this->assertEquals($result, $api->getInstallation('1234'));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldGetInstallationForOrganization()
+    {
+        $result = ['installation1'];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/org/1234/installation')
+            ->willReturn($result);
+
+        $this->assertEquals($result, $api->getInstallationForOrganization('1234'));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldGetInstallationForRepo()
+    {
+        $result = ['installation1'];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/repos/MyOrg/MyRepo/installation')
+            ->willReturn($result);
+
+        $this->assertEquals($result, $api->getInstallationForRepo('MyOrg', 'MyRepo'));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldGetInstallationForUser()
+    {
+        $result = ['installation1'];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/users/octocat/installation')
+            ->willReturn($result);
+
+        $this->assertEquals($result, $api->getInstallationForUser('octocat'));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldDeleteInstallationForApplication()
+    {
+        $id = 123;
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('delete')
+            ->with('/app/installations/'.$id);
+
+        $api->removeInstallation($id);
+    }
+
     /**
      * @test
      */