Add helper Template::class. (#2)

terabytesoftw · web-flow · commit 30bd3a9970f1 · 2024-03-05T11:56:28.000-03:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,4 +4,5 @@
 
 ## 0.1.0 March 5, 2024
 
+- Enh #2: Add helper `Template::class` (@terabytesoftw)
 - Initial release
diff --git a/README.md b/README.md
@@ -265,6 +265,34 @@ $attributes = Attributes::render(
 );
 ```
 
+### Render Template
+
+The `Template::class` helper can be used to render a template.
+
+The method accepts two parameters:
+
+- `template:` (string): The template to render.
+- `tokenValues:` (array): The token values to replace in the template.
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use PHPForge\Html\Helper\Template;
+
+$template = '{{prefix}}\n{{tag}}\n{{suffix}}';
+$tokenValues = [
+    '{{prefix}}' => 'prefix',
+    '{{tag}}' => '<div>content</div>',
+    '{{suffix}}' => 'suffix',
+];
+
+$content = Template::render($template, $tokenValues);
+```
+
+> `\n` is a new line character, and it is used to separate the tokens in the template.
+
 ### Validate value in list
 
 The `Validator::class` helper can be used to validate a value in a list.
diff --git a/src/Template.php b/src/Template.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace UIAwesome\Html\Helper;
+
+use function count;
+use function explode;
+use function strtr;
+
+/**
+ * This class provides static methods for render template.
+ */
+final class Template
+{
+    public static function render(string $template, array $tokenValues): string
+    {
+        $result = '';
+        $tokens = explode('\n', $template);
+
+        foreach ($tokens as $key => $token) {
+            $tokenValue = strtr($token, $tokenValues);
+
+            if ($tokenValue !== '') {
+                $result .= $tokenValue;
+            }
+
+            if ($result !== '' && $key < count($tokens) - 1) {
+                $result = strtr($tokens[$key + 1], $tokenValues) !== '' ? $result . PHP_EOL : $result;
+            }
+        }
+
+        return $result;
+    }
+}
diff --git a/tests/TemplateTest.php b/tests/TemplateTest.php
@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace UIAwesome\Html\Tests\Helper;
+
+use PHPForge\Support\Assert;
+use UIAwesome\Html\Helper\Template;
+
+final class TemplateTest extends \PHPUnit\Framework\TestCase
+{
+    public function testRender(): void
+    {
+        $template = '{{prefix}}\n{{tag}}\n{{suffix}}';
+        $tokenValues = [
+            '{{prefix}}' => 'prefix',
+            '{{tag}}' => '<div>content</div>',
+            '{{suffix}}' => '',
+        ];
+
+        Assert::equalsWithoutLE(
+            <<<HTML
+            prefix
+            <div>content</div>
+            HTML,
+            Template::render($template, $tokenValues)
+        );
+    }
+
+    public function testRenderWithEmptyValuesTokens(): void
+    {
+        $template = '{{prefix}}\n{{tag}}\n{{suffix}}';
+        $tokenValues = [
+            '{{prefix}}' => '',
+            '{{label}}' => '',
+            '{{tag}}' => '<div>content</div>',
+            '{{suffix}}' => 'suffix',
+        ];
+
+        Assert::equalsWithoutLE(
+            <<<HTML
+            <div>content</div>
+            suffix
+            HTML,
+            Template::render($template, $tokenValues)
+        );
+    }
+}

Original file line number	Diff line number	Diff line change
`@@ -4,4 +4,5 @@`
`4`	`4`
`5`	`5`	`## 0.1.0 March 5, 2024`
`6`	`6`
	`7`	+- Enh #2: Add helper `Template::class` (@terabytesoftw)
`7`	`8`	`- Initial release`