Add Droplet list filters

Author: GrahamCampbell

CHANGELOG.md

@@ -9,6 +9,7 @@ CHANGE LOG
 * Fixed hydration of object-backed App Platform and project resource fields
 * Fixed `LoadBalancer` hydration and update serialization
 * Fixed `Volume` hydration when `droplet_ids` is null
+* Add support for listing Droplets by name or type
 
 
 ## 5.0.5 (03/05/2025)

src/Api/Droplet.php

@@ -27,13 +27,29 @@
 class Droplet extends AbstractApi
 {
     /**
+     * @param 'droplets'|'gpus'|null $type
+     *
      * @throws ExceptionInterface
      *
      * @return DropletEntity[]
      */
-    public function getAll(?string $tag = null): array
+    public function getAll(?string $tag = null, ?string $name = null, ?string $type = null): array
     {
-        $droplets = $this->get('droplets', null === $tag ? [] : ['tag_name' => $tag]);
+        $query = [];
+
+        if (null !== $tag) {
+            $query['tag_name'] = $tag;
+        }
+
+        if (null !== $name) {
+            $query['name'] = $name;
+        }
+
+        if (null !== $type && \in_array($type, ['droplets', 'gpus'], true)) {
+            $query['type'] = $type;
+        }
+
+        $droplets = $this->get('droplets', $query);
 
         return \array_map(function ($droplet) {
             return new DropletEntity($droplet);

tests/Api/DropletTest.php

@@ -0,0 +1,108 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the DigitalOcean API library.
+ *
+ * (c) Antoine Kirk <contact@sbin.dk>
+ * (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 DigitalOceanV2\Tests\Api;
+
+use DigitalOceanV2\Api\Droplet;
+use DigitalOceanV2\Client;
+use DigitalOceanV2\Entity\Droplet as DropletEntity;
+use GuzzleHttp\Psr7\Response;
+use GuzzleHttp\Psr7\Utils;
+use Http\Client\Common\HttpMethodsClientInterface;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * @author Graham Campbell <hello@gjcampbell.co.uk>
+ */
+class DropletTest extends TestCase
+{
+    public function testItCreatesAnArrayOfDropletEntities(): void
+    {
+        $droplets = $this->createApiExpectingGet('/v2/droplets')->getAll();
+
+        self::assertInstanceOf(DropletEntity::class, $droplets[0]);
+        self::assertSame('example.com', $droplets[0]->name);
+    }
+
+    public function testItFiltersDropletsByTagName(): void
+    {
+        $droplets = $this->createApiExpectingGet('/v2/droplets?tag_name=awesome')->getAll('awesome');
+
+        self::assertInstanceOf(DropletEntity::class, $droplets[0]);
+        self::assertSame('example.com', $droplets[0]->name);
+    }
+
+    public function testItFiltersDropletsByName(): void
+    {
+        $droplets = $this->createApiExpectingGet('/v2/droplets?name=example.com')->getAll(name: 'example.com');
+
+        self::assertInstanceOf(DropletEntity::class, $droplets[0]);
+        self::assertSame('example.com', $droplets[0]->name);
+    }
+
+    public function testItFiltersDropletsByType(): void
+    {
+        $droplets = $this->createApiExpectingGet('/v2/droplets?type=gpus')->getAll(type: 'gpus');
+
+        self::assertInstanceOf(DropletEntity::class, $droplets[0]);
+        self::assertSame('example.com', $droplets[0]->name);
+    }
+
+    public function testItFiltersDropletsByStandardType(): void
+    {
+        $droplets = $this->createApiExpectingGet('/v2/droplets?type=droplets')->getAll(type: 'droplets');
+
+        self::assertInstanceOf(DropletEntity::class, $droplets[0]);
+        self::assertSame('example.com', $droplets[0]->name);
+    }
+
+    public function testItFiltersDropletsByNameAndType(): void
+    {
+        $droplets = $this->createApiExpectingGet('/v2/droplets?name=example.com&type=gpus')
+            ->getAll(name: 'example.com', type: 'gpus');
+
+        self::assertInstanceOf(DropletEntity::class, $droplets[0]);
+        self::assertSame('example.com', $droplets[0]->name);
+    }
+
+    private function createApiExpectingGet(string $uri): Droplet
+    {
+        $client = $this->createMock(Client::class);
+        $client->expects(self::once())
+            ->method('getHttpClient')
+            ->willReturn($httpClient = $this->createMock(HttpMethodsClientInterface::class));
+
+        $httpClient->expects(self::once())
+            ->method('get')
+            ->with($uri)
+            ->willReturn(self::createResponse());
+
+        return new Droplet($client);
+    }
+
+    private static function createResponse(): Response
+    {
+        return new Response(
+            200,
+            ['Content-Type' => ['application/json']],
+            Utils::streamFor(\json_encode(['droplets' => [
+                [
+                    'id' => 3164444,
+                    'name' => 'example.com',
+                    'features' => [],
+                ],
+            ]]))
+        );
+    }
+}