Merge pull request #184 from lukeraymonddowning/2.x_parse

src/Functions.php

@@ -34,14 +34,24 @@ function style(string $name, ?Closure $callback = null): Style
 
 if (! function_exists('Termwind\render')) {
     /**
-     * Render HTML to a string.
+     * Render HTML to the terminal.
      */
     function render(string $html, int $options = OutputInterface::OUTPUT_NORMAL): void
     {
         (new HtmlRenderer)->render($html, $options);
     }
 }
 
+if (! function_exists('Termwind\parse')) {
+    /**
+     * Parse HTML to a string that can be rendered in the terminal.
+     */
+    function parse(string $html): string
+    {
+        return (new HtmlRenderer)->parse($html)->toString();
+    }
+}
+
 if (! function_exists('Termwind\terminal')) {
     /**
      * Returns a Terminal instance.

tests/Pest.php

@@ -13,16 +13,6 @@
         Styles::flush();
     })->in(__DIR__);
 
-/**
- * Parses the given html to string.
- */
-function parse(string $html): string
-{
-    $html = (new HtmlRenderer)->parse($html);
-
-    return $html->toString();
-}
-
 /**
  * Gets a input stream resource from a string.
  *

tests/a.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     $html = parse('<a>link text</a>');
 

tests/br.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     $html = parse('<br/>');
 

tests/classes.php

@@ -2,6 +2,7 @@
 
 use Termwind\Exceptions\ColorNotFound;
 use Termwind\Exceptions\InvalidStyle;
+use function Termwind\parse;
 
 test('font bold', function () {
     $html = parse('<div class="font-bold">text</div>');

tests/code.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     $html = parse(<<<'HTML'
         <div>

tests/colors.php

@@ -2,6 +2,7 @@
 
 use Termwind\Exceptions\InvalidColor;
 
+use function Termwind\parse;
 use function Termwind\style;
 
 it('allows the creation of colors', function () {

tests/div.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     $html = parse('<div>text</div>');
 

tests/dl.php

@@ -1,6 +1,7 @@
 <?php
 
 use Termwind\Exceptions\InvalidChild;
+use function Termwind\parse;
 
 it('accepts multiple elements', function () {
     $dl = parse(<<<'HTML'

tests/em.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     $html = parse('<em>text</em>');
 

tests/hr.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     putenv('COLUMNS=10');
 

tests/mediaQueries.php

@@ -1,6 +1,7 @@
 <?php
 
 use Termwind\Actions\StyleToMethod;
+use function Termwind\parse;
 
 it('supports styling', function ($name) {
     putenv('COLUMNS='.StyleToMethod::MEDIA_QUERY_BREAKPOINTS[$name]);

tests/ol.php

@@ -1,6 +1,7 @@
 <?php
 
 use Termwind\Exceptions\InvalidChild;
+use function Termwind\parse;
 
 it('renders the element', function () {
     $html = parse('<ol><li>list text 1</li></ol>');

tests/paragraph.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     $html = parse('<p>text</p>');
 

tests/pre.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     $content = '    <h1>Introduction</h1>
 

tests/render.php

@@ -4,6 +4,7 @@
 
 use function Termwind\render;
 use function Termwind\renderUsing;
+use function Termwind\parse;
 
 it('can render complex html', function () {
     $html = parse(<<<'HTML'

tests/s.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     $html = parse('<s>text</s>');
 

tests/span.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     $html = parse('<span>text</span>');
 

tests/strong.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     $html = parse('<strong>text</strong>');
 

tests/style.php

@@ -2,6 +2,7 @@
 
 use Termwind\Exceptions\StyleNotFound;
 
+use function Termwind\parse;
 use function Termwind\style;
 
 it('allows the creation of styles', function () {

tests/table.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('can render table without thead, tbody, tfoot to a string', function () {
     $html = parse(<<<'HTML'
 <table style="box">

tests/u.php

@@ -1,5 +1,7 @@
 <?php
 
+use function Termwind\parse;
+
 it('renders the element', function () {
     $html = parse('<u>text</u>');
 

tests/ul.php

@@ -1,6 +1,7 @@
 <?php
 
 use Termwind\Exceptions\InvalidChild;
+use function Termwind\parse;
 
 it('renders the element', function () {
     $html = parse('<ul><li>list text 1</li></ul>');