[UTIL] Wrote HTML library to convert arrays to html

src/Util/HTML.php

@@ -0,0 +1,91 @@
+<?php
+// {{{ License
+// This file is part of GNU social - https://www.gnu.org/software/soci
+//
+// GNU social is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as publ
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// GNU social is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public Li
+// along with GNU social.  If not, see <http://www.gnu.org/licenses/>.
+// }}}
+
+namespace App\Util;
+
+use Functional as F;
+
+/**
+ * HTML Abstraction
+ *
+ * @author    Hugo Sales <hugo@fc.up.pt>
+ * @copyright 2020 Free Software Foundation, Inc http://www.fsf.org
+ * @license   https://www.gnu.org/licenses/agpl.html GNU AGPL v3 or later
+ */
+abstract class HTML
+{
+    /**
+     * Creates an HTML tag without attributes
+     *
+     * @param array|string $content
+     */
+    private static function tag(string $tag, $content = '', bool $empty_tag = false): array
+    {
+        return self::attr_tag($tag, '', $content);
+    }
+
+    /**
+     * Create tag, possibly with attributes and indentation
+     *
+     * @param array|string $attrs   - element attributes
+     * @param array|string $content - what goes inside the tag
+     */
+    private static function attr_tag(string $tag, $attrs, $content = '', bool $empty_tag = false): array
+    {
+        $html = '<' . $tag . (is_string($attrs) ? ($attrs ? ' ' : '') . $attrs : self::attr($attrs));
+        if (empty($content) || $empty_tag) {
+            $html .= '>';
+        } else {
+            $html .= ">\n" . Common::indent($content) . "\n" . Common::indent("</{$tag}>");
+        }
+        return explode("\n", $html);
+    }
+
+    /**
+     * Attribute with given optional value
+     *
+     * @param array $attr
+     */
+    private static function attr(array $attrs): string
+    {
+        return ' ' . implode(' ', F\map($attrs, function ($val, $key, $_) { return "{$key} = '{$val}'"; }));
+    }
+
+    public static function html($html): string
+    {
+        if (is_string($html)) {
+            return $html;
+        } elseif (is_array($html)) {
+            $out = '';
+            foreach ($html as $tag => $contents) {
+                if (isset($contents['empty'])) {
+                    $out .= "<{$tag}>";
+                } else {
+                    $attrs  = isset($contents['attrs']) ? self::attr(array_shift($contents)) : '';
+                    $is_tag = preg_match('/[A-Za-z][A-Za-z0-9]*/', $tag);
+                    $inner  = self::html($contents);
+                    $inner  = $is_tag ? Common::indent($inner) : $inner;
+                    $out .= $is_tag ? "<{$tag}{$attrs}>\n{$inner}\n</{$tag}>\n" : $inner;
+                }
+            }
+            return $out;
+        } else {
+            return '';
+        }
+    }
+}