tests: added geocoding resource tests

Author: andrepimpao

src/Test/Util/TestExceptionsTrait.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace ProgrammatorDev\OpenWeatherMap\Test\Util;
+
+use PHPUnit\Framework\Attributes\DataProvider;
+use ProgrammatorDev\Validator\Exception\ValidationException;
+
+trait TestExceptionsTrait
+{
+    #[DataProvider(methodName: 'provideValidationExceptionData')]
+    public function testValidationException(string $resource, string $method, ?array $args = null): void
+    {
+        $this->expectException(ValidationException::class);
+        $this->api->$resource()->$method(...$args);
+    }
+}

src/Test/Util/TestResponsesTrait.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace ProgrammatorDev\OpenWeatherMap\Test\Util;
+
+use Nyholm\Psr7\Response;
+use PHPUnit\Framework\Attributes\DataProvider;
+
+trait TestResponsesTrait
+{
+    #[DataProvider(methodName: 'provideCollectionResponseData')]
+    public function testCollectionResponse(
+        string $responseClass,
+        string $responseBody,
+        string $resource,
+        string $method,
+        ?array $args = null
+    ): void
+    {
+        $this->mockClient->addResponse(new Response(
+            status: 200,
+            body: $responseBody
+        ));
+
+        $response = $this->api->$resource()->$method(...$args);
+        $this->assertContainsOnlyInstancesOf($responseClass, $response);
+    }
+
+    #[DataProvider(methodName: 'provideItemResponseData')]
+    public function testItemResponse(
+        string $responseClass,
+        string $responseBody,
+        string $resource,
+        string $method,
+        ?array $args = null
+    ): void
+    {
+        $this->mockClient->addResponse(new Response(
+            status: 200,
+            body: $responseBody
+        ));
+
+        $response = $this->api->$resource()->$method(...$args);
+        $this->assertInstanceOf($responseClass, $response);
+    }
+}

tests/Integration/GeocodingResourceTest.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace ProgrammatorDev\OpenWeatherMap\Test\Integration;
+
+use ProgrammatorDev\OpenWeatherMap\Entity\Location;
+use ProgrammatorDev\OpenWeatherMap\Test\AbstractTest;
+use ProgrammatorDev\OpenWeatherMap\Test\MockResponse;
+use ProgrammatorDev\OpenWeatherMap\Test\Util\TestExceptionsTrait;
+use ProgrammatorDev\OpenWeatherMap\Test\Util\TestResponsesTrait;
+
+class GeocodingResourceTest extends AbstractTest
+{
+    use TestResponsesTrait;
+    use TestExceptionsTrait;
+
+    public static function provideCollectionResponseData(): \Generator
+    {
+        yield 'get by location name' => [
+            Location::class,
+            MockResponse::GEOCODING_DIRECT,
+            'geocoding',
+            'getByLocationName',
+            ['test']
+        ];
+        yield 'get by coordinate' => [
+            Location::class,
+            MockResponse::GEOCODING_REVERSE,
+            'geocoding',
+            'getByCoordinate',
+            [50, 50]
+        ];
+    }
+
+    public static function provideItemResponseData(): \Generator
+    {
+        yield 'get by zip code' => [
+            Location::class,
+            MockResponse::GEOCODING_ZIP,
+            'geocoding',
+            'getByZipCode',
+            ['1000-001', 'pt']
+        ];
+    }
+
+    public static function provideValidationExceptionData(): \Generator
+    {
+        yield 'get by location name, blank value' => ['geocoding', 'getByLocationName', ['']];
+        yield 'get by location name, zero num results' => ['geocoding', 'getByLocationName', ['test', 0]];
+        yield 'get by coordinate, latitude lower than -90' => ['geocoding', 'getByCoordinate', [-91, 50]];
+        yield 'get by coordinate, latitude greater than 90' => ['geocoding', 'getByCoordinate', [91, 50]];
+        yield 'get by coordinate, longitude lower than -180' => ['geocoding', 'getByCoordinate', [50, -181]];
+        yield 'get by coordinate, longitude greater than 180' => ['geocoding', 'getByCoordinate', [50, 181]];
+        yield 'get by coordinate, zero num results' => ['geocoding', 'getByCoordinate', [50, 50, 0]];
+        yield 'get by zip code, blank zip code' => ['geocoding', 'getByZipCode', ['', 'pt']];
+        yield 'get by zip code, blank country code' => ['geocoding', 'getByZipCode', ['1000-001', '']];
+        yield 'get by zip code, invalid country code' => ['geocoding', 'getByZipCode', ['1000-001', 'invalid']];
+    }
+}