add LanguageAssertions

normalize CountryAssertions method naming

Author: Gummibeer

README.md

@@ -27,10 +27,10 @@ This will prevent any method name conflicts with core, your custom or other trai
 `composer require --dev league/iso3166:^3.0`
 
 ```php
-\Astrotomic\PhpunitAssertions\CountryAssertions::assertCountryName('Germany');
-\Astrotomic\PhpunitAssertions\CountryAssertions::assertCountryAlpha2('DE');
-\Astrotomic\PhpunitAssertions\CountryAssertions::assertCountryAlpha3('DEU');
-\Astrotomic\PhpunitAssertions\CountryAssertions::assertCountryNumeric('276');
+\Astrotomic\PhpunitAssertions\CountryAssertions::assertName('Germany');
+\Astrotomic\PhpunitAssertions\CountryAssertions::assertAlpha2('DE');
+\Astrotomic\PhpunitAssertions\CountryAssertions::assertAlpha3('DEU');
+\Astrotomic\PhpunitAssertions\CountryAssertions::assertNumeric('276');
 ```
 
 ### Email
@@ -64,6 +64,15 @@ This will prevent any method name conflicts with core, your custom or other trai
 \Astrotomic\PhpunitAssertions\HashidAssertions::assertHashId('yr8', 'this is my salt');
 ```
 
+### Language
+
+`composer require --dev astrotomic/iso639:^1.0`
+
+```php
+\Astrotomic\PhpunitAssertions\LanguageAssertions::assertName('German');
+\Astrotomic\PhpunitAssertions\LanguageAssertions::assertAlpha2('de');
+```
+
 ### Nullable Type
 
 ```php

composer.json

@@ -20,6 +20,7 @@
         "phpunit/phpunit": "^9.1"
     },
     "require-dev": {
+        "astrotomic/iso639": "^1.0",
         "egulias/email-validator": "^2.1 || ^3.0",
         "gajus/dindent": "^2.0",
         "giggsey/libphonenumber-for-php": "^8.12",
@@ -30,6 +31,7 @@
         "vinkla/hashids": "^9.0"
     },
     "suggest": {
+        "astrotomic/iso639": "\\Astrotomic\\PhpunitAssertions\\LanguageAssertions (^1.0)",
         "egulias/email-validator": "\\Astrotomic\\PhpunitAssertions\\EmailAssertions (^2.1 || ^3.0)",
         "gajus/dindent": "\\Astrotomic\\PhpunitAssertions\\Laravel\\BladeAssertions (^2.0)",
         "giggsey/libphonenumber-for-php": "\\Astrotomic\\PhpunitAssertions\\PhoneNumberAssertions (^8.12)",

src/CountryAssertions.php

@@ -7,33 +7,33 @@
 
 trait CountryAssertions
 {
-    public static function assertCountryName($actual): void
+    public static function assertName($actual): void
     {
         PHPUnit::assertIsString($actual);
         $country = (new ISO3166)->name($actual);
         PHPUnit::assertIsArray($country);
     }
 
-    public static function assertCountryAlpha2($actual): void
+    public static function assertAlpha2($actual): void
     {
         PHPUnit::assertIsString($actual);
-        PHPUnit::assertSame(2, strlen($actual));
+        StringLengthAssertions::assertSame(2, $actual);
         $country = (new ISO3166)->alpha2($actual);
         PHPUnit::assertIsArray($country);
     }
 
-    public static function assertCountryAlpha3($actual): void
+    public static function assertAlpha3($actual): void
     {
         PHPUnit::assertIsString($actual);
-        PHPUnit::assertSame(3, strlen($actual));
+        StringLengthAssertions::assertSame(3, $actual);
         $country = (new ISO3166)->alpha3($actual);
         PHPUnit::assertIsArray($country);
     }
 
-    public static function assertCountryNumeric($actual): void
+    public static function assertNumeric($actual): void
     {
         PHPUnit::assertIsString($actual);
-        PHPUnit::assertSame(3, strlen($actual));
+        StringLengthAssertions::assertSame(3, $actual);
         $country = (new ISO3166)->numeric($actual);
         PHPUnit::assertIsArray($country);
     }

src/LanguageAssertions.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Astrotomic\PhpunitAssertions;
+
+use Astrotomic\ISO639\ISO639;
+use PHPUnit\Framework\Assert as PHPUnit;
+
+trait LanguageAssertions
+{
+    public static function assertName($actual): void
+    {
+        PHPUnit::assertIsString($actual);
+        $language = (new ISO639())->name($actual);
+        PHPUnit::assertIsArray($language);
+    }
+
+    public static function assertAlpha2($actual): void
+    {
+        PHPUnit::assertIsString($actual);
+        StringLengthAssertions::assertSame(2, $actual);
+        $language = (new ISO639)->alpha2($actual);
+        PHPUnit::assertIsArray($language);
+    }
+}

tests/CountryAssertionsTest.php

@@ -13,7 +13,7 @@ final class CountryAssertionsTest extends TestCase
      */
     public static function it_can_validate_country_by_name(string $actual): void
     {
-        CountryAssertions::assertCountryName($actual);
+        CountryAssertions::assertName($actual);
     }
 
     /**
@@ -22,7 +22,7 @@ public static function it_can_validate_country_by_name(string $actual): void
      */
     public static function it_can_validate_country_by_alpha2(string $actual): void
     {
-        CountryAssertions::assertCountryAlpha2($actual);
+        CountryAssertions::assertAlpha2($actual);
     }
 
     /**
@@ -31,7 +31,7 @@ public static function it_can_validate_country_by_alpha2(string $actual): void
      */
     public static function it_can_validate_country_by_alpha3(string $actual): void
     {
-        CountryAssertions::assertCountryAlpha3($actual);
+        CountryAssertions::assertAlpha3($actual);
     }
 
     /**
@@ -40,7 +40,7 @@ public static function it_can_validate_country_by_alpha3(string $actual): void
      */
     public static function it_can_validate_country_by_numeric(string $actual): void
     {
-        CountryAssertions::assertCountryNumeric($actual);
+        CountryAssertions::assertNumeric($actual);
     }
 
     public function countryName(): iterable

tests/LanguageAssertionsTest.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace Astrotomic\PhpunitAssertions\Tests;
+
+use Astrotomic\ISO639\ISO639;
+use Astrotomic\PhpunitAssertions\LanguageAssertions;
+
+final class LanguageAssertionsTest extends TestCase
+{
+    /**
+     * @test
+     * @dataProvider languageName
+     */
+    public static function it_can_validate_language_by_name(string $actual): void
+    {
+        LanguageAssertions::assertName($actual);
+    }
+
+    /**
+     * @test
+     * @dataProvider languageAlpha2
+     */
+    public static function it_can_validate_language_by_alpha2(string $actual): void
+    {
+        LanguageAssertions::assertAlpha2($actual);
+    }
+
+    public function languageName(): iterable
+    {
+        return array_map(fn (array $country): array => [$country[ISO639::KEY_NAME]], (new ISO639())->all());
+    }
+
+    public function languageAlpha2(): iterable
+    {
+        return array_map(fn (array $country): array => [$country[ISO639::KEY_639_1]], (new ISO639())->all());
+    }
+}