feature KnpLabs#1041 Feature get authenticated app (kdaniel95)

This PR was squashed before being merged into the 3.4.x-dev branch.

Discussion
----------

https://docs.github.com/en/rest/reference/apps#get-the-authenticated-app

Create endpoint to get authenticated app. 

Commits
-------

090a967 Feat: Get authenticated app
ce3d0fd Fix endpoint doc
d666ddb Fix StyleCI issues
bb14d05 Merge remote-tracking branch 'origin/feature-get-authenticated-app' into feature-get-authenticated-app

doc/apps.md

@@ -49,3 +49,9 @@ $client->api('apps')->addRepository($installationId, $repositoryId);
 ```php
 $client->api('apps')->removeRepository($installationId, $repositoryId);
 ```
+
+### Get authenticated app
+
+```php
+$authenticatedApp = $client->api('apps')->getAuthenticatedApp();
+```

lib/Github/Api/Apps.php

@@ -186,4 +186,16 @@ public function removeRepository($installationId, $repositoryId)
 
         return $this->delete('/installations/'.$installationId.'/repositories/'.$repositoryId);
     }
+
+    /**
+     * Get the currently authenticated app.
+     *
+     * @link https://docs.github.com/en/rest/reference/apps#get-the-authenticated-app
+     *
+     * @return array
+     */
+    public function getAuthenticatedApp()
+    {
+        return $this->get('/app');
+    }
 }

test/Github/Tests/Api/AppTest.php

@@ -160,6 +160,23 @@ public function shouldRemoveRepositoryToInstallation()
         $api->removeRepository('1234', '5678');
     }
 
+    /**
+     * @test
+     */
+    public function shouldGetAuthenticatedApp()
+    {
+        $api = $this->getApiMock();
+
+        $result = ['authenticatedApp1'];
+
+        $api->expects($this->once())
+            ->method('get')
+            ->with('/app')
+            ->willReturn($result);
+
+        $this->assertEquals($result, $api->getAuthenticatedApp());
+    }
+
     /**
      * @return string
      */