diff --git a/src/Api/Groups.php b/src/Api/Groups.php
index 7104d345..74d63f13 100644
--- a/src/Api/Groups.php
+++ b/src/Api/Groups.php
@@ -854,4 +854,18 @@ public function search(int|string $id, array $parameters = []): mixed
return $this->get('groups/'.self::encodePath($id).'/search', $resolver->resolve($parameters));
}
+
+ /**
+ * Get a list of registry repositories in a group.
+ *
+ * @see https://docs.gitlab.com/ee/api/container_registry.html#within-a-group
+ *
+ * @param $id: The ID of a group
+ *
+ * @return mixed
+ */
+ public function registryRepositories(int $id)
+ {
+ return $this->get('groups/'.self::encodePath($id).'/registry/repositories');
+ }
}
diff --git a/src/Api/Projects.php b/src/Api/Projects.php
index 32aa168a..97c29ecb 100644
--- a/src/Api/Projects.php
+++ b/src/Api/Projects.php
@@ -1280,4 +1280,33 @@ public function search(int|string $id, array $parameters = []): mixed
return $this->get('projects/'.self::encodePath($id).'/search', $resolver->resolve($parameters));
}
+
+ /**
+ * @see https://docs.gitlab.com/ee/api/container_registry.html#within-a-project
+ *
+ * @param int|string $project_id
+ * @param array $parameters {
+ *
+ * @var bool $tags if the parameter is included as true, each repository includes an array of "tags" in the response
+ * @var bool $tags_count If the parameter is included as true, each repository includes "tags_count" in the response.
+ * }
+ *
+ * @return mixed
+ */
+ public function registryRepositories($project_id, array $parameters = [])
+ {
+ $resolver = $this->createOptionsResolver();
+ $booleanNormalizer = function (Options $resolver, $value): string {
+ return $value ? 'true' : 'false';
+ };
+
+ $resolver->setDefined('tags')
+ ->setAllowedTypes('tags', 'bool')
+ ->setNormalizer('tags', $booleanNormalizer);
+ $resolver->setDefined('tags_count')
+ ->setAllowedTypes('tags_count', 'bool')
+ ->setNormalizer('tags_count', $booleanNormalizer);
+
+ return $this->get($this->getProjectPath($project_id, 'registry/repositories'), $resolver->resolve($parameters));
+ }
}
diff --git a/src/Api/Registry.php b/src/Api/Registry.php
new file mode 100644
index 00000000..5fdc0103
--- /dev/null
+++ b/src/Api/Registry.php
@@ -0,0 +1,136 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the Gitlab API library.
+ *
+ * (c) Matt Humphrey <matth@windsor-telecom.co.uk>
+ * (c) Graham Campbell <hello@gjcampbell.co.uk>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Gitlab\Api;
+
+use Symfony\Component\OptionsResolver\Options;
+
+class Registry extends AbstractApi
+{
+ /**
+ * @see https://docs.gitlab.com/ee/api/container_registry.html#get-details-of-a-single-repository
+ *
+ * @param int|string $repository_id The ID of the registry repository accessible by the authenticated user
+ * @param array $parameters {
+ *
+ * @var bool $tags
+ * @var bool $tags_count
+ * @var bool $size
+ * }
+ *
+ * @return mixed
+ */
+ public function repositories($repository_id, array $parameters = [])
+ {
+ $resolver = $this->createOptionsResolver();
+ $booleanNormalizer = function (Options $resolver, $value): string {
+ return $value ? 'true' : 'false';
+ };
+
+ $resolver->setDefined('tags')
+ ->setAllowedTypes('tags', 'bool')
+ ->setNormalizer('tags', $booleanNormalizer);
+ $resolver->setDefined('tags_count')
+ ->setAllowedTypes('tags_count', 'bool')
+ ->setNormalizer('tags_count', $booleanNormalizer);
+ $resolver->setDefined('size')
+ ->setAllowedTypes('size', 'bool')
+ ->setNormalizer('size', $booleanNormalizer);
+
+ return $this->get('registry/repositories/'.self::encodePath($repository_id), $resolver->resolve($parameters));
+ }
+
+ /**
+ * @see https://docs.gitlab.com/ee/api/container_registry.html#list-registry-repository-tags
+ *
+ * @param int|string $project_id
+ *
+ * @return mixed
+ */
+ public function repositoryTags($project_id, int $repository_id)
+ {
+ return $this->get(
+ $this->getProjectPath($project_id, 'registry/repositories/'.self::encodePath($repository_id).'/tags')
+ );
+ }
+
+ /**
+ * @see https://docs.gitlab.com/ee/api/container_registry.html#get-details-of-a-registry-repository-tag
+ *
+ * @param int|string $project_id
+ *
+ * @return mixed
+ */
+ public function repositoryTag($project_id, int $repository_id, string $tag_name)
+ {
+ return $this->get(
+ $this->getProjectPath(
+ $project_id,
+ 'registry/repositories/'.self::encodePath($repository_id).'/tags/'.self::encodePath($tag_name)
+ )
+ );
+ }
+
+ /**
+ * @see https://docs.gitlab.com/ee/api/container_registry.html#delete-a-registry-repository-tag
+ *
+ * @param int|string $project_id
+ *
+ * @return mixed
+ */
+ public function removeRepositoryTag($project_id, int $repository_id, string $tag_name)
+ {
+ return $this->delete(
+ $this->getProjectPath(
+ $project_id,
+ 'registry/repositories/'.self::encodePath($repository_id).'/tags/'.self::encodePath($tag_name)
+ )
+ );
+ }
+
+ /**
+ * @see https://docs.gitlab.com/ee/api/container_registry.html#delete-registry-repository-tags-in-bulk
+ *
+ * @param int|string $project_id
+ * @param array $parameters {
+ *
+ * @var string $name_regex_delete
+ * @var string $name_regex_keep
+ * @var int $keep_n
+ * @var string $older_than
+ * }
+ *
+ * @return mixed
+ */
+ public function removeRepositoryTags($project_id, int $repository_id, array $parameters = [])
+ {
+ $resolver = $this->createOptionsResolver();
+ $resolver->setRequired('name_regex_delete')
+ ->setAllowedTypes('name_regex_delete', 'string');
+ $resolver->setDefined('name_regex_keep')
+ ->setAllowedTypes('name_regex_keep', 'string');
+ $resolver->setDefined('keep_n')
+ ->setAllowedTypes('keep_n', 'int');
+ $resolver->setDefined('older_than')
+ ->setAllowedTypes('older_than', 'string');
+
+ return $this->delete(
+ $this->getProjectPath(
+ $project_id,
+ 'registry/repositories/'.self::encodePath($repository_id).'/tags'
+ ),
+ $resolver->resolve($parameters)
+ );
+ }
+}
diff --git a/src/Client.php b/src/Client.php
index ee4ff8a7..c74ec9da 100644
--- a/src/Client.php
+++ b/src/Client.php
@@ -32,6 +32,7 @@
use Gitlab\Api\Milestones;
use Gitlab\Api\ProjectNamespaces;
use Gitlab\Api\Projects;
+use Gitlab\Api\Registry;
use Gitlab\Api\Repositories;
use Gitlab\Api\RepositoryFiles;
use Gitlab\Api\ResourceIterationEvents;
@@ -245,6 +246,11 @@ public function projects(): Projects
return new Projects($this);
}
+ public function registry(): Registry
+ {
+ return new Registry($this);
+ }
+
public function repositories(): Repositories
{
return new Repositories($this);
diff --git a/tests/Api/GroupsTest.php b/tests/Api/GroupsTest.php
index 3b90e6f2..dfe02289 100644
--- a/tests/Api/GroupsTest.php
+++ b/tests/Api/GroupsTest.php
@@ -882,4 +882,24 @@ public function shouldSearchGroups(): void
'sort' => 'desc',
]));
}
+
+ /**
+ * @test
+ */
+ public function shouldGetGroupRegistryRepositories(): void
+ {
+ $expectedArray = [
+ ['id' => 1, 'name' => 'A registry'],
+ ['id' => 2, 'name' => 'Another registry'],
+ ];
+
+ $api = $this->getApiMock();
+ $api->expects($this->once())
+ ->method('get')
+ ->with('groups/1/registry/repositories')
+ ->will($this->returnValue($expectedArray))
+ ;
+
+ $this->assertEquals($expectedArray, $api->registryRepositories(1));
+ }
}
diff --git a/tests/Api/ProjectsTest.php b/tests/Api/ProjectsTest.php
index 1ef556ea..9c004ed8 100644
--- a/tests/Api/ProjectsTest.php
+++ b/tests/Api/ProjectsTest.php
@@ -2765,4 +2765,45 @@ public function shouldSearchGroups(): void
'sort' => 'desc',
]));
}
+
+ /**
+ * @test
+ */
+ public function shouldGetProjectRegistryRepositories(): void
+ {
+ $expectedArray = [
+ ['id' => 1, 'name' => 'A registry'],
+ ['id' => 2, 'name' => 'Another registry'],
+ ];
+
+ $api = $this->getApiMock();
+ $api->expects($this->once())
+ ->method('get')
+ ->with('projects/123/registry/repositories')
+ ->will($this->returnValue($expectedArray));
+
+ $this->assertEquals($expectedArray, $api->registryRepositories(123));
+ }
+
+ /**
+ * @test
+ */
+ public function shouldGetProjectRegistryRepositoriesTags(): void
+ {
+ $expectedArray = [
+ ['id' => 1, 'name' => 'A registry', 'tags' => ['1.0', '1.1'], 'tags_count' => 2],
+ ['id' => 2, 'name' => 'Another registry', 'tags' => ['2.0', '2.1'], 'tags_count' => 2],
+ ];
+
+ $api = $this->getApiMock();
+ $api->expects($this->once())
+ ->method('get')
+ ->with('projects/123/registry/repositories', [
+ 'tags' => true,
+ 'tags_count' => true,
+ ])
+ ->will($this->returnValue($expectedArray));
+
+ $this->assertEquals($expectedArray, $api->registryRepositories(123, ['tags' => true, 'tags_count' => true]));
+ }
}
diff --git a/tests/Api/RegistryTest.php b/tests/Api/RegistryTest.php
new file mode 100644
index 00000000..7c3ceeb6
--- /dev/null
+++ b/tests/Api/RegistryTest.php
@@ -0,0 +1,120 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the Gitlab API library.
+ *
+ * (c) Matt Humphrey <matth@windsor-telecom.co.uk>
+ * (c) Graham Campbell <hello@gjcampbell.co.uk>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Gitlab\Tests\Api;
+
+use Gitlab\Api\Registry;
+
+class RegistryTest extends TestCase
+{
+ protected function getApiClass(): string
+ {
+ return Registry::class;
+ }
+
+ /**
+ * @test
+ */
+ public function shouldGetSingleRepository(): void
+ {
+ $expectedArray = ['id' => 1, 'name' => 'John Doe'];
+
+ $api = $this->getApiMock();
+ $api->expects($this->once())
+ ->method('get')
+ ->with('registry/repositories/1')
+ ->willReturn($expectedArray);
+
+ $this->assertEquals($expectedArray, $api->repositories(1));
+ }
+
+ /**
+ * @test
+ */
+ public function shouldGetSingleRepositoryWithParams(): void
+ {
+ $expectedArray = ['id' => 1, 'name' => 'John Doe', 'tags' => ['tag1', 'tag2'], 'tags_count' => 2];
+
+ $api = $this->getApiMock();
+ $api->expects($this->once())
+ ->method('get')
+ ->with('registry/repositories/1', ['tags' => 'true', 'tags_count' => 'true'])
+ ->willReturn($expectedArray);
+
+ $this->assertEquals($expectedArray, $api->repositories(1, ['tags' => true, 'tags_count' => true]));
+ }
+
+ /**
+ * @test
+ */
+ public function shouldGetRepositoryTags(): void
+ {
+ $expectedArray = [['name' => 'A', 'path' => 'group/project:A'], ['name' => 'B', 'path' => 'group/project:B']];
+ $api = $this->getApiMock();
+ $api->expects($this->once())
+ ->method('get')
+ ->with('projects/1/registry/repositories/1/tags')
+ ->willReturn($expectedArray);
+
+ $this->assertEquals($expectedArray, $api->repositoryTags(1, 1));
+ }
+
+ /**
+ * @test
+ */
+ public function shouldGetRepositoryTag(): void
+ {
+ $expectedArray = ['name' => 'A', 'path' => 'group/project:A'];
+
+ $api = $this->getApiMock();
+ $api->expects($this->once())
+ ->method('get')
+ ->with('projects/1/registry/repositories/1/tags/A')
+ ->willReturn($expectedArray);
+
+ $this->assertEquals($expectedArray, $api->repositoryTag(1, 1, 'A'));
+ }
+
+ /**
+ * @test
+ */
+ public function shouldRemoveRepositoryTag(): void
+ {
+ $expectedBool = true;
+
+ $api = $this->getApiMock();
+ $api->expects($this->once())
+ ->method('delete')
+ ->with('projects/1/registry/repositories/1/tags/A')
+ ->will($this->returnValue($expectedBool));
+
+ $this->assertEquals($expectedBool, $api->removeRepositoryTag(1, 1, 'A'));
+ }
+
+ /**
+ * @test
+ */
+ public function shouldRemoveRepositoryTags(): void
+ {
+ $expectedBool = true;
+
+ $api = $this->getApiMock();
+ $api->expects($this->once())
+ ->method('delete')
+ ->with('projects/1/registry/repositories/1/tags', ['name_regex_delete' => '.*', 'keep_n' => 12])
+ ->will($this->returnValue($expectedBool));
+
+ $this->assertEquals($expectedBool, $api->removeRepositoryTags(1, 1, ['name_regex_delete' => '.*', 'keep_n' => 12]));
+ }
+}