Add alias for Arrays::arrayize

Author: chadicus

README.md

@@ -156,6 +156,13 @@ The following does a strict check for `$value` against the 3 accepted values.
 \TraderInteractive\Filter\Arrays::in($value, ['a', 'b', 'c']);
 ```
 
+#### Arrays::arrayize
+Aliased in the filterer as `arrayize`, this filter returns this original input if it is an array, otherwise returns input wrapped in an array. If the original input is null, an empty array is returned.
+```php
+$value = \TraderInteractive\Filter\Arrays::arrayize('a string value');
+assert($value === ['a string value']);
+```
+
 #### Arrays::filter
 Aliased in the filterer as `array`, this filter verifies that the argument is an array and checks the length of the array against bounds.  The
 default bounds are 1+, so an empty array fails by default.

src/Filterer.php

@@ -16,6 +16,7 @@ final class Filterer
      */
     const DEFAULT_FILTER_ALIASES = [
         'array' => '\\TraderInteractive\\Filter\\Arrays::filter',
+        'arrayize' => '\\TraderInteractive\\Filter\\Arrays::arrayize',
         'bool' => '\\TraderInteractive\\Filter\\Booleans::filter',
         'bool-convert' => '\\TraderInteractive\\Filter\\Booleans::convert',
         'date' => '\\TraderInteractive\\Filter\\DateTime::filter',

tests/FiltererTest.php

@@ -647,4 +647,16 @@ public function ofArrayUnknown()
             $this->assertSame($expected, $e->getMessage());
         }
     }
+
+    /**
+     * @tests
+     * @covers ::filter
+     */
+    public function arrayizeAliasIsCalledProperly()
+    {
+        $this->assertSame(
+            [true, ['field' => ['a string value']], null, []],
+            Filterer::filter(['field' => [['arrayize']]], ['field' => 'a string value'])
+        );
+    }
 }