templet 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5f53a3264d04846496a5fab85e4870ca1f1028b5
+  data.tar.gz: 35f92da74584cca4bf699f0aff237b96f4772a69
+SHA512:
+  metadata.gz: c5c00ae7fc9c270c20986ec45c9fcfa601dbd64f3cf30ae711ef06192eb86ad4a83e85cf16c3402609b6677ece80db87efe3a68df02284ad0335263f2aacdc84
+  data.tar.gz: 8290792806560547f80b385b7a95ac22003b262e4b23c033a1b130b27a714c8984846bba9546fd65fe8dfb5cc773dadd8f9aef02b77b929f1381841bb2659ca3

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+**.swp
+*~

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.4.0
+before_install: gem install bundler -v 1.16.2

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in templet.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,22 @@
+PATH
+  remote: .
+  specs:
+    templet (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    minitest (5.10.2)
+    rake (10.5.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  minitest (~> 5.0)
+  rake (~> 10.0)
+  templet!
+
+BUNDLED WITH
+   1.16.2

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 TODO: Write your name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,533 @@
+
+# Templet
+
+## Introduction
+
+This gem is a stand-alone feather-weight DSL in pure Ruby
+that renders HTML via method calls.
+
+It can run from anywhere (within reason), and with next to no set up.
+Also, it won't cause installation conflicts,
+as it has no external run-time dependencies.
+
+For example, it may be used with a framework (like Rails or Sinatra),
+or as part of a static site generator, or inside a command line script.
+
+It has three main sections:
+
+1. A basic (in-line) renderer.
+
+2. Base classes for splitting up a view into separate components.
+
+3. Helper methods for rendering HTML tables and lists.
+
+_Incidentally, and if such a need arises,
+there is another renderer class, *Templet::Renderers::ERb*,
+that you may use to insert markup inside of an ERb layout,
+either on file or as a string._
+
+## The basic DSL (Renderer)
+
+The DSL processing (i.e. HTML rendering) is handled by
+the class, *Templet::Renderer*.
+But don't expect anything earth-shattering,
+as this class breaks no new ground.
+It's as simple a DSL as you're likely to come across.
+Also, there are a good few others that are similar,
+e.g. XML Builder, Markaby, Arbre, and Fortitude.
+
+The DSL allows you to pass in local variables,
+as well as multiple contexts for method look-ups,
+which means that the DSL is able to expose a wide range of methods
+that can be called from the markup code directly.
+
+However, this basic Renderer, when used by itself,
+has no in-built functionality for modularity,
+and so is not really suitable for long HTML pages,
+or for handling variation, or for code sharing.
+
+## Components (Layouts and Partials)
+
+To avoid these limitations, there are, in addition,
+two base classes supplied that can be used as building blocks
+for composing view segments.
+
+They ought to be used in preference to the (above mentioned)
+*Renderer* class, which they use internally.
+The *Renderer* provides the context in which these Components are run.
+
+The two classes, whose API's have just a single *call* method, are:
+
+1. *Templet::Component::Layout*
+
+2. *Templet::Component::Partial*
+
+In most cases they are to be used as superclasses,
+from which your own custom components (as subclasses) inherit.
+
+You begin with a single *Layout*, which, typically,
+contains calls to a number of *Partials*,
+maybe interspersed with some markup code.
+
+Using these as base classes,
+your own subclasses can receive (local) input variables,
+encapsulate helper methods,
+and act as a container for constituent elements.
+
+More specifically,
+these classes allow you to develop general-purpose components,
+such as, HTML layouts, Rails forms, Bootstrap menus,
+and even a full-blown Rails Scaffolding alternative.
+
+But there's no need for you to embark on such a venture yourself,
+as these things are implemented in the related gem:
+[templet\_rails](https://github.com/srycyk/templet_rails).
+
+## HTML Helpers
+
+Some further classes are included (in the *templet/html/* sub-directory),
+that provide a shortened way to render HTML tables and lists.
+Their content is determined by a Ruby Hash or Array,
+which is given as input.
+
+Examples of using these are given towards the end.
+
+## Renderer Usage
+
+Except for very small jobs,
+it's best not to construct an instance of a *Renderer* explicitly,
+even though this is illustrated in the examples which follow.
+
+As noted, it's neater to use the *Renderer* implicitly,
+that is, by means of a *Layout* containing a number of *Partials*.
+
+Still, it is useful to have a grounding in the basic rules and techniques,
+as they apply to the Components as well.
+
+### Rudimentary Renderer Usage
+
+No need to begin by reading an API,
+_(anyway, there isn't one - but most classes just have a **call** method),_
+as this example shows elementary usage:
+
+```ruby
+require 'templet/renderer'
+
+  message = 'Hello there'
+
+  html = Templet::Renderer.new.call do
+           header = head { title 'Role' }
+
+           # +message+ is the closure variable above
+           content = p { message }
+
+           # The Renderer only shows what a block returns
+           # which should be a string, or a callable that returns a string
+           # To return multiple values, use an array of such
+           html { [ header, body(content) ] }
+         end
+
+  puts html
+```
+
+This produces the following HTML:
+
+```html
+<html><head><title>Role</title>
+</head>
+
+<body><p>Hello there</p>
+</body>
+</html>
+```
+
+> Note that the code blocks (passed to the *Renderer*)
+> are not run in the lexical context that blocks normally are.
+> The blocks are actually executed inside of an instance of *Renderer*
+> which inherits from *BasicObject* -
+> which is a threadbare class of very few methods.
+> It's up to you to provide the lookup context(s),
+> which are passed into the *Renderer's* constructor.
+
+### More Advanced Renderer Usage
+
+The following example explains more
+and covers a lot to do with visibility and scoping:
+
+```ruby
+require 'templet'
+
+  class Lister
+    def items
+      %w(One Two Three)
+    end
+  end
+
+  def content
+    'Some content'
+  end
+
+  col_tag = Templet::Renderers::Tag.new(:div, class: :col_md_4)
+
+  # The first two arguments are contexts for method lookups
+  #
+  # The final argument list local variables which take precendence
+  #
+  # The block renders the markup
+  # Note the shortcut call, this call is stated in full in the above example
+  html = Templet.(self, Lister.new, title: 'A Title') do
+           more_content = 'More content'
+
+           # +title+ is (in effect) a local variable passed into the constru
+ctor
+           [ -> { h1(title, :strong) }, # you can include anything callable
+
+             # Calls +items+ from Lister instance, given as a contructor arg
+ument
+             # The +_p+ call renders a <p> tag
+             #   without the underscore the Kernel#p method would override
+             _p(ul(:list_unstyled) { items.map {|item| li item } }),
+
+             div(:row) do
+               # Calls +content+ because +self+ is passed into the contructo
+r
+               # +col_tag+ is a closure variable defined above
+               [ col_tag.(content), col_tag.(more_content), col_tag.('...') 
+]
+             end
+           ]
+         end
+
+  puts html
+```
+
+This produces the following HTML:
+
+```html
+<h1 class='strong'>A Title</h1>
+
+<p><ul class='list-unstyled'><li>One</li>
+
+<li>Two</li>
+
+<li>Three</li>
+</ul>
+</p>
+
+<div class='row'><div class='col-md-4'>Some content</div>
+
+<div class='col-md-4'>More content</div>
+
+<div class='col-md-4'>...</div>
+</div>
+```
+
+## Notes on Usage
+
+The main quirk is that the *Renderer* only outputs
+the actual return value of a given block.
+That is, statements preceding the very last one won't
+show up in the resultant markup.
+*This behaviour differs from that of most other markup API's.*
+
+A block's return type must be either an array of strings or of *callable*
+entities (which themselves return one or more strings).
+This array can be nested at any depth.
+
+Importantly, the block, passed to *Renderer#call*, is **not**
+executed in its natural local (i.e. lexical) scope.
+This means that, although local variables will be accessible,
+the methods (within the current context) won't - unless the
+current value of *self* is passed into the *Renderer's* constructor,
+as one of the initial arguments.
+
+*To put this in more practical terms: be aware that if an error does occur,
+its origin may be flagrantly misreported in the stack trace.*
+
+The tests have more examples of usage,
+also, the source code is easy to follow and is commented.
+
+But don't dig too deep.
+There's not a lot you need to learn to get started,
+and you should be able to pick up the rest as you go along.
+
+## Components
+
+As said, Components facilitate a modular (object oriented) approach
+to rendering markup.
+
+You begin with a Layout, which, typically, contains a number of Partials.
+
+There's no need to have more than a single Layout,
+since Partials can be nested inside one another.
+
+Together, they perform much the same function as their namesakes in Rails.
+
+### Examples of a Layout with Partials
+
+#### A Very Basic Layout Example
+
+```ruby
+require 'templet/component'
+
+  html = Templet::Component::Layout.new(heading: 'A Title').call do
+           # The method calls become HTML tags
+           html do
+             # +heading+ is passed by name above, it overrides
+             [ head(title heading), body { div 'Hello' } ]
+           end
+         end
+
+  puts html
+```
+
+This produces the following HTML:
+
+```html
+<html><head><title>A Title</title>
+</head>
+
+<body><div>Hello</div>
+</body>
+</html>
+```
+
+#### A Slightly More Realistic Example
+
+```ruby
+require 'templet/component'
+
+class HtmlLayout < Templet::Component::Layout
+  def call
+    super do
+      html do
+        [ head { title heading },
+          # The renderer is passed to calling block
+          body(yield renderer) ]
+      end
+    end
+  end
+end
+
+class BodyPart < Templet::Component::Partial
+  def call
+    super do
+      span hello
+    end
+  end
+
+  private
+
+  def hello
+    'Hello'
+  end
+end
+
+class BodyBuild < Templet::Component::Partial
+  def call
+    # This is an alternative way to render markup, i.e. without a super call
+    renderer.call { div BodyPart.new(renderer), :row }
+  end
+end
+
+  html = HtmlLayout.new(heading: 'Down').call do |renderer|
+           # No need to explicitly call(), this'll be done later on
+           BodyBuild.new(renderer)
+         end
+
+  puts html
+```
+
+This produces the following HTML:
+
+```html
+<html><head><title>Down</title>
+</head>
+
+<body><div class='row'><span>Hello</span>
+</div>
+</body>
+</html>
+```
+
+> Although this DSL relies heavily on *method_missing*,
+> this has not brought poor performance - quite the reverse.
+> After all, this DSL is tiny, and thus quick to load and run,
+> making no calls to external libraries.
+> In ERb, or HAML, the source code is parsed (byte by byte)
+> so as to generate some new Ruby code, that is finally executed.
+
+## Examples of Rendering HTML Composites
+
+In these examples, a *nil* value is passed to the constructor,
+but in application code, this will be, in nearly all cases,
+replaced by an instance of a *Renderer*.
+
+> To load these claases you must add: `require 'templet/html'`.
+
+### An Unordered List
+
+```ruby
+Templet::Html::List.new(nil).(["One", "Two", "Three"])
+```
+
+This produces the following HTML:
+
+```html
+<ul><li>One</li>
+
+<li>Two</li>
+
+<li>Three</li>
+</ul>
+```
+
+### A Definition List
+
+In basic cases, you pass in a Hash,
+where the key is the title (the *dt* tag),
+and the value is the data (the *dd* tag).
+This is done as follows:
+
+```ruby
+Templet::Html::DefinitionList.new(nil).({"One"=>"First", "Two"=>"Second", "Three"=>"Third"})
+```
+
+This produces the following HTML:
+
+```html
+<dl><dt>One</dt>
+<dd>First</dd>
+
+<dt>Two</dt>
+<dd>Second</dd>
+
+<dt>Three</dt>
+<dd>Third</dd>
+</dl>
+```
+
+In addition, the value of an entry in this *control* Hash
+can also be a Symbol or Proc.
+In these cases you also supply a record, as a second parameter to *call*.
+If a Symbol is given then it's used as a (Hash) key,
+as in `record[key]`.
+If a Proc is given then it's called with the
+record passed as the first parameter, as in `func.call(record)`.
+
+```ruby
+record = OpenStruct.new(field_1: 'Value 1', field_2: 'Value 2')
+
+controls = { first: :field_1, second: -> (record) { record.send(:field_2) } }
+
+Templet::Html::DefinitionList.new(nil).(controls, record, html_class: 'low')
+```
+
+This produces the following HTML:
+
+```html
+<dl class='low'><dt>First</dt>
+<dd>Value 1</dd>
+
+<dt>Second</dt>
+<dd>Value 2</dd>
+</dl>
+```
+
+### A Table
+
+To render an HTML table you pass to the *call* method,
+a control Hash (as set out just above),
+and a list of records, obviously, with a table row for each record.
+
+```ruby
+controls = { 'Title 1' => nil, # shows the whole of the 'numbers' hash
+                               # if an array was given, it'd be indexed
+             'Title 2' => 'Two', # shows the 'numbers' hash entry 'Two'
+             # calls this proc - the first param is a Renderer instance
+             'Title 3' => proc {|_, numbers| numbers['Three'] }
+           }
+
+Templet::Html::Table.new(nil).(controls, [{"One"=>"First", "Two"=>"Second", "Three"=>"Third"}])
+```
+
+This produces the following HTML:
+
+```html
+<table><thead><tr><th>Title 1</th>
+
+<th>Title 2</th>
+
+<th>Title 3</th>
+</tr>
+</thead>
+
+<tbody><tr>{"One"=>"First", "Two"=>"Second", "Three"=>"Third"}
+<td>Second</td>
+
+<td>Third</td>
+</tr>
+</tbody>
+
+<tfoot><tr><td colspan='3'></td>
+</tr>
+</tfoot>
+</table>
+```
+
+## Examples of Rendering Tags
+
+As mentioned, the *Renderer* class,
+(via a block passed to its *call* method),
+lets you render markup by direct Ruby method calls.
+
+Here are a few examples of some of the ways of using the API to render tags:
+
+* `span('Hello', :small, id: '999') => <span id='999' class='small'>Hello</span>`
+
+* `__p(:pull_right) { 'Hello' } => <p class='pull-right'>Hello</p>`
+
+* `div('', :pull_right, class: 'clearfix') => <div class='clearfix pull-right'></div>`
+
+As you can see, an HTML class can be given as an argument.
+Any underscores, in the class name, will be replaced
+by dashes in the (generated) markup.
+
+To avoid method name clashes, you can prefix a method call with a number of
+underscores, and these won't appear in the corresponding tag name.
+For example, this is particularly important when rendering the HTML tag *p*,
+as there's a Ruby *Kernel* method called *p*, that may be called first.
+
+If you prefer, you can call a *tag* helper method instead of
+inferring a tag name from a method name. For example:
+
+* `tag(:p, 'Hello', :pull_right) => <p class='pull-right'>Hello</p>`
+
+Note that this method will mask any other method,
+of the same name (i.e. *tag*), higher up in the inheritance hierarchy.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+    gem 'templet'
+```
+
+And then execute:
+
+```
+    $ bundle
+```
+
+Or install it yourself as:
+
+```
+    $ gem install templet
+```
+
+## Licence
+
+The gem is available as open source under the terms
+of the [MIT License](https://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "templet"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/templet/component/layout.rb

@@ -0,0 +1,20 @@
+
+module Templet
+  module Component
+    # For composing views - the first step
+    class Layout < Partial
+      # +contexts+:: A list containing objects whose methods will be looked up
+      # +locals+:: Objects you can reference by the given name
+      def initialize(*contexts, **locals)
+        contexts = [ self, *contexts ]
+
+        self.renderer = Renderer.new(*contexts, **locals)
+      end
+
+      def self.call(*contexts, **locals, &block)
+        new(*contexts, **locals).(&block)
+      end
+    end
+  end
+end
+

data/lib/templet/component/partial.rb

@@ -0,0 +1,32 @@
+
+module Templet
+  module Component
+    # Used for composing views, either within a Layout or another Parial
+    class Partial
+      attr_accessor :renderer
+
+      # +contexts+:: A list containing objects whose methods will be looked up
+      # +locals+:: Objects you can reference by the name given as the key
+      def initialize(renderer, *contexts, **locals)
+        self.renderer = renderer&.new_instance(self, *contexts, **locals) ||
+                        Renderer.new(self, *contexts, **locals)
+      end
+
+      # Entry point - the block returns markup
+      def call(&block)
+        renderer.(&block)
+      end
+
+      # Shortcut
+      def self.call(renderer, *contexts, **locals, &block)
+        new(renderer, *contexts, **locals).(&block)
+      end
+
+      private
+
+      # If +call+ gets overriden then use +compose+ instead
+      alias compose call
+    end
+  end
+end
+

data/lib/templet/component.rb

@@ -0,0 +1,10 @@
+
+require 'templet'
+
+require 'templet/component/partial'
+require 'templet/component/layout'
+
+module Templet
+  module Component
+  end
+end

data/lib/templet/html/definition_list.rb

@@ -0,0 +1,38 @@
+
+require 'templet/component/partial'
+
+module Templet
+  module Html
+    # Renders an HTML dl from a Hash
+    class DefinitionList < Component::Partial
+      # +controls+ [Hash]
+      #   The key is the field's title
+      #   The value is the field value || a Proc which calls the record's method
+      def call(controls, record=nil, html_class: nil)
+        super() do
+          dl(html_class || default_html_class) do
+            controls.to_h.map do |title, data|
+              title = title.to_s.capitalize.tr('_', ' ')
+
+              if data.respond_to?(:call)
+                data = data.(record)
+              elsif Symbol === data
+                data = if record and record.respond_to?(:[])
+                         record[data]
+                       else
+                         data.to_s.capitalize.tr('_', ' ')
+                       end
+              end
+
+              dt(title) + dd(data)
+            end
+          end
+        end
+      end
+
+      def default_html_class
+      end
+    end
+  end
+end
+

data/lib/templet/html/list.rb

@@ -0,0 +1,50 @@
+
+require 'templet/component/partial'
+
+module Templet
+  module Html
+    class List < Component::Partial
+      def call(*items, html_class: nil,
+                       item_class: nil,
+                       selection: nil,
+                       selected_class: 'active')
+        super() do
+          ul html_class do
+            items.flatten.map.with_index do |item, index|
+              li item, li_class(selection, item, index,
+                                item_class, selected_class)
+            end
+          end
+        end
+      end
+
+      private
+
+      def selected?(selection, item, index)
+        case selection
+        when nil, false
+          false
+        when Integer
+          index == selection
+        when Regexp
+          selection === item
+        else
+          selection.to_s == item.to_s
+        end
+      end
+
+      def li_class(selection, item, index, item_class, selected_class)
+        if selected?(selection, item, index)
+          if item_class and not item_class.empty?
+            "#{item_class} #{selected_class}"
+          else
+            selected_class
+          end
+        else
+          item_class
+        end
+      end
+    end
+  end
+end
+

data/lib/templet/html/table.rb

@@ -0,0 +1,64 @@
+
+require 'templet/component/partial'
+
+module Templet
+  module Html
+    # Renders an HTML table from a Hash
+    class Table < Component::Partial
+      # +controls+ [Hash]
+      #   The key is a Proc || a field name (if it begins with _ it's not shown)
+      #   The value is a Proc || an index || nil (for a single column table)
+      def call(controls, records, opaque_heading: nil, opaque_row: nil,
+                                  html_class: nil, footer: '')
+        controls = controls.to_h
+
+        super() do
+          _table(html_class || default_html_class) do
+            [ thead do
+                tr do
+                  controls.keys.map do |title|
+                    if title.respond_to?(:call)
+                      th title.(self, opaque_heading, opaque_row)
+                    else
+                      th heading(title)
+                    end
+                  end
+                end
+              end,
+
+              tbody do
+                records.map do |record|
+                  tr do
+                    controls.values.map.with_index do |value, index|
+                      if value.respond_to?(:call)
+                        td value.(self, record, opaque_row)
+                      elsif value
+                        td record[value]
+                      else
+                        Array === record ? record[index] : record
+                      end
+                    end
+                  end
+                end
+              end,
+
+              tfoot do
+                tr do
+                  td(colspan: controls.size) { footer }
+                end
+              end
+            ]
+          end
+        end
+      end
+
+      def default_html_class
+      end
+
+      def heading(title)
+        title[0] == '_' ? '' : title.capitalize
+      end
+    end
+  end
+end
+

data/lib/templet/html.rb

@@ -0,0 +1,11 @@
+
+require 'templet'
+
+require 'templet/html/table'
+require 'templet/html/list'
+require 'templet/html/definition_list'
+
+module Templet
+  module Html
+  end
+end

data/lib/templet/renderer.rb

@@ -0,0 +1,60 @@
+
+require "ostruct"
+
+require "templet/renderers/helpers"
+require "templet/renderers/list_presenter"
+require "templet/renderers/tag"
+
+module Templet
+  # Performs the rendition
+  class Renderer < BasicObject
+    include Renderers::Helpers
+
+    # +contexts+ a list of object refererences for method lookups
+    #
+    # +locals+ named variables passed into the renderer
+    def initialize(*contexts, **locals)
+      @contexts = contexts.flatten
+
+      # Local variables take precedence
+      @contexts.unshift ::OpenStruct.new(**locals) if locals.any?
+    end
+
+    # Used for augmenting and overriding method lookups in children
+    def new_instance(*contexts, **locals)
+      Renderer.new(*(contexts | @contexts), **locals)
+    end
+
+    # The block contains the markup
+    def call(&block)
+      Renderers::ListPresenter.new.(instance_eval &block)
+    end
+
+    def method_missing(name, *args, &block)
+      @contexts.each do |context|
+        if context.respond_to?(name, true)
+          return context.send(name, *args, &block)
+        end
+      end
+      fallback(name, *args, &block)
+    end
+
+    def respond_to?(method_name, *)
+      @contexts.each do |context|
+        return true if context.respond_to?(method_name, true)
+      end
+      false
+    end
+
+    private
+
+    def tag(name, *args, &block)
+      Renderers::Tag.new(name).(*args, &block)
+    end
+
+    # Allows you to reimplement +fallback+ in a subclass
+    # For example, you might use the Rails helper method +content_tag+ instead
+    alias fallback tag
+  end
+end
+

data/lib/templet/renderers/erb.rb

@@ -0,0 +1,44 @@
+
+require 'erb'
+require 'ostruct'
+
+module Templet
+  module Renderers
+    # For rendering a supplied block within an ERb template
+    class ERb
+      attr_accessor :erb, :context
+
+      # template_path can be a local ERb file, or template text
+      #
+      # locals are local variables for the ERb template alone
+      def initialize(template, **locals)
+        self.erb = ERB.new get_template(template)
+
+        self.context = OpenStruct.new(**locals)
+      end
+
+      # The return value from the block in substituted in <%= yield %>
+      def call(&block)
+        locals_binding = context.instance_eval { binding }
+
+        erb.result locals_binding, &block
+      end
+
+      # Shortcut to instance method
+      def self.call(template_path, **locals, &block)
+        new(template_path, **locals).(&block)
+      end
+
+      private
+
+      def get_template(template)
+        if template =~ /<%/
+          template
+        else
+          IO.read template
+        end
+      end
+    end
+  end
+end
+

data/lib/templet/renderers/helpers.rb

@@ -0,0 +1,16 @@
+
+module Templet
+  # For general purpose methods, it's included in the Renderer class
+  module Renderers
+    module Helpers
+      private
+
+      def echo(*elements)
+        elements
+      end
+
+      alias returns echo
+    end
+  end
+end
+

data/lib/templet/renderers/list_presenter.rb

@@ -0,0 +1,22 @@
+
+module Templet
+  module Renderers
+  # Converts lists of strings and/or callable objects into a multiline string
+    class ListPresenter
+      def call(*elements)
+        elements.flatten.compact.map do |element|
+          element = recall(element)
+
+          Array === element ? call(*element) : element.to_s
+        end * EOL
+      end
+
+      private
+
+      def recall(element)
+        element.respond_to?(:call) ? recall(element.call) : element
+      end
+    end
+  end
+end
+

data/lib/templet/renderers/tag.rb

@@ -0,0 +1,86 @@
+
+require "templet/renderers/list_presenter"
+
+module Templet
+  module Renderers
+    # Renders an XML tag
+    class Tag < Struct.new(:tag_name, :default_atts)
+      @@level = 0
+
+      # A shortcut for calling directly.
+      def self.call(*args, &block)
+        new(args.shift).(*args, &block)
+      end
+
+      # +args+:: The first element becomes the tag's name.
+      #
+      # +args+:: The remaining elements are the tag's body and/or HTML class.
+      #
+      # +atts+:: An optional final (Hash) argument are rendered as the tag's attributes.
+      #
+      # If a block is given:
+      # The tag's body is what the block returns
+      # If there's an argument (String Symbol) then it's added to the tag's HTML class.
+      #
+      # If NO block is given:
+      # The tag's body is the first argument.
+      # If there's a second (String Symbol) argument it's added to the tag's HTML class.
+      #
+      #   Note that in attribute (and tag) names underscores are replaced
+      #   with dashes.
+      def call(*args, **atts)
+        content, html_class = block_given? ? [ yield, args.first ] : args
+
+        attributes = set_html_class all_atts(atts), html_class
+
+        render tag_name, content, attributes
+      end
+
+      alias to_s call
+
+      private
+
+      def render(name, content, **atts)
+        name = dashit name.to_s.sub(/^_+/, '')
+
+        content = ListPresenter.new.(content)
+
+        "<#{name}#{atts_to_s atts}>#{content}</#{name}>#{EOL}"
+      end
+
+      # Change underscores to dashes when specifying
+      #   XML tag names, attribute names and html classes.
+      # For a single underscore, put in two.
+      def dashit(name)
+        (name || '').to_s.tr('_', '-').gsub(/--/, '_') # could be better!
+      end
+
+      def dash_symbol(value)
+        Symbol === value ? dashit(value) : value
+      end
+
+      def atts_to_s(atts)
+        atts.reduce '' do |acc, (key, value)|
+          acc << " #{dashit key}='#{dash_symbol value}'"
+        end
+      end
+
+      def all_atts(atts)
+        (default_atts || {}).merge atts
+      end
+
+      # If there's already an HTML class then append to it
+      def set_html_class(atts, html_class)
+        unless (new_html_class = dashit(html_class)).empty?
+          atts[:class] = existing_html_class(atts) << new_html_class
+        end
+        atts
+      end
+
+      def existing_html_class(atts)
+        atts.key?(:class) ? "#{dash_symbol atts[:class]} " : ''
+      end
+    end
+  end
+end
+

data/lib/templet/version.rb

@@ -0,0 +1,3 @@
+module Templet
+  VERSION = "0.1.0"
+end

data/lib/templet.rb

@@ -0,0 +1,21 @@
+
+require "templet/version"
+require "templet/renderer"
+require "templet/renderers/erb"
+
+require "templet/component"
+require "templet/html"
+
+module Templet
+  EOL = "\n"
+
+  def self.call(*contexts, &block)
+    renderer = Renderer.new(*contexts)
+
+    block ? renderer.(&block) : renderer
+  end
+
+  def self.erb(template_path, **locals, &block)
+    Renderers::Erb.(template_path, **locals, &block)
+  end
+end

data/templet.gemspec

@@ -0,0 +1,38 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "templet/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "templet"
+  spec.version       = Templet::VERSION
+  spec.authors       = ["stephen"]
+  spec.email         = ["stephen@googlemail.com"]
+
+  spec.summary       = %q{DSL to render XML/HTML}
+  spec.description   = %q{Generates HTML tags from pure Ruby, using a method name as a tag's name, via method_missing. Also renders HTML components.}
+  spec.homepage      = "https://github.com/srycyk/templet"
+  spec.license       = "MIT"
+
+=begin
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+=end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: templet
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- stephen
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-11-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: Generates HTML tags from pure Ruby, using a method name as a tag's name,
+  via method_missing. Also renders HTML components.
+email:
+- stephen@googlemail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/templet.rb
+- lib/templet/component.rb
+- lib/templet/component/layout.rb
+- lib/templet/component/partial.rb
+- lib/templet/html.rb
+- lib/templet/html/definition_list.rb
+- lib/templet/html/list.rb
+- lib/templet/html/table.rb
+- lib/templet/renderer.rb
+- lib/templet/renderers/erb.rb
+- lib/templet/renderers/helpers.rb
+- lib/templet/renderers/list_presenter.rb
+- lib/templet/renderers/tag.rb
+- lib/templet/version.rb
+- templet.gemspec
+homepage: https://github.com/srycyk/templet
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.12
+signing_key: 
+specification_version: 4
+summary: DSL to render XML/HTML
+test_files: []