html-native 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4688be25684c101d4edf8c6ee05d061525a08c5fd4e9671b0ebf8f7d286ac11c
-  data.tar.gz: cf500e5cd56ec00233eac3719f647432a75ea8aab6e955fcf6e9140e13cede51
+  metadata.gz: 176be6b557435093c4163f66b0322073f986282895571dfd34fedceeb2b02ec8
+  data.tar.gz: 836e4f3e0a94e1ea70da575b900f10fed0e4da232c87e0ac83f0eaa45b3612da
 SHA512:
-  metadata.gz: 9a786002324a79d8d1f5a5f62662364a74caac0557be563c06fd2c95610df4b84827c83fdb20a68ffdbd75637ca8da1535f81f2c488d075b5a34b7fc77afd31d
-  data.tar.gz: 5aa97fd17361de4c685833fbbcbacdfe2f6769abec058a7729e22287eb3185b703a38ba8b291b69fbe02f74f9f43227380c6963610ce73efa02242c2c51fecf9
+  metadata.gz: 4346fd63e18a2187312c94b5d311467b1489c084ff23a80591aa726afe40a5ca5fb24aa160cb36f591eefb941fb8725b51c8a4d146d7b0ba82649edfdc475ba3
+  data.tar.gz: 761266f6ea9dd4340dfd8287e94e21721b6411cbcf3f4a37ac6fade2a12bbb1c00af9bde691ada4292255157039ddb26118738644cb71f9ce51c1a3b85d20b47

data/lib/html-native/builder.rb

@@ -1,14 +1,29 @@
 require "html-native"
 module HTMLComponent
+  # Represents a String being constructed, and can be more or less treated 
+  # as a String. Builder creates a String from whatever is put into it, but 
+  # it delays construction until it's absolutely necessary, then it caches the
+  # result.
   class Builder
+    # Build a new string builder instance, immediately constructing and caching 
+    # the initial value.
     def initialize(strings = [])
-      if strings.kind_of? String 
-        @strings = [strings]
+      @strings = []
+      @cache = case strings.class 
+      when Array
+        strings.join
+      when Enumerable
+        strings.to_a.join
       else
-        @strings = strings.dup
+        strings.to_s
       end
+      @cached = true
     end
 
+    # Appends a value to the Builder instance. If it is another builder, it is 
+    # added, but not converted to a String yet. If it is an HTMLComponent, it is 
+    # rendered. If it is anything else, it is converted to a String. This 
+    # invalidates the cache.
     def +(string)
       if string.kind_of? Builder 
         @strings << string
@@ -17,14 +32,44 @@ module HTMLComponent
       else
         @strings << string.to_s
       end
+      @cached = false
       self
     end
 
+    alias_method :<<, :+
+
+    # Same as +, but allows multiple values to be appended. 
+    def concat(*strings)
+      strings.each do |s|
+        self + s
+      end
+      self
+    end
+
+    # Converts the Builder to a String. If the cache is valid, it is returned. 
+    # Otherwise, the new result is created, cached, and returned.
     def to_s
-      @strings.join
+      unless @cached
+        @cache << @strings.join
+        @strings.clear
+        @cached = true
+      end
+      @cache
     end
 
     alias to_str to_s
+
+    # If the method does not exist on Builder, it is sent to String, by way 
+    # of the rendered Builder result. Modify-in-place methods will affect the 
+    # underlying String.
+    def method_missing(method, *args, &block)
+      to_s.send(method, *args, &block)
+    end
+    
+    # If String responds to the method, then Builder also responds to it.
+    def respond_to_missing?(method)
+      "".respond_to?(method)
+    end
   end
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: html-native
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Kellen Watt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-01-30 00:00:00.000000000 Z
+date: 2021-02-01 00:00:00.000000000 Z
 dependencies: []
 description: An html generation DSL designed for fluid code creation.
 email: