Create stringify() function

Author: henriquemoody

composer.json

@@ -22,7 +22,10 @@
     "autoload": {
         "psr-4": {
             "Respect\\Stringifier\\": "src/"
-        }
+        },
+        "files": [
+            "src/stringify.php"
+        ]
     },
     "scripts": {
         "docheader": "vendor/bin/docheader check src/ tests/",

src/stringify.php

@@ -0,0 +1,27 @@
+<?php
+
+/*
+ * This file is part of Respect/Stringifier.
+ *
+ * (c) Henrique Moody <[email protected]>
+ *
+ * For the full copyright and license information, please view the "LICENSE.md"
+ * file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Respect\Stringifier;
+
+use Respect\Stringifier\Stringifiers\ClusterStringifier;
+
+function stringify($value): string
+{
+    static $stringifier;
+
+    if (null === $stringifier) {
+        $stringifier = ClusterStringifier::createDefault();
+    }
+
+    return $stringifier->stringify($value, 0) ?? '#ERROR#';
+}

tests/integration/stringify-array.phpt

@@ -0,0 +1,25 @@
+--FILE--
+<?php
+require 'vendor/autoload.php';
+
+use function Respect\Stringifier\stringify;
+
+echo stringify([
+    1,
+    null,
+    [
+        1.000,
+        [
+            tmpfile(),
+            [
+                1
+            ]
+        ]
+    ],
+    false,
+    new stdClass(),
+    42
+]);
+?>
+--EXPECT--
+{ 1, NULL, { 1.0, { [resource] (stream), ... } }, FALSE, [object] (stdClass: { }),  ...  }

tests/integration/stringify-bool.phpt

@@ -0,0 +1,17 @@
+--FILE--
+<?php
+require 'vendor/autoload.php';
+
+use function Respect\Stringifier\stringify;
+
+echo implode(
+    PHP_EOL,
+    [
+        stringify(true),
+        stringify(false),
+    ]
+);
+?>
+--EXPECT--
+`TRUE`
+`FALSE`

tests/integration/stringify-float.phpt

@@ -0,0 +1,23 @@
+--FILE--
+<?php
+require 'vendor/autoload.php';
+
+use function Respect\Stringifier\stringify;
+
+echo implode(
+    PHP_EOL,
+    [
+        stringify(1.0),
+        stringify(.3),
+        stringify(INF),
+        stringify(-1*INF),
+        stringify(acos(8)),
+    ]
+);
+?>
+--EXPECT--
+1.0
+0.3
+`INF`
+`-INF`
+`NaN`

tests/integration/stringify-int.phpt

@@ -0,0 +1,10 @@
+--FILE--
+<?php
+require 'vendor/autoload.php';
+
+use function Respect\Stringifier\stringify;
+
+echo stringify(1);
+?>
+--EXPECT--
+1

tests/integration/stringify-null.phpt

@@ -0,0 +1,10 @@
+--FILE--
+<?php
+require 'vendor/autoload.php';
+
+use function Respect\Stringifier\stringify;
+
+echo stringify(NULL);
+?>
+--EXPECT--
+`NULL`

tests/integration/stringify-object-dateTime.phpt

@@ -0,0 +1,12 @@
+--FILE--
+<?php
+require 'vendor/autoload.php';
+
+use function Respect\Stringifier\stringify;
+
+$dateTime = DateTime::createFromFormat('Y-m-d\TH:i:sP', '2017-12-31T23:59:59+00:00');
+
+echo stringify($dateTime);
+?>
+--EXPECT--
+"2017-12-31T23:59:59+00:00"

tests/integration/stringify-object-jsonSerializable.phpt

@@ -0,0 +1,18 @@
+--FILE--
+<?php
+require 'vendor/autoload.php';
+
+use function Respect\Stringifier\stringify;
+
+final class MyObject implements JsonSerializable
+{
+    public function jsonSerialize(): array
+    {
+        return [1, 2, 3];
+    }
+}
+
+echo stringify(new MyObject());
+?>
+--EXPECT--
+`[json-serializable] (MyObject: { 1, 2, 3 })`

tests/integration/stringify-object-stringable.phpt

@@ -0,0 +1,18 @@
+--FILE--
+<?php
+require 'vendor/autoload.php';
+
+use function Respect\Stringifier\stringify;
+
+final class MyObject
+{
+    public function __toString(): string
+    {
+        return __METHOD__;
+    }
+}
+
+echo stringify(new MyObject());
+?>
+--EXPECT--
+"MyObject::__toString"