html-native 0.2.0 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f4e5910254a0afad80152339f40b75051ac6045ab51b95f3a0cfd44c6d9d9c81
-  data.tar.gz: a291bbadcb69cb44f067c7c17c01a39b542f8f9bfaebceb95f1b76731c6bbbef
+  metadata.gz: f7d9334c86a350e7f344e3c1ba7a959d2dbc2b480ae74f0690dc2e8df45c26d6
+  data.tar.gz: 8697f7d54be0f9d86df14c6ccd97b3a52d73b48803a7dce76ce50ea9526549ef
 SHA512:
-  metadata.gz: 27da9d8f7a378e0a2eff7b989fae29f8ab04b000715542f87906ecda76cae0b4dd31a82fd3fab4e3dd50ca64954efd64727ac3d4bdbda13d497d6c3cffcba7d4
-  data.tar.gz: 846abdea65fb7711610a9a22a5b80c85527fc67c34af386924af7b4092bd32e41a0b1587eef4ff26a8d13c1949801dd4e4e18274ba99f8a7b5aea046b06a1658
+  metadata.gz: 0bfa60e3c71b9e08e633be4a019922cc6761097e39a9be382f7cbabf2fc2a49ff44f2d4def80a68fd1e6619858ac7c72b08c48a5f6a0b63215bcc947c23ad510
+  data.tar.gz: 2d5bfb8a037ca4e6aa243a375b81d503ffa2069f02c2fd1d3c5ae05a59b7b2f24eb8e602516a7e3f22b082367ade7d8e4423deb4fa17abd8a60a90c60b0a2f04

data/lib/html-native.rb

@@ -17,6 +17,10 @@ module HTMLComponent
     end
   end
 
+  def doctype(type)
+    Builder.new("<!DOCTYPE #{type}>")
+  end
+
   # Creates a module that encompasses the given block in an HTMLComponent
   # context. This gives access to methods in the block as though the block was 
   # declared as the `render` function in a module extending HTMLComponent 
@@ -52,6 +56,6 @@ module HTMLComponent
         "#{k}=\"#{v}\"" # render this appropriately for numeric fields (might already)
       end
     end.join(" ")
-    formatted.empty? ? "" : " " + formatted
+    formatted.prepend(" ") unless formatted.empty?
   end
 end

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,11 +32,49 @@ 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_method :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, include_all)
+      "".respond_to?(method, include_all)
+    end
+  end
+end
+
+class String
+  def component
+    HTMLComponent::Builder.new(self)
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: html-native
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.5
 platform: ruby
 authors:
 - Kellen Watt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-01-26 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: