html-native 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ba13af6f45f467e85f5880d5fd690a5e0cad66b6fbbe1a1a9e790c8d6c1f564
-  data.tar.gz: 7f41524489dff7db2c4876bb761b1fc06fe7d3a61b30a4d4606bdc3a2ce03400
+  metadata.gz: 21997059907e655e0171cd63d1b7bac5be51d1c3474c87849b508463a1ab011b
+  data.tar.gz: c87c0911546412b8954dd674f22ccd128f0b2ce985df085e2f38cbce3c150686
 SHA512:
-  metadata.gz: 989fbc6f4dd146d6eaaadeb5f34a42172163c6c1b786128377b806aa099e6a64fea71af58af27a56397ff16e30a66973f16a5c3c99229736ac8cb7b7f49fe737
-  data.tar.gz: ea723f768aec7c753d26c6ffa47fb8077b747d8afd256668ee09838d593b0eb45dcd479381179ae4bbfc7a2433789fdaddc5801e0ded3c085a6a7c468e2b33b0
+  metadata.gz: 566d2c708f9c6829eb727f71f461d1499093ab995a35fdb5748f8b68dc157fb4bf6c650c02acc5cd6a6fc14c88224ea1c0921cbfded11244ebe6a7890ff4e3d7
+  data.tar.gz: ed6f3a80fea8a20e058770804255f87b93999dcf6d0b81cebaead9bbd2628750e2581549cbc536c16f8581b046e8f5fdfd0f6fc07fe86dc2165a10bf2a35cfdc

data/lib/html-native.rb

@@ -1,5 +1,6 @@
 require "html-native/constants"
 require "html-native/builder"
+require "html-native/logic"
 
 module HTMLComponent
  
@@ -17,6 +18,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 

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]
-      else
-        @strings = strings.dup
-      end
+      @strings = []
+      @cache = 
+        if strings.kind_of? Array
+          strings.join
+        elsif strings.kind_of? Enumerable
+          strings.to_a.join
+        else
+          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,43 @@ 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

data/lib/html-native/logic.rb

@@ -0,0 +1,38 @@
+module HTMLComponent
+  class Builder
+    define_method(:if) do |bool|
+      if bool
+        self
+      else
+        Builder.new
+      end
+    end
+
+    define_method(:unless) do |bool|
+      if bool
+        Builder.new
+      else
+        self
+      end
+    end
+  end
+end
+
+class String
+  define_method(:if) do |bool|
+    if bool
+      Builder.new(self)
+    else
+      Builder.new
+    end
+  end
+
+  define_method(:unless) do |bool|
+    # BAd form, purely for symmetry
+    unless bool
+      Builder.new(self)
+    else
+      Builder.new
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: html-native
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 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:
@@ -20,6 +20,7 @@ files:
 - lib/html-native/builder.rb
 - lib/html-native/collections.rb
 - lib/html-native/constants.rb
+- lib/html-native/logic.rb
 homepage: https://github.com/KellenWatt/html-native
 licenses:
 - MIT