Merge pull request #170 from thecaliskan/main

Added has helper

README.md

@@ -88,6 +88,17 @@ use Spatie\Holidays\Holidays;
 Holidays::for('be')->getName('2024-01-01'); // Nieuwjaar
 ```
 
+### Determining whether a country is supported
+
+To verify whether a country is supported, you can use the `has` method.
+
+```php
+use Spatie\Holidays\Holidays;
+
+Holidays::has('be'); // true
+Holidays::has('unknown'); // false
+```
+
 ### Package limitations
 1. Islamic holidays are not supported (yet)
 

src/Holidays.php

@@ -28,6 +28,11 @@ public static function for(Country|string $country, ?int $year = null): static
         return new static($country, $year);
     }
 
+    public static function has(string $country): bool
+    {
+        return Country::find($country) instanceof Country;
+    }
+
     /** @return array<array{name: string, date: string}> */
     public function get(Country|string|null $country = null, ?int $year = null): array
     {

tests/HolidaysTest.php

@@ -83,3 +83,11 @@
     $result = Holidays::for('be')->getName(CarbonImmutable::parse('2024-01-02'));
     expect($result)->toBeNull();
 });
+
+it('can get the country is supported', function () {
+    $result = Holidays::has(country: 'be');
+    expect($result)->toBeTrue();
+
+    $result = Holidays::has(country: 'unknown');
+    expect($result)->toBeFalse();
+});