feat/add-required-to-isUrl (#16)

* Add required to `isUrl` in `DataModelHelper.php`.

* Add tests.

---------

Co-authored-by: david_smith <[email protected]>

src/DataModelHelper.php

@@ -4,6 +4,7 @@
 
 use ReflectionAttribute;
 use ReflectionProperty;
+use Zerotoprod\DataModel\PropertyRequiredException;
 use Zerotoprod\ValidateUrl\ValidateUrl;
 
 /**
@@ -127,11 +128,15 @@ public static function pregReplace(mixed $value, array $context, ?ReflectionAttr
      */
     public static function isUrl(mixed $value, array $context, ?ReflectionAttribute $Attribute, ReflectionProperty $Property): ?string
     {
+        $args = $Attribute?->getArguments()[0];
         if (!$value && $Property->getType()?->allowsNull()) {
             return null;
         }
 
-        $args = $Attribute?->getArguments()[0];
+        if (!$value || in_array('required', $args, true)) {
+            throw new PropertyRequiredException("Property `\${$Property->getName()}` is required");
+        }
+
         if (!is_string($value)) {
             if (isset($args['on_fail'])) {
                 call_user_func($args['on_fail'], $value, $context, $Attribute, $Property);

tests/Unit/IsUrl/Required/RequiredTest.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Tests\Unit\IsUrl\Required;
+
+use PHPUnit\Framework\Attributes\Test;
+use Tests\TestCase;
+use Zerotoprod\DataModel\PropertyRequiredException;
+
+class RequiredTest extends TestCase
+{
+    #[Test] public function required(): void
+    {
+        $this->expectException(PropertyRequiredException::class);
+        User::from();
+    }
+
+    #[Test] public function required_alt(): void
+    {
+        $this->expectException(PropertyRequiredException::class);
+        User::from([
+            User::url => 'https://example.com'
+        ]);
+    }
+}

tests/Unit/IsUrl/Required/User.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Tests\Unit\IsUrl\Required;
+
+use Zerotoprod\DataModel\DataModel;
+use Zerotoprod\DataModel\Describe;
+use Zerotoprod\DataModelHelper\DataModelHelper;
+
+class User
+{
+    use DataModel;
+    use DataModelHelper;
+
+    public const url = 'url';
+
+    #[Describe([
+        'cast' => [self::class, 'isUrl'],
+        'required'
+    ])]
+    public string $url;
+
+    #[Describe([
+        'cast' => [self::class, 'isUrl'],
+        'required'
+    ])]
+    public string $social_url;
+}