Adding upstream version 0.13.1.upstream/0.13.1

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 114 insertions, 0 deletions

diff --git a/vendor/ipl/html/src/Error.php b/vendor/ipl/html/src/Error.php
new file mode 100644
index 0000000..316d237
--- /dev/null
+++ b/vendor/ipl/html/src/Error.php
@@ -0,0 +1,114 @@
+<?php
+
+namespace ipl\Html;
+
+use Exception;
+use Throwable;
+
+use function ipl\Stdlib\get_php_type;
+
+/**
+ * Class Error
+ *
+ * TODO: Eventually allow to (statically) inject a custom error renderer.
+ *
+ * @package ipl\Html
+ */
+abstract class Error
+{
+    /** @var bool */
+    protected static $showTraces = true;
+
+    /**
+     *
+     * @param Exception|Throwable|string $error
+     * @return HtmlDocument
+     */
+    public static function show($error)
+    {
+        if ($error instanceof Throwable) {
+            // PHP 7+
+            $msg = static::createMessageForException($error);
+        } elseif (is_string($error)) {
+            $msg = $error;
+        } else {
+            // TODO: translate?
+            $msg = 'Got an invalid error';
+        }
+
+        $result = static::renderErrorMessage($msg);
+        if (static::showTraces() && $error instanceof Throwable) {
+            $result->addHtml(Html::tag('pre', $error->getTraceAsString()));
+        }
+
+        return $result;
+    }
+
+    /**
+     *
+     * @param Exception|Throwable|string $error
+     * @return string
+     */
+    public static function render($error)
+    {
+        return static::show($error)->render();
+    }
+
+    /**
+     * @param bool|null $show
+     * @return bool
+     */
+    public static function showTraces($show = null)
+    {
+        if ($show !== null) {
+            self::$showTraces = (bool) $show;
+        }
+
+        return self::$showTraces;
+    }
+
+    /**
+     * @deprecated Use {@link get_php_type()} instead
+     */
+    public static function getPhpTypeName($any)
+    {
+        return get_php_type($any);
+    }
+
+    /**
+     * @param Exception|Throwable $exception
+     * @return string
+     */
+    protected static function createMessageForException($exception)
+    {
+        $file = preg_split('/[\/\\\]/', $exception->getFile(), -1, PREG_SPLIT_NO_EMPTY) ?: [];
+        $file = array_pop($file);
+        return sprintf(
+            '%s (%s:%d)',
+            $exception->getMessage(),
+            $file,
+            $exception->getLine()
+        );
+    }
+
+    /**
+     * @param string
+     * @return HtmlDocument
+     */
+    protected static function renderErrorMessage($message)
+    {
+        $output = new HtmlDocument();
+        $output->addHtml(
+            Html::tag('div', ['class' => 'exception'], [
+                Html::tag('h1', [
+                    Html::tag('i', ['class' => 'icon-bug']),
+                    // TODO: Translate? More hints?
+                    'Oops, an error occurred!'
+                ]),
+                Html::tag('pre', $message)
+            ])
+        );
+
+        return $output;
+    }
+}