Adding Project Access Token API (GitLabPHP#634)

See https://docs.gitlab.com/ee/api/resource_access_tokens.html

Author: dorianboulch

src/Api/Projects.php

@@ -1217,4 +1217,70 @@ public function deleteAllMergedBranches($project_id)
     {
         return $this->delete($this->getProjectPath($project_id, 'repository/merged_branches'));
     }
+
+    /**
+     * @param int|string $project_id
+     *
+     * @return mixed
+     */
+    public function projectAccessTokens($project_id)
+    {
+        return $this->get($this->getProjectPath($project_id, 'access_tokens'));
+    }
+
+    /**
+     * @param int|string $project_id
+     * @param array      $parameters {
+     *
+     *     @var string $name                    the name of the project access token
+     *     @var array  $scopes                  the scopes, one or many of: api, read_api, read_registry, write_registry, read_repository, write_repository
+     *     @var \DateTimeInterface $expires_at  the token expires at midnight UTC on that date
+     * }
+     *
+     * @return mixed
+     */
+    public function createProjectAccessToken($project_id, array $parameters = [])
+    {
+        $resolver = $this->createOptionsResolver();
+        $datetimeNormalizer = function (Options $resolver, \DateTimeInterface $value): string {
+            return $value->format('Y-m-d');
+        };
+
+        $resolver->define('name')
+            ->required()
+        ;
+
+        $resolver->define('scopes')
+            ->required()
+            ->allowedTypes('array')
+            ->allowedValues(function ($scopes) {
+                $allowed = ['api', 'read_api', 'read_registry', 'write_registry', 'read_repository', 'write_repository'];
+                foreach ($scopes as $scope) {
+                    if (!\in_array($scope, $allowed, true)) {
+                        return false;
+                    }
+                }
+
+                return true;
+            })
+        ;
+
+        $resolver->setDefined('expires_at')
+            ->setAllowedTypes('expires_at', \DateTimeInterface::class)
+            ->setNormalizer('expires_at', $datetimeNormalizer)
+        ;
+
+        return $this->post($this->getProjectPath($project_id, 'access_tokens'), $resolver->resolve($parameters));
+    }
+
+    /**
+     * @param int|string $project_id
+     * @param int|string $token_id
+     *
+     * @return mixed
+     */
+    public function deleteProjectAccessToken($project_id, $token_id)
+    {
+        return $this->delete($this->getProjectPath($project_id, 'access_tokens/'.$token_id));
+    }
 }

tests/Api/ProjectsTest.php

@@ -2321,6 +2321,96 @@ public function shouldGetProtectedBranches(): void
         $this->assertEquals($expectedArray, $api->protectedBranches(1));
     }
 
+    /**
+     * @test
+     */
+    public function shouldGetProjectAccessTokens(): void
+    {
+        $expectedArray = [
+            [
+                'user_id' => 141,
+                'scopes' => [
+                    'api',
+                ],
+                'name' => 'token',
+                'expires_at' => '2021-01-31',
+                'id' => 42,
+                'active' => true,
+                'created_at' => '2021-01-20T22:11:48.151Z',
+                'revoked' => false,
+            ]
+        ];
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with('projects/1/access_tokens')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->projectAccessTokens(1));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldCreateProjectAccessToken(): void
+    {
+        $expectedArray = [
+            "scopes" => [
+                'api',
+                'read_repository',
+            ],
+            'active' => true,
+            'name' => "test",
+            'revoked' => false,
+            'created_at' => '2021-01-21T19:35:37.921Z',
+            'user_id' => 166,
+            'id' => 58,
+            'expires_at' => '2021-01-31',
+            'token' => "D4y...Wzr",
+        ];
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('post')
+            ->with(
+                'projects/1/access_tokens',
+                [
+                    'name' => 'test_token',
+                    'scopes' => [
+                        'api',
+                        'read_repository',
+                    ],
+                    'expires_at' => '2021-01-31'
+                ]
+            )
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->createProjectAccessToken(1, [
+            'name' => 'test_token',
+            'scopes' => [
+                'api',
+                'read_repository'
+            ],
+            'expires_at' => new DateTime('2021-01-31'),
+        ]));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldDeleteProjectAccessToken(): void
+    {
+        $expectedBool = true;
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('delete')
+            ->with('projects/1/access_tokens/2')
+            ->will($this->returnValue($expectedBool));
+
+        $this->assertEquals($expectedBool, $api->deleteProjectAccessToken(1, 2));
+    }
+
     protected function getApiClass()
     {
         return Projects::class;