Merge pull request #3 from chadicus/master

Add Arrays::arrayize

Author: chadicus

.travis.yml

@@ -15,4 +15,4 @@ before_script:
   - composer update $PREFER_LOWEST
 script:
   - ./vendor/bin/phpunit
-after_success: ./vendor/bin/coveralls -v
+after_success: ./vendor/bin/php-coveralls -v

composer.json

@@ -22,6 +22,6 @@
     "require-dev": {
         "squizlabs/php_codesniffer": "^3.2",
         "phpunit/phpunit": "^6.5",
-        "php-coveralls/php-coveralls": "^1.0"
+        "php-coveralls/php-coveralls": "^2.1"
     }
 }

src/Arrays.php

@@ -86,4 +86,24 @@ function ($item) use (&$result) {
 
         return $result;
     }
+
+    /**
+     * Converts any non-array value to a single element array.
+     *
+     * @param mixed $value The value to convert.
+     *
+     * @return array The coverted array or the original value.
+     */
+    public static function arrayize($value) : array
+    {
+        if ($value === null) {
+            return [];
+        }
+
+        if (!is_array($value)) {
+            return [$value];
+        }
+
+        return $value;
+    }
 }

tests/ArraysTest.php

@@ -119,4 +119,32 @@ public function flatten()
     {
         $this->assertSame([1, 2, 3, 4, 5], Arrays::flatten([[1, 2], [[3, [4, 5]]]]));
     }
+
+    /**
+     * @test
+     * @covers ::arrayize
+     */
+    public function arrayizeReturnsInputIfItIsAnArray()
+    {
+        $this->assertSame([1, 2, 3, 4, 5], Arrays::arrayize([1, 2, 3, 4, 5]));
+    }
+
+    /**
+     * @test
+     * @covers ::arrayize
+     */
+    public function arrayizeWrapsNonArrayValue()
+    {
+        $value = new \StdClass();
+        $this->assertSame([$value], Arrays::arrayize($value));
+    }
+
+    /**
+     * @test
+     * @covers ::arrayize
+     */
+    public function arrayizeConvertsNullToEmptyArray()
+    {
+        $this->assertSame([], Arrays::arrayize(null));
+    }
 }