feature #944 automated security endpoints (#868) (lexor)

This PR was merged into the 2.x branch.

Discussion
----------

Added automated security endpoints.

Documentations: 
- https://developer.github.com/changes/2019-06-04-automated-security-fixes
- https://docs.github.com/en/free-pro-team@latest/rest/reference/repos#enable-automated-security-fixes
- https://docs.github.com/en/free-pro-team@latest/rest/reference/repos#disable-automated-security-fixes

Commits
-------

295f272 feat(repo): added automated security endpoints

doc/repos.md

@@ -271,6 +271,22 @@ $languages = $client->api('repo')->languages('ornicar', 'php-github-api');
 
 Returns a list of languages.
 
+### Enable automated security fixes
+
+https://docs.github.com/en/free-pro-team@latest/rest/reference/repos#enable-automated-security-fixes
+
+```php
+$client->api('repo')->enableAutomatedSecurityFixes('KnpLabs', 'php-github-api');
+```
+
+### Disable automated security fixes
+
+https://docs.github.com/en/free-pro-team@latest/rest/reference/repos#disable-automated-security-fixes
+
+```php
+$client->api('repo')->disableAutomatedSecurityFixes('KnpLabs', 'php-github-api');
+```
+
 ### Get the contributors of a repository
 
 ```php

lib/Github/Api/Repo.php

@@ -693,6 +693,36 @@ public function milestones($username, $repository, array $parameters = [])
         return $this->get('/repos/'.rawurldecode($username).'/'.rawurldecode($repository).'/milestones', $parameters);
     }
 
+    /**
+     * @link https://docs.github.com/en/free-pro-team@latest/rest/reference/repos#enable-automated-security-fixes
+     *
+     * @param string $username
+     * @param string $repository
+     *
+     * @return array|string
+     */
+    public function enableAutomatedSecurityFixes(string $username, string $repository)
+    {
+        $this->acceptHeaderValue = 'application/vnd.github.london-preview+json';
+
+        return $this->put('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/automated-security-fixes');
+    }
+
+    /**
+     * @link https://docs.github.com/en/free-pro-team@latest/rest/reference/repos#disable-automated-security-fixes
+     *
+     * @param string $username
+     * @param string $repository
+     *
+     * @return array|string
+     */
+    public function disableAutomatedSecurityFixes(string $username, string $repository)
+    {
+        $this->acceptHeaderValue = 'application/vnd.github.london-preview+json';
+
+        return $this->delete('/repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/automated-security-fixes');
+    }
+
     public function projects()
     {
         return new Projects($this->client);

test/Github/Tests/Api/RepoTest.php

@@ -2,6 +2,9 @@
 
 namespace Github\Tests\Api;
 
+use Github\Api\Repo;
+use PHPUnit\Framework\MockObject\MockObject;
+
 class RepoTest extends TestCase
 {
     /**
@@ -264,6 +267,44 @@ public function shouldGetRepositoryMilestones()
         $this->assertEquals($expectedArray, $api->milestones('KnpLabs', 'php-github-api'));
     }
 
+    /**
+     * @test
+     */
+    public function shouldEnableAutomatedSecurityFixes()
+    {
+        $expectedResponse = 'response';
+
+        /** @var Repo|MockObject $api */
+        $api = $this->getApiMock();
+
+        $api
+            ->expects($this->once())
+            ->method('put')
+            ->with('/repos/KnpLabs/php-github-api/automated-security-fixes')
+            ->will($this->returnValue($expectedResponse));
+
+        $this->assertEquals($expectedResponse, $api->enableAutomatedSecurityFixes('KnpLabs', 'php-github-api'));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldDisableAutomatedSecurityFixes()
+    {
+        $expectedResponse = 'response';
+
+        /** @var Repo|MockObject $api */
+        $api = $this->getApiMock();
+
+        $api
+            ->expects($this->once())
+            ->method('delete')
+            ->with('/repos/KnpLabs/php-github-api/automated-security-fixes')
+            ->will($this->returnValue($expectedResponse));
+
+        $this->assertEquals($expectedResponse, $api->disableAutomatedSecurityFixes('KnpLabs', 'php-github-api'));
+    }
+
     /**
      * @test
      */