fun_html 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e5e644d2ee9775409d54d3340ee692e557614bb1e85ef0c290317c0d00e9432
-  data.tar.gz: 4792b3bf1361a392a59221c43a937ce1922108d09b6f799a6c5a74466c41e760
+  metadata.gz: 5bf8ac3683a1e55c9178d17d85703ec445c26f8a544db4a778252fa3128eb333
+  data.tar.gz: 8213e1aec0fff6f4357721ed1df892a3b31069ad2c93a53b0a64c2c40c4a87ad
 SHA512:
-  metadata.gz: 808d8bb9950923c28e12b81c39d7be030aa2cf315d73e4b28efe157398aeaaacc349983bb785e167e59c6cad284656f6e310fff215d8022e15eebf89c1f51b81
-  data.tar.gz: a75a3249ea3253801467b1324b6da56c090ca919ea74309a900f80635d7a01dadfeab966844e98a20305a4b3cd0f96621ac929157309df861fddc3e511c424d4
+  metadata.gz: f7373307fa00fad6e75bf8db7b0c490dd1b808d37b05c3406c5a862c39b8170befef1057b01e1c9577966ed11b1d1bf4ada88741ac5bd213314fb241de656fea
+  data.tar.gz: 13b9377037fd8be26000f9bf746d858645f4326423139beee6a7032f1c37e19fc7290baf10572be84aa3d7c2a303086dc18b5697ec215b8c11c7d0796085bfb9

data/lib/fun_html/attribute.rb

@@ -32,7 +32,9 @@ module FunHtml
 
     # only allow nil or objects that respond to `safe_attribute`
     def self.to_html(attr)
-      attr&.safe_attribute.to_s
+      return '' if attr.nil?
+
+      attr.safe_attribute
     end
 
     # create a new Attribute object to create reuseable attributes
@@ -60,6 +62,16 @@ module FunHtml
       write(' class="', value)
     end
 
+    # classes takes a hash of class names and boolean values
+    # only the names with a true value will be printed
+    # classes({'a' => true, 'b' => false, 'c' => true}) -> ' class="a c"'
+    def classes(list)
+      klass list.select { |_k, v| v == true }.keys.join(' ')
+    end
+
+    # alias so klass has classes
+    def klasses(list) = classes(list)
+
     # Merge another Attribute to create a new, combined, Attribute.
     def merge(other)
       self.class.new(@__buffer.merge(other.instance_variable_get(:@__buffer)))

data/lib/fun_html/template.rb

@@ -55,9 +55,26 @@ module FunHtml
       obj
     end
 
+    JOIN_ERROR = <<~TXT.freeze
+      You can not join templates which are created by the parent template.
+
+      This will fail:
+
+        FunHtml::Template.start { |t| t.join [t.text("hello")] }
+
+      Instead only join new templates
+        FunHtml::Template.start do |t|
+          t.join [FunHtml::Template.start { |x| x.text('hello') }]
+        end
+    TXT
+
     # join an array of other templates into this template.
     def join(templates)
-      templates.each { @__buffer << _1.render }
+      templates.each do |t|
+        raise JOIN_ERROR if t == self
+
+        @__buffer << t.render
+      end
       self
     end
 

data/lib/fun_html/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FunHtml
-  VERSION = '0.2.0'
+  VERSION = '0.3.1'
 end

data/lib/fun_html/writer.rb

@@ -10,15 +10,15 @@ module FunHtml
     include Kernel
 
     def initialize
-      @__buffer = +''
+      @__buffer = String.new(capacity: 1024)
     end
 
     # Render produces the HTML string and clears the buffer.
     def render
-      @__buffer
-    ensure
+      result = @__buffer
       # empty the buffer to prevent double rendering
-      @__buffer = +''
+      @__buffer = String.new(capacity: 1024)
+      result
     end
 
     private
@@ -33,9 +33,12 @@ module FunHtml
     CLOSE_VOID = '/>'
 
     def write(open, close, attr = nil, closing_char: CLOSE, &block)
-      @__buffer << open << Attribute.to_html(attr)
+      if attr
+        @__buffer << open << Attribute.to_html(attr) << closing_char
+      else
+        @__buffer << open << closing_char
+      end
 
-      @__buffer << closing_char
       yield self if block
       @__buffer << close
 

data/rbi/fun_html.rbi

@@ -3,6 +3,8 @@
 
 module FunHtml
   class Template
+    JOIN_ERROR = T.let(T.unsafe(nil), String)
+
     include FunHtml::Writer
     include FunHtml::SpecElements::HTMLAllElements
 
@@ -76,6 +78,12 @@ module FunHtml
     sig { params(attr: T.nilable(FunHtml::Attribute)).returns(String) }
     def self.to_html(attr); end
 
+    sig { params(list: T::Hash[String, T::Boolean]).returns(FunHtml::Attribute) }
+    def classes(list); end
+
+    sig { params(list: T::Hash[String, T::Boolean]).returns(FunHtml::Attribute) }
+    def klasses(list); end
+
     sig { params(other: FunHtml::Attribute).returns(FunHtml::Attribute) }
     def merge(other); end
 

data/rbi/fun_html.rbx

@@ -3,6 +3,8 @@
 
 module FunHtml
   class Template
+    JOIN_ERROR = T.let(T.unsafe(nil), String)
+
     include FunHtml::Writer
     include FunHtml::SpecElements::HTMLAllElements
 
@@ -76,6 +78,12 @@ module FunHtml
     sig { params(attr: T.nilable(FunHtml::Attribute)).returns(String) }
     def self.to_html(attr); end
 
+    sig { params(list: T::Hash[String, T::Boolean]).returns(FunHtml::Attribute) }
+    def classes(list); end
+
+    sig { params(list: T::Hash[String, T::Boolean]).returns(FunHtml::Attribute) }
+    def klasses(list); end
+
     sig { params(other: FunHtml::Attribute).returns(FunHtml::Attribute) }
     def merge(other); end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fun_html
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - John Weir
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-14 00:00:00.000000000 Z
+date: 2025-04-22 00:00:00.000000000 Z
 dependencies: []
 description: It probably is not much fun, despite the name.
 email: