nm 0.5.3 → 0.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 --- 
-SHA1: 
-  data.tar.gz: cbd3cdb0ce766948af48d6a1c502f0efd972666d
-  metadata.gz: adabe344f116f0b43fc0c525e2f074b6dda71de8
 SHA512: 
-  data.tar.gz: 69bf2f992a72ffa1fb4d0920f932e25bfbaab7352bf5cd76aaa46dd39d96d1d9aa12cbee217155b32eb2184f4bb94dfa1d047447700423936a8d7b236508ee9a
-  metadata.gz: 58e61ae563a80584e393272ef1bbb4d2f7bfe5778bd784c40073378679bd9b678edc34633cb9a9b475a7a1122fc17794dd15f1e5a3b61a5dca1e6193b9830bd5
+  metadata.gz: 31eb095487432e3c6b60cbb023624cce4b902371692cea5312d52d0bcd6a57d98ad2ca4171110f66e2bd4028fdf449c6eee00442d769fc260abd7ab76f8f15cb
+  data.tar.gz: 43ec476c3b63ec379f30edc5b75989f56843eab905e90a0a2b4422022102f2cbd5931cc3b09bbe7f3aeeacf26280a130dc6a8875af9cfd83b4ed903dcfeda5c8
+SHA1: 
+  metadata.gz: 79b11e40bec9d04eed9c4590c06ee9acc2a74ba9
+  data.tar.gz: 2a6984f912b917b14c9ab9ba5a524c310f8f7648

data/README.md

@@ -94,6 +94,29 @@ There are two main markup methods:
 * `node`: create a named attribute on a hash object
 * `map`: create a list object mapped from a given list
 
+### Default render value
+
+Nm templates render an empty object (ie `::Hash.new`) if no source is given or no markup methods are called in the template source.  The idea is that the templates should always return *something* and avoid `nil` values as much as possible.
+
+This is also more consistent with rendering mapped lists vs reduced objects.  Say your are mapping a list of objects in your template (using the `map` markup method):
+
+```ruby
+map incoming_list do |item|
+  node 'name',  item.name
+  node 'value', item.value
+end
+```
+
+If there are no items in the incoming list, the template render produces an empty list.  Now say you are reducing an incoming list to a single object:
+
+```ruby
+incoming_list.each do |item|
+  node item.name, item.value
+end
+```
+
+If there are no items in the incoming list, no markup methods are called, but the template render still produces an empty object b/c that is the default value.
+
 ### Partials
 
 **Note**: using partials negatively impacts template rendering performance.

data/lib/nm/template.rb

@@ -6,7 +6,7 @@ module Nm
  class Template
 
     def initialize(*args)
-      @__dstack__ = [ nil ]
+      @__dstack__ = [nil]
 
       # apply any given locals to template scope as methods
       metaclass = class << self; self; end
@@ -34,7 +34,7 @@ module Nm
     end
 
     def __data__
-      @__dstack__.last
+      @__dstack__.last || ::Hash.new
     end
 
     def __node__(key, value = nil, &block)

data/lib/nm/version.rb

@@ -1,3 +1,3 @@
 module Nm
-  VERSION = "0.5.3"
+  VERSION = "0.5.4"
 end

data/test/unit/template_tests.rb

@@ -25,8 +25,8 @@ class Nm::Template
     should have_imeths :render,  :_render,  :r
     should have_imeths :partial, :_partial, :p
 
-    should "have no data if no source file is given" do
-      assert_nil subject.__data__
+    should "have empty data if no markup meths called or no source given" do
+      assert_equal ::Hash.new, subject.__data__
     end
 
     should "return itself when its markup methods are called" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: nm
 version: !ruby/object:Gem::Version 
-  version: 0.5.3
+  version: 0.5.4
 platform: ruby
 authors: 
 - Kelly Redding
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2016-06-10 00:00:00 Z
+date: 2016-09-30 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: assert
@@ -80,7 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 2.6.4
+rubygems_version: 2.6.6
 signing_key: 
 specification_version: 4
 summary: Data templating system.