feat: added Language and UnitSystem traits

Author: andrepimpao

src/Endpoint/Util/LanguageTrait.php

@@ -55,7 +55,7 @@ class Language
     public const VIETNAMESE = 'vi';
     public const ZULU = 'zu';
 
-    public static function getList(): array
+    public static function getOptions(): array
     {
         return (new Language)->getClassConstants(self::class);
     }

src/Endpoint/Util/UnitSystemTrait.php

@@ -64,8 +64,8 @@ private function configureOptions(array $options): array
         $this->optionsResolver->setAllowedTypes('unitSystem', 'string');
         $this->optionsResolver->setAllowedTypes('language', 'string');
 
-        $this->optionsResolver->setAllowedValues('unitSystem', UnitSystem::getList());
-        $this->optionsResolver->setAllowedValues('language', Language::getList());
+        $this->optionsResolver->setAllowedValues('unitSystem', UnitSystem::getOptions());
+        $this->optionsResolver->setAllowedValues('language', Language::getOptions());
 
         return $this->optionsResolver->resolve($options);
     }

src/Language/Language.php

@@ -46,7 +46,7 @@ public function getByLocationName(string $locationName, int $numResults = self::
     public function getByZipCode(string $zipCode, string $countryCode): ZipLocation
     {
         $this->validateQuery($zipCode, 'zipCode');
-        $this->validateCountry($countryCode, 'countryCode');
+        $this->validateCountryCode($countryCode);
 
         $data = $this->api->request(
             method: 'GET',

src/OpenWeatherMap.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace ProgrammatorDev\OpenWeatherMap\Resource\Util;
+
+use ProgrammatorDev\Validator\Exception\ValidationException;
+use function DeepCopy\deep_copy;
+
+trait LanguageTrait
+{
+    use ValidationTrait;
+
+    /**
+     * @throws ValidationException
+     */
+    public function withLanguage(string $language): static
+    {
+        $this->validateLanguage($language);
+
+        $clone = deep_copy($this);
+        $clone->api->addQueryDefault('lang', $language);
+
+        return $clone;
+    }
+}

src/Resource/GeocodingResource.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace ProgrammatorDev\OpenWeatherMap\Resource\Util;
+
+use ProgrammatorDev\Validator\Exception\ValidationException;
+use function DeepCopy\deep_copy;
+
+trait UnitSystemTrait
+{
+    use ValidationTrait;
+
+    /**
+     * @throws ValidationException
+     */
+    public function withUnitSystem(string $unitSystem): static
+    {
+        $this->validateUnitSystem($unitSystem);
+
+        $clone = deep_copy($this);
+        $clone->api->addQueryDefault('units', $unitSystem);
+
+        return $clone;
+    }
+}

src/Resource/Util/LanguageTrait.php

@@ -2,6 +2,8 @@
 
 namespace ProgrammatorDev\OpenWeatherMap\Resource\Util;
 
+use ProgrammatorDev\OpenWeatherMap\Language\Language;
+use ProgrammatorDev\OpenWeatherMap\UnitSystem\UnitSystem;
 use ProgrammatorDev\Validator\Exception\ValidationException;
 use ProgrammatorDev\Validator\Validator;
 
@@ -35,8 +37,24 @@ private function validateCoordinate(float $latitude, float $longitude): void
     /**
      * @throws ValidationException
      */
-    private function validateCountry(string $countryCode, string $name): void
+    private function validateCountryCode(string $countryCode): void
     {
-        Validator::country()->assert($countryCode, $name);
+        Validator::country()->assert($countryCode, 'countryCode');
+    }
+
+    /**
+     * @throws ValidationException
+     */
+    private function validateLanguage(string $language): void
+    {
+        Validator::choice(Language::getOptions())->assert($language, 'language');
+    }
+
+    /**
+     * @throws ValidationException
+     */
+    private function validateUnitSystem(string $unitSystem): void
+    {
+        Validator::choice(UnitSystem::getOptions())->assert($unitSystem, 'unitSystem');
     }
 }

src/Resource/Util/UnitSystemTrait.php

@@ -5,12 +5,16 @@
 use ProgrammatorDev\Api\Method;
 use ProgrammatorDev\OpenWeatherMap\Entity\Weather\Weather;
 use ProgrammatorDev\OpenWeatherMap\Entity\Weather\WeatherCollection;
+use ProgrammatorDev\OpenWeatherMap\Resource\Util\LanguageTrait;
+use ProgrammatorDev\OpenWeatherMap\Resource\Util\UnitSystemTrait;
 use ProgrammatorDev\OpenWeatherMap\Resource\Util\ValidationTrait;
 use ProgrammatorDev\Validator\Exception\ValidationException;
 use Psr\Http\Client\ClientExceptionInterface;
 
 class WeatherResource extends Resource
 {
+    use LanguageTrait;
+    use UnitSystemTrait;
     use ValidationTrait;
 
     private const NUM_RESULTS = 40;

src/Resource/Util/ValidationTrait.php

@@ -12,7 +12,7 @@ class UnitSystem
     public const IMPERIAL = 'imperial';
     public const STANDARD = 'standard';
 
-    public static function getList(): array
+    public static function getOptions(): array
     {
         return (new UnitSystem)->getClassConstants(self::class);
     }