html-native 0.2.2 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4688be25684c101d4edf8c6ee05d061525a08c5fd4e9671b0ebf8f7d286ac11c
-  data.tar.gz: cf500e5cd56ec00233eac3719f647432a75ea8aab6e955fcf6e9140e13cede51
+  metadata.gz: 5a2cde975232defdab37e17881582541235abf7448b690b3a2e7078623961e99
+  data.tar.gz: 140e37d1bb7e039a18e159565c35912d6a54cead980872fd9764ad427f4175cf
 SHA512:
-  metadata.gz: 9a786002324a79d8d1f5a5f62662364a74caac0557be563c06fd2c95610df4b84827c83fdb20a68ffdbd75637ca8da1535f81f2c488d075b5a34b7fc77afd31d
-  data.tar.gz: 5aa97fd17361de4c685833fbbcbacdfe2f6769abec058a7729e22287eb3185b703a38ba8b291b69fbe02f74f9f43227380c6963610ce73efa02242c2c51fecf9
+  metadata.gz: 20ebdb417720ef51aceba2c24878861966eba922981201031be892fb6b86390319e57586339d968fc9d77a3237955b8aa580eba3d53b8d1e26cd6446200450d4
+  data.tar.gz: 4b3d8f0fd9fab698b6fb85d8f270fdc015368497f330ac13c4c3124e499399a313540f159d75672d1b4374335532802d94fdac79677e88544e5325391e939b7c

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,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
+    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
+      HTMLComponent::Builder.new(self)
+    else
+      HTMLComponent::Builder.new
+    end
+  end
+
+  define_method(:unless) do |bool|
+    # BAd form, purely for symmetry
+    unless bool
+      HTMLComponent::Builder.new(self)
+    else
+      HTMLComponent::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.2
+  version: 0.3.1
 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