add unionnull

Author: rodber

README.md

@@ -120,18 +120,19 @@ $param->schema();
 
 ### Core types
 
-| Type                  | Helper     | Attribute   | Description                               |
-| --------------------- | ---------- | ----------- | ----------------------------------------- |
-| [String](#string)     | `string`   | `_string`   | String, optionally matching a regex       |
-| [Int](#int)           | `int`      | `_int`      | Integer with optional range/accept/reject |
-| [Float](#float)       | `float`    | `_float`    | Float with optional range/accept/reject   |
-| [Bool](#bool)         | `bool`     | `_bool`     | Boolean                                   |
-| [Null](#null)         | `null`     | `_null`     | Null                                      |
-| [Object](#object)     | `object`   | —           | Object of a given class                   |
-| [Mixed](#mixed)       | `mixed`    | `_mixed`    | Any type                                  |
-| [Array](#array)       | `arrayp`   | `_arrayp`   | Array with named parameters               |
-| [Iterable](#iterable) | `iterable` | `_iterable` | Iterable with generic key/value           |
-| [Union](#union)       | `union`    | `_union`    | Value matching at least one parameter     |
+| Type                     | Helper      | Attribute    | Description                                   |
+| ------------------------ | ----------- | ------------ | --------------------------------------------- |
+| [String](#string)        | `string`    | `_string`    | String, optionally matching a regex           |
+| [Int](#int)              | `int`       | `_int`       | Integer with optional range/accept/reject     |
+| [Float](#float)          | `float`     | `_float`     | Float with optional range/accept/reject       |
+| [Bool](#bool)            | `bool`      | `_bool`      | Boolean                                       |
+| [Null](#null)            | `null`      | `_null`      | Null                                          |
+| [Object](#object)        | `object`    | —            | Object of a given class                       |
+| [Mixed](#mixed)          | `mixed`     | `_mixed`     | Any type                                      |
+| [Array](#array)          | `arrayp`    | `_arrayp`    | Array with named parameters                   |
+| [Iterable](#iterable)    | `iterable`  | `_iterable`  | Iterable with generic key/value               |
+| [Union](#union)          | `union`     | `_union`     | Value matching at least one parameter         |
+| [UnionNull](#union-null) | `unionNull` | `_unionNull` | Value matching at least one parameter or null |
 
 ### Derived types
 
@@ -522,6 +523,8 @@ $union('100'); // '100'
 $union(100);   // 100
 ```
 
+## UnionNull
+
 You can also use `unionNull()` as a shorthand for nullable unions:
 
 ```php
@@ -536,13 +539,11 @@ $maybeInt(null); // null
 Attribute notation:
 
 ```php
-use Chevere\Parameter\Attributes\_union;
-use Chevere\Parameter\Attributes\_float;
+use Chevere\Parameter\Attributes\_null;
 use Chevere\Parameter\Attributes\_int;
 
-#[_union(
-    new _int(),
-    new _float()
+#[_unionNull(
+    new _int()
 )]
 ```
 

src/Attributes/_unionNull.php

@@ -0,0 +1,47 @@
+<?php
+
+/*
+ * This file is part of Chevere.
+ *
+ * (c) Rodolfo Berrios <rodolfo@chevere.org>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Chevere\Parameter\Attributes;
+
+use Attribute;
+use Chevere\Parameter\Interfaces\ParameterAttributeInterface;
+use Chevere\Parameter\Interfaces\UnionParameterInterface;
+use Chevere\Parameter\Parameters;
+use Chevere\Parameter\Traits\AttrTrait;
+use Chevere\Parameter\UnionParameter;
+
+#[Attribute(Attribute::TARGET_PROPERTY | Attribute::TARGET_PARAMETER | Attribute::TARGET_CLASS_CONSTANT)]
+class _unionNull implements ParameterAttributeInterface
+{
+    use AttrTrait;
+
+    private UnionParameterInterface $parameter;
+
+    public function __construct(
+        ParameterAttributeInterface ...$parameterAttribute,
+    ) {
+        $parameters = new Parameters();
+        array_unshift($parameterAttribute, new _null());
+        foreach ($parameterAttribute as $name => $attribute) {
+            $name = (string) $name;
+            $parameters = $parameters
+                ->withRequired($name, $attribute->parameter());
+        }
+        $this->parameter = new UnionParameter($parameters);
+    }
+
+    public function __invoke(mixed $mixed): mixed
+    {
+        return $this->parameter->__invoke($mixed);
+    }
+}

tests/Attributes/_unionNullTest.php

@@ -0,0 +1,36 @@
+<?php
+
+/*
+ * This file is part of Chevere.
+ *
+ * (c) Rodolfo Berrios <rodolfo@chevere.org>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Chevere\Tests\Attributes;
+
+use Chevere\Parameter\Attributes\_int;
+use Chevere\Parameter\Attributes\_unionNull;
+use PHPUnit\Framework\TestCase;
+use function Chevere\Parameter\int;
+use function Chevere\Parameter\unionNull;
+
+final class _unionNullTest extends TestCase
+{
+    public function testConstruct(): void
+    {
+        $parameter = unionNull(
+            int(),
+        );
+        $attr = new _unionNull(
+            new _int(),
+        );
+        $this->assertEquals($parameter, $attr->parameter());
+        $attr->__invoke(null);
+        $attr->__invoke(1);
+    }
+}