rndr 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 703f888719f6993503d82d3786fc7a3eb5c82952
+  data.tar.gz: c0d2b4e7a30c6cf7934f4932ff9d9c5b6a9bde11
+SHA512:
+  metadata.gz: cb3c39ca03f967924002b91fa64073524dac34084a1b8f2b76b7105beb4c532a73f71ac3dc2b38509642bc791887233004100f302fb83ed0d16a5fc8b60d382a
+  data.tar.gz: b069bf6c60fc6bf2ccc1646387a2d38a75ff325a96173c7445f021c684f630325eba1f21c2f89b4d82742034f587eeddf28ca5794cde95ab01412f7bb2fe2180

data/.gitignore

@@ -0,0 +1,22 @@
+._*
+.DS_Store
+.*.sw?
+*~
+*.gem
+*.rbc
+/.config
+/.yardoc
+/_yardoc
+/doc/
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/templates/*.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+Gemfile.lock
+.ruby-version
+.ruby-gemset

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format documentation
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,14 @@
+AllCops:
+  TargetRubyVersion: 2.3
+
+Metrics/AbcSize:
+  Max: 20
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/LineLength:
+  Max: 100
+
+Style/Documentation:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,12 @@
+language: ruby
+rvm:
+- 2.3.1
+env:
+- CI=true
+
+deploy:
+  provider: rubygems
+  on:
+    tags: true
+  api_key:
+    secure: wJ2eSj/CABOHR/jGrYs2liXkyccpIVdu3jiHqpqWcrM4AnOgLoglrv3kpKriizfr/Wi2u9GwltQzdZ0SJQkKbsjmLVBzH/fzPJKiDtndDpUGthUpYGIr3F+qzvmwWKxnpMw1zbXRq37u1v2OPr0PEIcicmvWzi4eM1BQNVYnRLL7MlaQwCOvP4GcCnneH7NVqxB8oPEMoXBKPIln7+T505yEOEUk1mgvzbu0y/lwJpKGGaLmNSiSSeM0x0uC0EgCdh05r9lOS9RtwuC2h0tbfJqaRuIsL+TRPfaWtlrkuqMcJrsbRNb8p2ZL0oh994bdfl8YegC4DbEs4bbu5NrZIETsKBP24QKpgokVAJW8+mqeb7GXChtqScoMO62wZN/5K65kbUNxm81T9NjgyQ5wQvLrU6vH5uzcasZcxJhfVXer3SXtH1RsenjulIM9kUqCU1a8ICfTerTvhKi4rIXcMe9tYHeytdq9E6Wip+mrL/JJHBjxjUtUpkTNoLxLIASF/JVjtla5fo6hVkaw4mAQO1ACisWGLEFdF56Hg98pJ9RrVtmf8PvZPgBuTQN+jq3+nzjLhK/mRxtcW2JXqwSeinqtBuKQHESdnJnIuAyazYlpZD9Xsh39SjRR2xYARipq+HNwNxt9u2AHWWp8/UWqNJxwY4Usp+fi6Li7KBG3AQ8=

data/.yardopts

@@ -0,0 +1,2 @@
+--readme README.md
+--markup markdown

data/Gemfile

@@ -0,0 +1,5 @@
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+source 'https://rubygems.org'
+
+gemspec

data/README.md

@@ -0,0 +1,108 @@
+# Rndr
+[![Build Status](https://travis-ci.org/arc-ts/rndr.svg?branch=master)](https://travis-ci.org/arc-ts/rndr)
+[![Coverage Status](https://coveralls.io/repos/github/arc-ts/rndr/badge.svg?branch=master)](https://coveralls.io/github/arc-ts/rndr?branch=master)
+
+Rndr is a small Ruby cli gem that provides a method of rendering discovered erb templates. Variables for use in template rendering can be used directly by providing a either a `yaml` or `json` file, or alternatively a directory may be supplied along with the variable merging strategy. Rndr supports both standard hash merges or recursive (default).
+
+Paths can be ignored by either creating a `.rndrignore` file within the current working directly, or supplying a path to a desired ignore file.
+
+
+* [Commands](#commands)
+  * [Check](#check)
+  * [List](#list)
+  * [Render](#render)
+  * [Vars](#vars)
+
+## Commands
+
+```
+$ bin/rndr help
+Commands:
+  rndr check           # Verifies discovered erb templates.
+  rndr help [COMMAND]  # Describe available commands or one specific command
+  rndr list            # List discovered templates.
+  rndr render          # Renders discovered templates.
+  rndr vars            # Lists Combined Variables.
+  rndr version         # Prints rndr Version Information.
+...
+```
+
+### Check
+
+```
+$ bin/rndr help check
+Usage:
+  rndr check
+
+Options:
+  e, [--extension=EXTENSION]  # Extension of templates.
+                              # Default: erb
+  i, [--ignore=IGNORE]        # Path to file containing list of files to be ignored.
+                              # Default: /Users/demo/ruby/rndr/.rndrignore
+  m, [--merge], [--no-merge]  # Recursively merge variables instead of replacing.
+                              # Default: true
+  t, [--template=TEMPLATE]    # Path to erb template or directory.
+                              # Default: /Users/demo/ruby/rndr/rndr
+  V, [--vars=VARS]            # Path to var file or directory.
+                              # Default: /Users/demo/ruby/rndr/vars
+
+Verifies discovered erb templates.
+```
+
+### List
+
+```
+$ bin/rndr help list
+Usage:
+  rndr list
+
+Options:
+  e, [--extension=EXTENSION]  # Extension of templates.
+                              # Default: erb
+  i, [--ignore=IGNORE]        # Path to file containing list of files to be ignored.
+                              # Default: /Users/demo/ruby/rndr/.rndrignore
+  t, [--template=TEMPLATE]    # Path to erb template or directory.
+                              # Default: /Users/demo/ruby/rndr/rndr
+
+List discovered templates.
+```
+
+### Render
+
+```
+$ bin/rndr help render
+Usage:
+  rndr render
+
+Options:
+  e, [--extension=EXTENSION]  # Extension of templates.
+                              # Default: erb
+  i, [--ignore=IGNORE]        # Path to file containing list of files to be ignored.
+                              # Default: /Users/demo/ruby/rndr/.rndrignore
+  m, [--merge], [--no-merge]  # Recursively merge variables instead of replacing.
+                              # Default: true
+  t, [--template=TEMPLATE]    # Path to erb template or directory.
+                              # Default: /Users/demo/ruby/rndr/rndr
+  V, [--vars=VARS]            # Path to var file or directory.
+                              # Default: /Users/demo/ruby/rndr/vars
+
+Renders discovered templates.
+```
+
+### Vars
+
+```
+$ bin/rndr help vars
+Usage:
+  rndr vars
+
+Options:
+  f, [--format=FORMAT]        # Output Format [yaml|json]
+                              # Default: yaml
+  m, [--merge], [--no-merge]  # Recursively merge variables instead of replacing.
+                              # Default: true
+  V, [--vars=VARS]            # Path to var file or directory.
+                              # Default: /Users/demo/ruby/rndr/vars
+
+Lists Combined Variables.
+```

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler/gem_tasks'
+require 'coveralls/rake/task'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+Coveralls::RakeTask.new
+
+task :default => :spec
+task :coveralls => [ :spec, :features, 'coveralls:push' ]

data/bin/rndr

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+
+Signal.trap('INT') { exit 1 }
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '../lib')
+require 'rndr'
+
+Rndr::CLI.start(ARGV)

data/lib/rndr.rb

@@ -0,0 +1,12 @@
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+
+# Rndr base module
+# @author Bob Killen <rkillen@umich.edu>
+
+module Rndr
+  require 'rndr/cli'
+  require 'rndr/template'
+  require 'rndr/util'
+  require 'rndr/version'
+end

data/lib/rndr/cli.rb

@@ -0,0 +1,125 @@
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+require 'thor'
+
+module Rndr
+  # Parent CLI controls for Rndr.
+  # @author Bob Killen <rkillen@umich.edu>
+  class CLI < Thor
+    desc 'check', 'Verifies discovered erb templates.'
+    method_option :extension,
+                  aliases: :e, type: :string, default: 'erb',
+                  desc: 'Extension of templates.'
+    method_option :ignore,
+                  aliases: :i, type: :string, default: File.join(Dir.pwd, '.rndrignore'),
+                  desc: 'Path to file containing list of files to be ignored.'
+    method_option :merge,
+                  aliases: :m, type: :boolean, default: true,
+                  desc: 'Recursively merge variables instead of replacing.'
+    method_option :template,
+                  aliases: :t, type: :string, default: Dir.pwd,
+                  desc: 'Path to erb template or directory.'
+    method_option :vars,
+                  aliases: :V, type: :string, default: File.join(Dir.pwd, 'vars'),
+                  desc: 'Path to var file or directory.'
+    def check
+      results = Rndr.matches(path: options[:template], ext: options[:extension],
+                             ignore_path: options[:ignore])
+      template_vars = Rndr.read_vars(path: options[:vars], merge: options[:merge])
+      results.each do |path|
+        template = Template.new(path: path, vars: template_vars)
+        print_check_result(path: path, result: template.render?)
+      end
+    end
+
+    desc 'list', 'List discovered templates.'
+    method_option :extension,
+                  aliases: :e, type: :string, default: 'erb',
+                  desc: 'Extension of templates.'
+    method_option :ignore,
+                  aliases: :i, type: :string, default: File.join(Dir.pwd, '.rndrignore'),
+                  desc: 'Path to file containing list of files to be ignored.'
+    method_option :template,
+                  aliases: :t, type: :string, default: Dir.pwd,
+                  desc: 'Path to erb template or directory.'
+    def list
+      results = Rndr.matches(path: options[:template], ext: options[:extension],
+                             ignore_path: '.rndrignore')
+      if results.empty?
+        puts 'No matching results.'
+      else
+        puts results
+      end
+    end
+
+    desc 'render', 'Renders discovered templates.'
+    method_option :extension,
+                  aliases: :e, type: :string, default: 'erb',
+                  desc: 'Extension of templates.'
+    method_option :ignore,
+                  aliases: :i, type: :string, default: File.join(Dir.pwd, '.rndrignore'),
+                  desc: 'Path to file containing list of files to be ignored.'
+    method_option :merge,
+                  aliases: :m, type: :boolean, default: true,
+                  desc: 'Recursively merge variables instead of replacing.'
+    method_option :template,
+                  aliases: :t, type: :string, default: Dir.pwd,
+                  desc: 'Path to erb template or directory.'
+    method_option :vars,
+                  aliases: :V, type: :string, default: File.join(Dir.pwd, 'vars'),
+                  desc: 'Path to var file or directory.'
+    def render
+      results = Rndr.matches(path: options[:template], ext: options[:extension],
+                             ignore_path: '.rndrignore')
+      template_vars = Rndr.read_vars(path: options[:vars], merge: options[:merge])
+      results.each do |path|
+        template = Template.new(path: path, vars: template_vars)
+        render_path = path.gsub(/.#{options[:extension]}$/, '')
+        template.render(render_path) if template.render?
+        print_check_result(path: render_path, result: template.render?)
+      end
+    end
+
+    desc 'vars', 'Lists Combined Variables.'
+    method_option :format,
+                  aliases: :f, type: :string, default: 'yaml',
+                  desc: 'Output Format [yaml|json]'
+    method_option :merge,
+                  aliases: :m, type: :boolean, default: true,
+                  desc: 'Recursively merge variables instead of replacing.'
+    method_option :vars,
+                  aliases: :V, type: :string, default: File.join(Dir.pwd, 'vars'),
+                  desc: 'Path to var file or directory.'
+    def vars
+      result = Rndr.read_vars(path: options[:vars], merge: options[:merge])
+      case options[:format].downcase
+      when 'json'
+        puts result.to_json
+      when 'yaml'
+        puts result.to_yaml
+      else
+        puts 'Invalid Format.'
+      end
+    end
+
+    desc 'version', 'Prints rndr Version Information.'
+    map %w(-v --version) => :version
+    def version
+      puts "Rndr Version: #{Rndr::VERSION}"
+    end
+
+    private
+
+    # print_check_result puts the results of an attempted Template.render? action.
+    # @param path [String] Path to template or rendered template.
+    # @param result [Boolean] True is successfully rendered template.
+    def print_check_result(path:, result:)
+      case result
+      when true
+        puts "#{path} [OK]"
+      when false
+        puts "#{path} [FAIL]"
+      end
+    end
+  end
+end

data/lib/rndr/template.rb

@@ -0,0 +1,48 @@
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+require 'erb'
+
+module Rndr
+  # This class is used to handle the rendering of `ERB` templates.
+  # @author Bob Killen <rkillen@umich.edu>
+  class Template
+    # Constructs a new instance of Template.
+    # @param path [String] The path to the template file.
+    # @param vars [Hash] A hash of the variables to be passed to the template's binding.
+    def initialize(path:, vars: {})
+      @path = File.absolute_path(path)
+      @vars = vars
+    end
+
+    # Verifies if a template is renderable or not.
+    # @return [Boolean]  True if template is renderable.
+    def render?
+      render_helper
+    end
+
+    # Renders the template to the supplied path.
+    # @param render_path [String] Path to desired rendered template location.
+    # @return [Boolean] True if template was rendered successfully.
+    def render(render_path)
+      render_helper(render_path)
+    end
+
+    private
+
+    # Does the heavy lifting of template generation.
+    # If no path is supplied, it simply tests if the template is renderable.
+    # @param render_path [String] Path to desired rendered template location.
+    # @return [Boolean] True if template is renderable, and rendered file written.
+    def render_helper(render_path = nil)
+      b = binding
+      @vars.each { |k, v| b.local_variable_set(k, v) }
+      rendered = ERB.new(File.read(@path)).result(b)
+      unless render_path.nil?
+        File.open(render_path, 'w') { |f| f.write(rendered) }
+      end
+      true
+    rescue
+      false
+    end
+  end
+end

data/lib/rndr/util.rb

@@ -0,0 +1,147 @@
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+require 'deep_merge'
+require 'json'
+require 'yaml'
+
+module Rndr
+  # Accepts a path (either file or directory), a file extension, and the name
+  # of a file within the working directory that contains a list of file glob
+  # patterns to be skipped. It returns an array of filtered matched paths.
+  # @param path [String] The path to the template file or directory.
+  # @param ext [String] The File name extension to identify template files.
+  # @param ignore_path [String] The path to ignore file.
+  # @return [Array<String>] list of paths to matching results.
+  def self.matches(path:, ext: 'erb', ignore_path: File.join(Dir.pwd, '.rndrignore'))
+    matched_paths = match_files(path: File.absolute_path(path), ext: ext)
+    ignore_file_path = File.absolute_path(ignore_path)
+    if !matched_paths.empty? && File.exist?(ignore_file_path)
+      return filter_ignored_paths(path_list: matched_paths, ignore_path: ignore_file_path)
+    else
+      return matched_paths
+    end
+  end
+
+  # Accepts a file or directory and will attempt to parse the discovered file(s) as either json
+  # or yaml. It will then be returned as a hash intended for use with seeding the binding used for
+  # template rendering in {Template#render}.
+  # @param path [String] The path to the vars file or directory. Will process both json and yaml.
+  # @param merge [Boolean] True to enable recursive merge of hashes.
+  # @return [Hash] A hash containing the processed variables. Will be used to send to the binding
+  #    of a rendered template. See {Template#render} for more information.
+  def self.read_vars(path:, merge: true)
+    vars_path = File.absolute_path(path)
+    return read_vars_file(vars_path) if File.file?(vars_path)
+    return read_vars_dir(path: vars_path, merge: merge) if File.directory?(vars_path)
+    {}
+  end
+
+  class << self
+    private
+
+    # @param path [String] Path to file or directory to test match condition.
+    # @param ext [String] The extension to use as the match condition.
+    # @return [Array<String>] Array of paths to matching files.
+    def match_files(path:, ext:)
+      return [path] if File.file?(path) && File.fnmatch("*#{ext}", path)
+      if File.directory?(path)
+        matched_paths = Dir["#{path}/**/*.#{ext}"]
+        matched_paths.reject! { |file| File.directory?(file) }
+        return matched_paths
+      end
+      []
+    end
+
+    # filter_ignored_paths removes paths from the supplied list if they match a
+    # path within the supplied ignore_path.
+    # @param path_list [Array<String>] Array of paths to matching files before prune
+    #    from ignore_path.
+    # @param ignore_path [String] Path to ignore file. Passed to @see #ignore_paths for
+    #    processing.
+    # @return [Array<String>] Pruned list of paths with files matching the glob patterns
+    #    in ignore_path removed.
+    def filter_ignored_paths(path_list:, ignore_path:)
+      ignored_paths = ignore_paths(ignore_path)
+      path_list.reject do |file|
+        ignored_paths.any? do |ignore|
+          File.fnmatch(ignore, file, File::FNM_PATHNAME)
+        end
+      end
+    end
+
+    # ignore_paths returns a list of paths used to filter possible discovered tempaltes
+    # that should be ignored.
+    # @param ignore_path [String] Path to ignore file.
+    # @return [Array<String>] Generated list of paths to be ignored.
+    def ignore_paths(ignore_path)
+      ignore_list = File.readlines(ignore_path)
+      ignore_list.map! { |line| line.chomp.strip }
+      ignore_list.reject! { |line| line.empty? || line =~ /^(#|!)/ }
+      ignore_list.map! { |line| File.absolute_path(line, File.dirname(ignore_path)) }
+      ignore_list
+    end
+
+    # read_vars_file reads the data stored in file as supplied by path. processed_vars
+    # json or yaml
+    # @param path [String] Path to file with variables to be processed.
+    # @return [Hash, nil] Hash of processed data read from var passed var file.
+    def read_vars_file(path)
+      data = File.read(path)
+      return JSON.load(data) if json?(data)
+      return YAML.load(data) if yaml?(data)
+      nil
+    end
+
+    # read_vars_dir combines all the variables within a supplied directory. It can injest
+    # json or yaml.
+    # @param path [String] Path to directory containing files to be ingested and vars
+    #    processed.
+    # @param merge [Boolean] True if variables from files should be recursively merged.
+    # @return [Hash] Hash of processed variables read from files within the passed.
+    def read_vars_dir(path:, merge:)
+      processed_vars = {}
+      Dir[File.join(path, '*')].each do |file|
+        file_vars = read_vars_file(file)
+        unless file_vars.nil?
+          processed_vars =
+            merge_vars(base_hash: processed_vars, hash: file_vars, merge: merge)
+        end
+      end
+      processed_vars
+    end
+
+    # json? tests if the supplied json is parsable or not.
+    # @param data [String] String containing read data from file.
+    # @return [Boolean] True if data is valid json.
+    def json?(data)
+      JSON.parse(data)
+      true
+    rescue
+      false
+    end
+
+    # yaml? tests if the supplied yaml is parsable or not.
+    # @param data [String] String containing read data from file.
+    # @return [Boolean] True if data is valid yaml.
+    def yaml?(data)
+      YAML.load(data)
+      true
+    rescue
+      false
+    end
+
+    # merge_vars handles merging hashes, either with a recursive merge (default) or with
+    # a standard merge, which has a 'replace' effect.
+    # @param base_hash [Hash] Original Hash to have values merged into.
+    # @param hash [Hash] Secondary hash to be merged into base hash.
+    # @param merge [Boolean] True to enable recursive merging of hashes.
+    # @return [Hash] The merged hash.
+    def merge_vars(base_hash:, hash:, merge: true)
+      if base_hash.is_a?(Hash) && hash.is_a?(Hash)
+        return base_hash.deep_merge!(hash) if merge == true
+        return base_hash.merge!(hash) if merge == false
+      end
+      {}
+    end
+  end
+end

data/lib/rndr/version.rb

@@ -0,0 +1,8 @@
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+
+module Rndr
+  VERSION = File.read(
+    File.expand_path('../../../version.txt', __FILE__)
+  ).chomp
+end

data/rndr.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'rndr/version'
+
+Gem::Specification.new do |gem|
+  gem.name            = 'rndr'
+  gem.version         = Rndr::VERSION
+  gem.authors         = ['Bob Killen']
+  gem.homepage        = 'https://github.com/arc-ts/rndr'
+  gem.email           = ['arcts-dev@umich.edu']
+  gem.license         = 'MIT'
+  gem.summary         = 'Render Ruby templates quickly and easily.'
+  gem.description     = 'rndr is a tool that simply renders Ruby erb ' \
+                        'templates for use with other applications.'
+  gem.files           = `git ls-files`.split($INPUT_RECORD_SEPARATOR)
+  gem.executables     = gem.files.grep(%r{^bin/}).map { |f| File.basename(f) }
+  gem.require_paths   = ['lib']
+
+  gem.required_ruby_version = '>= 2.3'
+
+  gem.add_dependency 'deep_merge', '>= 1.1.1'
+  gem.add_dependency 'thor', '>= 0.19.1'
+
+  gem.add_development_dependency 'bundler', '>= 1.12.5'
+  gem.add_development_dependency 'rake', '>= 11.2.2'
+  gem.add_development_dependency 'rspec', '>= 3.5.0'
+  gem.add_development_dependency 'coveralls', '>= 0.8.15'
+end

data/spec/cli_spec.rb

@@ -0,0 +1,172 @@
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+
+require 'fileutils'
+require 'rndr'
+require_relative 'spec_helper'
+
+module Rndr # rubocop:disable Metris/ModuleLength
+  RSpec.describe CLI do
+    before(:all) { Dir.chdir(File.join(Dir.pwd, 'test')) }
+    after(:all) { Dir.chdir('../') }
+
+    let(:cli) { CLI.new }
+
+    describe '#check' do
+      context 'When the default options are supplied' do
+        before do
+          cli.options = {
+            extension: 'erb', ignore: '.rndrignore',
+            merge: true, template: 'templates', vars: 'vars'
+          }
+        end
+        it 'should list the correctly matched results' do
+          expect { cli.check }.to output(/rendertest.txt.erb \[OK\]$/).to_stdout
+          expect { cli.check }.to_not output(/ignoretest.txt.erb [OK]$/).to_stdout
+        end
+      end
+
+      context 'When an alternate exntesion is provided' do
+        before do
+          cli.options = {
+            extension: 'tmplt', ignore: '.rndrignore',
+            merge: true, template: 'templates', vars: 'vars'
+          }
+        end
+        it 'should list the correctly matched results' do
+          expect { cli.check }.to output(/exttest.txt.tmplt \[OK\]$/).to_stdout
+          expect { cli.check }.to_not output(/.erb/).to_stdout
+        end
+      end
+    end
+
+    describe '#list' do
+      context 'When the default options are supplied' do
+        before { cli.options = { extension: 'erb', ignore: '.rndrignore', template: 'templates' } }
+        it 'should list the correctly matched results' do
+          expect { cli.list }.to output(/rendertest.txt.erb$/).to_stdout
+          expect { cli.list }.to_not output(/ignoretest.txt.erb/).to_stdout
+        end
+      end
+      context 'When an alternate extension is provided' do
+        before do
+          cli.options = { extension: 'tmplt', ignore: '.rndrignore', template: 'templates' }
+        end
+        it 'should list the correctly matched results' do
+          expect { cli.list }.to output(/exttest.txt.tmplt$/).to_stdout
+          expect { cli.list }.to_not output(/.erb/).to_stdout
+        end
+      end
+    end
+
+    describe '#render' do
+      let(:rendered_file) { File.absolute_path('../test/templates/rendertest.txt') }
+      let(:rendered_ext) { File.absolute_path('../test/templates/exttest.txt') }
+      let(:rendered_merged) do
+        File.join(File.dirname(__FILE__), 'resources/rendered_merged.txt')
+      end
+      let(:rendered_replaced) do
+        File.join(File.dirname(__FILE__), 'resources/rendered_replaced.txt')
+      end
+      after(:each) do
+        File.delete(rendered_file) if File.exist?(rendered_file)
+        File.delete(rendered_ext) if File.exist?(rendered_ext)
+      end
+
+      context 'When the defaults are spplied' do
+        before do
+          cli.options = {
+            extension: 'erb', ignore: '.rndrignore',
+            merge: true, template: 'templates', vars: 'vars'
+          }
+        end
+        it 'should render items correctly' do
+          expect { cli.render }.to output(/rendertest.txt \[OK\]$/).to_stdout
+          expect { cli.render }.to_not output(/ignoretest.txt/).to_stdout
+          expect(FileUtils.compare_file(rendered_merged, rendered_file)).to be_truthy
+        end
+      end
+
+      context ' When the replace merege strategy is specified' do
+        before do
+          cli.options = {
+            extension: 'erb', ignore: '.rndrignore',
+            merge: false, template: 'templates', vars: 'vars'
+          }
+        end
+        it 'should render items correctly' do
+          expect { cli.render }.to output(/rendertest.txt \[OK\]$/).to_stdout
+          expect { cli.render }.to_not output(/ignoretest.txt/).to_stdout
+          expect(FileUtils.compare_file(rendered_replaced, rendered_file)).to be_truthy
+        end
+      end
+
+      context 'When provided an alternate extension' do
+        before do
+          cli.options = {
+            extension: 'tmplt', ignore: '.rndrignore',
+            merge: true, template: 'templates', vars: 'vars'
+          }
+        end
+        it 'should render items correctly' do
+          expect { cli.render }.to output(/exttest.txt \[OK\]$/).to_stdout
+          expect { cli.render }.to_not output(/rendertest.txt/).to_stdout
+          expect(FileUtils.compare_file(rendered_merged, rendered_ext)).to be_truthy
+        end
+      end
+    end
+
+    describe '#vars' do
+      context 'When a directory is supplied.' do
+        context 'should serialize and recursively merge variables' do
+          before do
+            cli.options = { format: 'yaml', merge: true, vars: 'vars' }
+            @merged =
+              File.read(File.join(File.dirname(__FILE__), 'resources/vars_merged.txt'))
+          end
+          it 'should perform a deep merge' do
+            expect { cli.vars }.to output(@merged).to_stdout
+          end
+        end
+
+        context 'should serialize and merge variables with replace behaviour' do
+          before do
+            cli.options = { format: 'yaml', merge: false, vars: 'vars' }
+            @replaced =
+              File.read(File.join(File.dirname(__FILE__), 'resources/vars_replaced.txt'))
+          end
+          it 'should perform a standard merge' do
+            expect { cli.vars }.to output(@replaced).to_stdout
+          end
+        end
+      end
+
+      context 'When a json file is supplied' do
+        before do
+          cli.options = { format: 'yaml', merge: true, vars: 'vars/a.json' }
+          @vars =
+            File.read(File.join(File.dirname(__FILE__), 'resources/vars_a.txt'))
+        end
+        it 'should serialize the data' do
+          expect { cli.vars }.to output(@vars).to_stdout
+        end
+      end
+      context 'When a yaml file is supplied' do
+        before do
+          cli.options = { format: 'yaml', merge: true, vars: 'vars/b.yaml' }
+          @vars =
+            File.read(File.join(File.dirname(__FILE__), 'resources/vars_b.txt'))
+        end
+        it 'should serialize the data' do
+          expect { cli.vars }.to output(@vars).to_stdout
+        end
+      end
+    end
+
+    context '#version' do
+      it 'should print the version string' do
+        expect { cli.version }.to output(/Rndr Version: #{VERSION}$/).to_stdout
+      end
+    end
+  end
+end

data/spec/resources/rendered_merged.txt

@@ -0,0 +1,17 @@
+---
+child:
+  childarray:
+  - arraykey1: arrayval1
+  - arraykey2: arrayval2
+  - arraykey3: arrayval3
+  - arraykey4: arrayval4
+  childhash:
+    childhashkey1: childhashval1
+    childhashkey2: childhashval2
+    childhashkey3: childhashval3
+    childhashkey4: childhashval4
+
+
+{"boolkey":false,"numkey":2}
+
+parent3: mergeval

data/spec/resources/rendered_replaced.txt

@@ -0,0 +1,13 @@
+---
+child:
+  childarray:
+  - arraykey3: arrayval3
+  - arraykey4: arrayval4
+  childhash:
+    childhashkey3: childhashval3
+    childhashkey4: childhashval4
+
+
+{"boolkey":false,"numkey":2}
+
+parent3: mergeval

data/spec/resources/vars_a.txt

@@ -0,0 +1,14 @@
+---
+parent1:
+  child:
+    childarray:
+    - arraykey1: arrayval1
+    - arraykey2: arrayval2
+    childhash:
+      childhashkey1: childhashval1
+      childhashkey2: childhashval2
+parent2:
+  boolkey: true
+  numkey: 1
+parent3:
+  mergetest: mergeval

data/spec/resources/vars_b.txt

@@ -0,0 +1,12 @@
+---
+parent1:
+  child:
+    childarray:
+    - arraykey3: arrayval3
+    - arraykey4: arrayval4
+    childhash:
+      childhashkey3: childhashval3
+      childhashkey4: childhashval4
+parent2:
+  boolkey: false
+  numkey: 2

data/spec/resources/vars_merged.txt

@@ -0,0 +1,18 @@
+---
+parent1:
+  child:
+    childarray:
+    - arraykey1: arrayval1
+    - arraykey2: arrayval2
+    - arraykey3: arrayval3
+    - arraykey4: arrayval4
+    childhash:
+      childhashkey1: childhashval1
+      childhashkey2: childhashval2
+      childhashkey3: childhashval3
+      childhashkey4: childhashval4
+parent2:
+  boolkey: false
+  numkey: 2
+parent3:
+  mergetest: mergeval

data/spec/resources/vars_replaced.txt

@@ -0,0 +1,14 @@
+---
+parent1:
+  child:
+    childarray:
+    - arraykey3: arrayval3
+    - arraykey4: arrayval4
+    childhash:
+      childhashkey3: childhashval3
+      childhashkey4: childhashval4
+parent2:
+  boolkey: false
+  numkey: 2
+parent3:
+  mergetest: mergeval

data/spec/spec_helper.rb

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+
+require 'rspec'
+
+if ENV['CI']
+  require 'coveralls'
+  Coveralls.wear!
+end
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+  config.disable_monkey_patching!
+  config.warnings = true
+#  config.formatter = 'documentation' unless defined? config.formatter
+end

data/spec/template_spec.rb

@@ -0,0 +1,61 @@
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+
+require 'rndr'
+require 'yaml'
+require_relative 'spec_helper'
+
+module Rndr
+  RSpec.describe Template do
+    before(:all) do
+      Dir.chdir(File.join(Dir.pwd, 'test'))
+      @success_tmplt = File.absolute_path('templates/rendertest.txt.erb')
+      @fail_tmplt = File.absolute_path('templates/failtest.txt.erb')
+      @rendered_success = File.absolute_path('templates/rendertest.txt')
+      @rendered_fail = File.absolute_path('templates/failtest.txt')
+      @compare_success = File.join(File.dirname(__FILE__), 'resources/rendered_merged.txt')
+      @vars =
+        YAML.load(File.read(File.join(File.dirname(__FILE__), 'resources/vars_merged.txt')))
+    end
+    after(:all) do
+      Dir.chdir('../')
+      File.delete(@rendered_success) if File.exist?(@rendered_success)
+      File.delete(@rendered_fail) if File.exist?(@rendered_fail)
+    end
+
+    describe '#render?' do
+      describe 'When the template is renderable' do
+        subject { Template.new(path: @success_tmplt, vars: @vars).render? }
+        it { is_expected.to be_truthy }
+      end
+
+      describe 'When the template is not renderable' do
+        subject { Template.new(path: @fail_tmplt, vars: @vars).render? }
+        it { is_expected.to be_falsey }
+      end
+    end
+
+    describe '#render' do
+      context 'When the template is renderable' do
+        before(:all) { File.delete(@rendered_success) if File.exist?(@rendered_success) }
+        subject { Template.new(path: @success_tmplt, vars: @vars).render(@rendered_success) }
+        it { is_expected.to be_truthy }
+        it 'should render file' do
+          expect(File.exist?(@rendered_success)).to be_truthy
+        end
+        it 'should render contents correctly' do
+          expect(FileUtils.compare_file(@rendered_success, @compare_success)).to be_truthy
+        end
+      end
+
+      context 'When the template is not renderable' do
+        before(:all) { File.delete(@rendered_fail) if File.exist?(@rendered_fail) }
+        subject { Template.new(path: @fail_tmplt, vars: @vars).render(@rendered_fail) }
+        it { is_expected.to be_falsey }
+        it 'should not render file' do
+          expect(File.exist?(@rendered_fail)).to be_falsey
+        end
+      end
+    end
+  end
+end

data/spec/util_spec.rb

@@ -0,0 +1,82 @@
+# -*- encoding: utf-8 -*-
+# frozen_string_literal: true
+
+require 'json'
+require 'rndr'
+require 'rspec'
+require 'yaml'
+require_relative 'spec_helper'
+
+module Rndr
+  RSpec.describe Rndr do
+    before(:all) { Dir.chdir(File.join(Dir.pwd, 'test')) }
+    after(:all) { Dir.chdir('../') }
+
+    describe '#matches' do
+      context 'When using the defaults' do
+        let(:matched) { [File.absolute_path('templates/rendertest.txt.erb')] }
+        let(:ignored) do
+          [File.absolute_path('templates/ignoretest.txt.erb'),
+           File.absolute_path('templates/failtest.txt.erb')]
+        end
+        subject(:results) { Rndr.matches(path: 'templates') }
+        it 'should be an Array of filtered paths with default extension' do
+          expect(results).to be_a(Array)
+          expect(results).to match_array(matched)
+        end
+      end
+
+      context 'When using an alternate extension' do
+        let(:matched) { [File.absolute_path('templates/exttest.txt.tmplt')] }
+        let(:ignored) do
+          [File.absolute_path('templates/ignoretest.txt.erb'),
+           File.absolute_path('templates/failtest.txt.erb')]
+        end
+        subject(:results) { Rndr.matches(path: 'templates', ext: 'tmplt') }
+        it 'should be an Array of paths with alternate extension' do
+          expect(results).to be_a(Array)
+          expect(results).to match_array(matched)
+        end
+      end
+    end
+
+    describe '#read_vars' do
+      context 'When a directory is supplied' do
+        context 'should serialize and recursively merges variables' do
+          let(:results) do
+            YAML.load(File.read(File.join(File.dirname(__FILE__), 'resources/vars_merged.txt')))
+          end
+          subject(:vars) { Rndr.read_vars(path: 'vars', merge: true) }
+          it 'should perform a deep merge' do
+            expect(vars).to eql(results)
+          end
+        end
+        context 'should serialize and merge variables with replace behaviour' do
+          let(:results) do
+            YAML.load(File.read(File.join(File.dirname(__FILE__), 'resources/vars_replaced.txt')))
+          end
+          subject(:vars) { Rndr.read_vars(path: 'vars', merge: false) }
+          it 'should perform a standard merge' do
+            expect(vars).to eql(results)
+          end
+        end
+      end
+
+      context 'When a json file is supplied' do
+        let(:results) { JSON.load(File.read('vars/a.json')) }
+        subject(:vars) { Rndr.read_vars(path: 'vars/a.json', merge: true) }
+        it 'should serialize the data' do
+          expect(vars).to eql(results)
+        end
+      end
+
+      context 'When a yaml file is supplied' do
+        let(:results) { YAML.load(File.read('vars/b.yaml')) }
+        subject(:vars) { Rndr.read_vars(path: 'vars/b.yaml', merge: true) }
+        it 'should serialize the data' do
+          expect(vars).to eql(results)
+        end
+      end
+    end
+  end
+end

data/test/.rndrignore

@@ -0,0 +1,3 @@
+#i r ignored
+templates/ignoretest.txt.erb
+templates/failtest.txt.erb

data/test/templates/exttest.txt.tmplt

@@ -0,0 +1,5 @@
+<%= parent1.to_yaml %>
+
+<%= parent2.to_json %>
+
+parent3: <%= parent3['mergetest'] %>

data/test/templates/failtest.txt.erb

@@ -0,0 +1,5 @@
+<%= nope.to_yaml %>
+
+<%= nope2.to_json %>
+
+parent3: <%= nope['itall'] %>

data/test/templates/rendertest.txt.erb

@@ -0,0 +1,5 @@
+<%= parent1.to_yaml %>
+
+<%= parent2.to_json %>
+
+parent3: <%= parent3['mergetest'] %>

data/test/vars/a.json

@@ -0,0 +1,22 @@
+{
+  "parent1": {
+    "child": {
+      "childarray": [{
+        "arraykey1": "arrayval1"
+      }, {
+        "arraykey2": "arrayval2"
+      }],
+      "childhash": {
+        "childhashkey1": "childhashval1",
+        "childhashkey2": "childhashval2"
+      }
+    }
+  },
+  "parent2": {
+    "boolkey": true,
+    "numkey": 1
+  },
+  "parent3": {
+    "mergetest": "mergeval"
+  }
+}

data/test/vars/b.yaml

@@ -0,0 +1,13 @@
+---
+parent1:
+  child:
+    childarray:
+    - arraykey3: arrayval3
+    - arraykey4: arrayval4
+    childhash:
+      childhashkey3: childhashval3
+      childhashkey4: childhashval4
+parent2:
+  boolkey: false
+  numkey: 2
+

data/version.txt

@@ -0,0 +1 @@
+0.0.2

metadata

@@ -0,0 +1,163 @@
+--- !ruby/object:Gem::Specification
+name: rndr
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Bob Killen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-11-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: deep_merge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.1
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.12.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.12.5
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 11.2.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 11.2.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.15
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.15
+description: rndr is a tool that simply renders Ruby erb templates for use with other
+  applications.
+email:
+- arcts-dev@umich.edu
+executables:
+- rndr
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- ".yardopts"
+- Gemfile
+- README.md
+- Rakefile
+- bin/rndr
+- lib/rndr.rb
+- lib/rndr/cli.rb
+- lib/rndr/template.rb
+- lib/rndr/util.rb
+- lib/rndr/version.rb
+- rndr.gemspec
+- spec/cli_spec.rb
+- spec/resources/rendered_merged.txt
+- spec/resources/rendered_replaced.txt
+- spec/resources/vars_a.txt
+- spec/resources/vars_b.txt
+- spec/resources/vars_merged.txt
+- spec/resources/vars_replaced.txt
+- spec/spec_helper.rb
+- spec/template_spec.rb
+- spec/util_spec.rb
+- test/.rndrignore
+- test/templates/exttest.txt.tmplt
+- test/templates/failtest.txt.erb
+- test/templates/ignoretest.txt.erb
+- test/templates/rendertest.txt.erb
+- test/vars/a.json
+- test/vars/b.yaml
+- version.txt
+homepage: https://github.com/arc-ts/rndr
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Render Ruby templates quickly and easily.
+test_files: []