nm 0.1.0 → 0.2.0

data/bench/slideshow_partials.nm

@@ -0,0 +1,8 @@
+node 'slideshow' do
+  node 'start_slide', view.start_slide
+  node 'slides' do
+    map view.slides do |slide|
+      partial 'slide', :slide => slide
+    end
+  end
+end

data/bench/slideshow_partials.rb

@@ -0,0 +1,17 @@
+require 'assert/factory'
+require 'bench/slideshow'
+
+module NmBench
+
+  class SlideshowPartialsTemplate < SlideshowTemplate
+
+    TEMPLATES[:slideshow_partials] = self
+
+    def initialize
+      super
+      @name = 'slideshow_partials'
+    end
+
+  end
+
+end

data/bench/template.rb

@@ -0,0 +1,16 @@
+module NmBench
+
+  class Template
+
+    attr_reader :name, :locals
+
+    TEMPLATES = {}
+    require 'bench/slideshow'
+
+    def self.find(name)
+      TEMPLATES[name].new
+    end
+
+  end
+
+end

data/lib/nm.rb

@@ -1,4 +1,5 @@
 require "nm/version"
+require 'nm/source'
 
 module Nm
 end

data/lib/nm/ext.rb

@@ -0,0 +1,31 @@
+module Nm
+
+  class InvalidError < RuntimeError; end
+
+end
+
+class ::Hash
+
+  def __nm_add_call_data__(call_name, data)
+    if data.is_a?(::Array)
+      raise Nm::InvalidError, "invalid `#{call_name}` call"
+    end
+    self.merge(data || {})
+  end
+
+end
+
+class ::Array
+
+  def __nm_add_call_data__(call_name, data)
+    if data.is_a?(::Hash)
+      raise Nm::InvalidError, "invalid `#{call_name}` call"
+    end
+    self.concat(data || [])
+  end
+
+end
+
+def nil.__nm_add_call_data__(call_name, data)
+  data
+end

data/lib/nm/source.rb

@@ -0,0 +1,49 @@
+require 'pathname'
+require 'nm/template'
+
+module Nm
+
+  class Source
+
+    EXT = ".nm"
+
+    attr_reader :root
+
+    def initialize(root)
+      @root = Pathname.new(root.to_s)
+    end
+
+    def data(file_path)
+      File.send(File.respond_to?(:binread) ? :binread : :read, file_path)
+    end
+
+    def render(file_name, locals = nil)
+      Template.new(self, source_file_path(file_name), locals || {}).__data__
+    end
+
+    def partial(file_name, locals = nil)
+      Template.new(self, partial_file_path(file_name), locals || {}).__data__
+    end
+
+    private
+
+    def source_file_path(file_name)
+      self.root.join("#{file_name}#{EXT}").to_s
+    end
+
+    def partial_file_path(file_name)
+      basename = File.basename(file_name.to_s)
+      source_file_path(file_name.to_s.sub(/#{basename}\Z/, "_#{basename}"))
+    end
+
+  end
+
+  class DefaultSource < Source
+
+    def initialize
+      super('/')
+    end
+
+  end
+
+end

data/lib/nm/template.rb

@@ -0,0 +1,95 @@
+require 'nm/source'
+require 'nm/ext'
+
+module Nm
+
+ class Template
+
+    def initialize(*args)
+      @__dstack__ = [ nil ]
+
+      # apply any given locals to template scope as methods
+      metaclass = class << self; self; end
+      (args.last.kind_of?(::Hash) ? args.pop : {}).each do |key, value|
+        metaclass.class_eval{ define_method(key){ value } }
+      end
+
+      source_file = args.last.kind_of?(::String) ? args.pop : ''
+      @__source__ = args.last.kind_of?(Source) ? args.pop : DefaultSource.new
+
+      return if source_file.empty?
+
+      unless File.exists?(source_file)
+        raise ArgumentError, "source file `#{source_file}` does not exist"
+      end
+      instance_eval(@__source__.data(source_file), source_file, 1)
+    end
+
+    def __data__
+      @__dstack__.last
+    end
+
+    def __node__(key, value = nil, &block)
+      unless @__dstack__[-1].nil? || @__dstack__[-1].is_a?(::Hash)
+        raise Nm::InvalidError, "invalid `node` call"
+      end
+      @__dstack__[-1] ||= ::Hash.new
+
+      @__dstack__.push(nil)
+      self.instance_exec(&(block || Proc.new {}))
+      @__dstack__.pop.tap{ |v| @__dstack__[-1][key] = (v || value) }
+
+      return self
+    end
+
+    alias_method :node,  :__node__
+    alias_method :_node, :__node__
+    alias_method :n,     :__node__
+
+    def __map__(list, &block)
+      unless list.respond_to?(:map)
+        raise ArgumentError, "given list (`#{list.class}`) doesn't respond to `.map`"
+      end
+      unless @__dstack__[-1].nil? || @__dstack__[-1].is_a?(::Array)
+        raise Nm::InvalidError, "invalid `map` call"
+      end
+      @__dstack__[-1] ||= ::Array.new
+
+      list.map do |item|
+        @__dstack__.push(nil)
+        self.instance_exec(item, &(block || Proc.new {}))
+        @__dstack__.pop.tap{ |v| @__dstack__[-1].push(v || item) }
+      end
+
+      return self
+    end
+
+    alias_method :map,  :__map__
+    alias_method :_map, :__map__
+    alias_method :m,    :__map__
+
+    def __render__(*args)
+      data = @__source__.render(*args)
+      @__dstack__[-1] = @__dstack__[-1].__nm_add_call_data__('render', data)
+
+      return self
+    end
+
+    alias_method :render,  :__render__
+    alias_method :_render, :__render__
+    alias_method :r,       :__render__
+
+    def __partial__(*args)
+      data = @__source__.partial(*args)
+      @__dstack__[-1] = @__dstack__[-1].__nm_add_call_data__('partial', data)
+
+      return self
+    end
+
+    alias_method :partial,  :__partial__
+    alias_method :_partial, :__partial__
+    alias_method :p,        :__partial__
+
+  end
+
+end

data/lib/nm/version.rb

@@ -1,3 +1,3 @@
 module Nm
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/nm.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |gem|
   gem.version     = Nm::VERSION
   gem.authors     = ["Kelly Redding", "Collin Redding"]
   gem.email       = ["kelly@kellyredding.com", "collin.redding@me.com"]
-  gem.description = %q{JSON/BSON data structure template system }
-  gem.summary     = %q{JSON/BSON data structure template system }
+  gem.description = %q{Data templating system.}
+  gem.summary     = %q{Data templating system.}
   gem.homepage    = "http://github.com/redding/nm"
   gem.license     = 'MIT'
 

data/script/bench_all.rb

@@ -0,0 +1,5 @@
+# $ bundle exec ruby script/bench.rb
+
+require 'script/bench_rabl'
+require 'script/bench_nm'
+require 'script/bench_nm_re_source'

data/script/bench_nm.rb

@@ -0,0 +1,13 @@
+# $ bundle exec ruby script/bench.rb
+
+# require pry for debugging (`binding.pry`)
+require 'pry'
+
+require 'bench/logger'
+require 'bench/slideshow'
+
+NmBench::Logger.new('bench/results/nm.txt') do |logger|
+  logger.run_template(:nm, :slideshow, 1)
+  logger.run_template(:nm, :slideshow, 10)
+  logger.run_template(:nm, :slideshow, 100)
+end

data/script/bench_nm_partials.rb

@@ -0,0 +1,13 @@
+# $ bundle exec ruby script/bench.rb
+
+# require pry for debugging (`binding.pry`)
+require 'pry'
+
+require 'bench/logger'
+require 'bench/slideshow_partials'
+
+NmBench::Logger.new('bench/results/nm_partials.txt') do |logger|
+  logger.run_template(:nm, :slideshow_partials, 1)
+  logger.run_template(:nm, :slideshow_partials, 10)
+  logger.run_template(:nm, :slideshow_partials, 100)
+end

data/script/bench_nm_re_source.rb

@@ -0,0 +1,13 @@
+# $ bundle exec ruby script/bench.rb
+
+# require pry for debugging (`binding.pry`)
+require 'pry'
+
+require 'bench/logger'
+require 'bench/slideshow'
+
+NmBench::Logger.new('bench/results/nm_re_source.txt') do |logger|
+  logger.run_template(:nm_re_source, :slideshow, 1)
+  logger.run_template(:nm_re_source, :slideshow, 10)
+  logger.run_template(:nm_re_source, :slideshow, 100)
+end

data/script/bench_rabl.rb

@@ -0,0 +1,13 @@
+# $ bundle exec ruby script/bench.rb
+
+# require pry for debugging (`binding.pry`)
+require 'pry'
+
+require 'bench/logger'
+require 'bench/slideshow'
+
+NmBench::Logger.new('bench/results/rabl.txt') do |logger|
+  logger.run_template(:rabl, :slideshow, 1)
+  logger.run_template(:rabl, :slideshow, 10)
+  logger.run_template(:rabl, :slideshow, 100)
+end

data/test/helper.rb

@@ -1,8 +1,15 @@
 # this file is automatically required when you run `assert`
 # put any test helpers here
 
+require 'pathname'
+
 # add the root dir to the load path
-$LOAD_PATH.unshift(File.expand_path("../..", __FILE__))
+ROOT = Pathname.new(File.expand_path("../..", __FILE__))
+$LOAD_PATH.unshift(ROOT.to_s)
+
+TEMPLATE_ROOT = ROOT.join('test/support/templates')
 
 # require pry for debugging (`binding.pry`)
 require 'pry'
+
+require 'test/support/factory'

data/test/support/factory.rb

@@ -0,0 +1,14 @@
+require 'assert/factory'
+
+module Factory
+  extend Assert::Factory
+
+  def self.template_root
+    TEMPLATE_ROOT.to_s
+  end
+
+  def self.template_file(name)
+    TEMPLATE_ROOT.join(name).to_s
+  end
+
+end

data/test/support/templates/_list.nm

@@ -0,0 +1,3 @@
+map [1, 2, 3] do |num|
+  node num.to_s, num
+end

data/test/support/templates/_locals.nm

@@ -0,0 +1,3 @@
+node 'locals' do
+  node 'key', key
+end

data/test/support/templates/_obj.nm

@@ -0,0 +1,3 @@
+node 'a', 'Aye'
+node 'b', 'Bee'
+node 'c', "See"

data/test/support/templates/aliases.nm

@@ -0,0 +1,4 @@
+_map (1..1) do
+  n     'node local value', node
+  _node 'map local value',  map
+end

data/test/support/templates/list.nm

@@ -0,0 +1,3 @@
+map [1, 2, 3] do |num|
+  node num.to_s, num
+end

data/test/support/templates/locals.nm

@@ -0,0 +1,3 @@
+node 'locals' do
+  node 'key', key
+end

data/test/support/templates/obj.nm

@@ -0,0 +1,5 @@
+node 'obj' do
+  node 'a', 'Aye'
+  node 'b', 'Bee'
+  node 'c', "See"
+end

data/test/unit/ext_tests.rb

@@ -0,0 +1,94 @@
+require 'assert'
+require 'nm/ext'
+
+module Nm::Ext
+
+  class UnitTests < Assert::Context
+    desc "Nm ruby extension"
+    subject{ Nm }
+
+    should "define and invalid runtime error" do
+      assert_kind_of ::RuntimeError, subject::InvalidError.new
+    end
+
+  end
+
+  class AddCallDataTests < UnitTests
+    desc "__nm_add_call_data__"
+    setup do
+      @call_name = Factory.string
+    end
+
+    should "be added to ::Hash" do
+      assert_responds_to :__nm_add_call_data__, ::Hash.new
+    end
+
+    should "be added to ::Array" do
+      assert_responds_to :__nm_add_call_data__, ::Array.new
+    end
+
+    should "be added to nil" do
+      assert_responds_to :__nm_add_call_data__, nil
+    end
+
+  end
+
+  class HashAddCallDataTests < AddCallDataTests
+    desc "on ::Hash"
+    setup do
+      @h = { 1 => '1' }
+    end
+
+    should "merge and return hash and nil data" do
+      add = { 2 => '2' }
+      assert_equal @h.merge(add), @h.__nm_add_call_data__(@call_name, add)
+      assert_equal @h, @h.__nm_add_call_data__(@call_name, nil)
+    end
+
+    should "complain if adding Array data" do
+      add = []
+      assert_raises Nm::InvalidError do
+        @h.__nm_add_call_data__(@call_name, add)
+      end
+    end
+
+  end
+
+  class ArrayAddCallDataTests < AddCallDataTests
+    desc "on ::Array"
+    setup do
+      @a = [1, 2]
+    end
+
+    should "concat and return array and nil data" do
+      add = [3, 4]
+      assert_equal @a.concat(add), @a.__nm_add_call_data__(@call_name, add)
+      assert_equal @a, @a.__nm_add_call_data__(@call_name, nil)
+    end
+
+    should "complain if adding Hash data" do
+      add = {}
+      assert_raises Nm::InvalidError do
+        @a.__nm_add_call_data__(@call_name, add)
+      end
+    end
+
+  end
+
+  class NilAddCallDataTests < AddCallDataTests
+    desc "on nil"
+    setup do
+      @n = nil
+    end
+
+    should "return any given data" do
+      add_hash = { 1 => '1' }
+      add_array = [3, 4]
+      assert_equal add_hash,  @n.__nm_add_call_data__(@call_name, add_hash)
+      assert_equal add_array, @n.__nm_add_call_data__(@call_name, add_array)
+      assert_equal @n, @n.__nm_add_call_data__(@call_name, nil)
+    end
+
+  end
+
+end