From ea82b989c806204edc78ac2e842ca988699699f7 Mon Sep 17 00:00:00 2001
From: stephann <3025661+stephannv@users.noreply.github.com>
Date: Fri, 13 Sep 2024 18:31:29 -0300
Subject: [PATCH] fix: Remove some utils methods (plain(&), comment(&),
 unsafe_raw(&) (#69)

---
 spec/blueprint/html/safety_spec.cr | 16 +++-----------
 spec/blueprint/html/utils_spec.cr  | 34 ++++++------------------------
 src/blueprint/html/utils.cr        | 18 +++-------------
 3 files changed, 13 insertions(+), 55 deletions(-)

diff --git a/spec/blueprint/html/safety_spec.cr b/spec/blueprint/html/safety_spec.cr
index 32f0372..1542772 100644
--- a/spec/blueprint/html/safety_spec.cr
+++ b/spec/blueprint/html/safety_spec.cr
@@ -11,8 +11,7 @@ private class Example
     plain "<script>alert('Plain Text')</script>"
     render(ExampleComponent.new) { "<script>alert('ExampleComponent')</script>" }
     div(class: "some-class\" onblur=\"alert('Attribute')")
-    comment { "--><script>alert('Plain Text')</script><!--" }
-    comment "--><script>alert('Another plain text')</script><!--"
+    comment "--><script>alert('Comment')</script><!--"
     v_btn "<script>alert('content')</script>"
     v_btn(class: "some-class\" onclick=\"alert('Attribute')") { "<script>alert('hello')</script>" }
   end
@@ -72,19 +71,10 @@ describe "safety" do
     page.to_s.should contain(expected_html)
   end
 
-  it "escapes comment content passed via block" do
+  it "escapes comment content" do
     page = Example.new
     expected_html = normalize_html <<-HTML
-      <!----&gt;&lt;script&gt;alert(&#39;Plain Text&#39;)&lt;/script&gt;&lt;!---->
-    HTML
-
-    page.to_s.should contain(expected_html)
-  end
-
-  it "escapes comment content passed via argument" do
-    page = Example.new
-    expected_html = normalize_html <<-HTML
-      <!----&gt;&lt;script&gt;alert(&#39;Another plain text&#39;)&lt;/script&gt;&lt;!---->
+      <!----&gt;&lt;script&gt;alert(&#39;Comment&#39;)&lt;/script&gt;&lt;!---->
     HTML
 
     page.to_s.should contain(expected_html)
diff --git a/spec/blueprint/html/utils_spec.cr b/spec/blueprint/html/utils_spec.cr
index 0bdb675..910b2b2 100644
--- a/spec/blueprint/html/utils_spec.cr
+++ b/spec/blueprint/html/utils_spec.cr
@@ -10,33 +10,25 @@ private class ExamplePage
       b "World"
     end
 
-    span { plain { "Plain!" } }
-
     i "Hi"
     whitespace
     plain "User"
 
-    comment { "This is an html comment" }
-    comment "This is another html comment"
+    comment "This is an html comment"
 
-    unsafe_raw "<script>Dangerous script</script>"
-    div { unsafe_raw { "<script>Another dangerous script</script>" } }
+    div do
+      unsafe_raw "<script>Dangerous script</script>"
+    end
   end
 end
 
 describe "utils" do
   describe "#plain" do
-    it "renders plain text passed via argument" do
+    it "renders plain text" do
       page = ExamplePage.new
 
       page.to_s.should contain("<div>Hello<b>World</b></div>")
     end
-
-    it "renders plain text passed via block" do
-      page = ExamplePage.new
-
-      page.to_s.should contain("<span>Plain!</span>")
-    end
   end
 
   describe "#doctype" do
@@ -48,17 +40,11 @@ describe "utils" do
   end
 
   describe "#comment" do
-    it "renders an html comment passed via block" do
+    it "renders an html comment" do
       page = ExamplePage.new
 
       page.to_s.should contain("<!--This is an html comment-->")
     end
-
-    it "renders an html comment passed via argument" do
-      page = ExamplePage.new
-
-      page.to_s.should contain("<!--This is another html comment-->")
-    end
   end
 
   describe "#whitespace" do
@@ -70,16 +56,10 @@ describe "utils" do
   end
 
   describe "#unsafe_raw" do
-    it "renders content passed via argument without escaping" do
+    it "renders content without escaping" do
       page = ExamplePage.new
 
       page.to_s.should contain("<script>Dangerous script</script>")
     end
-
-    it "renders content passed via block without escaping" do
-      page = ExamplePage.new
-
-      page.to_s.should contain("<div><script>Another dangerous script</script></div>")
-    end
   end
 end
diff --git a/src/blueprint/html/utils.cr b/src/blueprint/html/utils.cr
index 6f68ad8..ec23863 100644
--- a/src/blueprint/html/utils.cr
+++ b/src/blueprint/html/utils.cr
@@ -1,10 +1,6 @@
 module Blueprint::HTML::Utils
   private def plain(content : String) : Nil
-    plain { content }
-  end
-
-  private def plain(&) : Nil
-    ::HTML.escape(yield, @buffer)
+    ::HTML.escape(content, @buffer)
   end
 
   private def doctype : Nil
@@ -12,12 +8,8 @@ module Blueprint::HTML::Utils
   end
 
   private def comment(content : String) : Nil
-    comment { content }
-  end
-
-  private def comment(&) : Nil
     @buffer << "<!--"
-    ::HTML.escape(yield, @buffer)
+    ::HTML.escape(content, @buffer)
     @buffer << "-->"
   end
 
@@ -26,10 +18,6 @@ module Blueprint::HTML::Utils
   end
 
   def unsafe_raw(content : String) : Nil
-    unsafe_raw { content }
-  end
-
-  def unsafe_raw(&) : Nil
-    @buffer << yield
+    @buffer << content
   end
 end