aws-must 0.0.13 → 0.0.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4df0abe6aafa2e3145f9995eee51a1b4f4a6bf9c
-  data.tar.gz: daa5ad0f99ff4a785fd664cba698cda7e79d540c
+  metadata.gz: ef1ec5cf98ec249bc3e9be5ece8c0c7d4688f987
+  data.tar.gz: 5433b3272b9c497981c4ada810e52701bc4f5ef4
 SHA512:
-  metadata.gz: 48346e91b649bd279a2966bb6dde84a6ee11bd251e181e8b96bb7cd628519aba8f58dfe8a3f9b370268a02c2302f16261ec1ce9d94da30976f1bed367f0817b2
-  data.tar.gz: 5710ab165795472d962d85f28b3bdbf148f1a17cf9146f6fef18a5da67c9b26e3191e830fd6a1ce5e3d9c2fbeeec2cd615a68773674ab898eb30d6472c8d81ca
+  metadata.gz: c1decbdc3b13c2cf84603a916b7e2ed42768b54a7e81ef902ee7639cc2419829bf0901d4cf7c7842ec1110146fe649ac10e6f2e243fd1925934cd9b92b91509c
+  data.tar.gz: bc5bd0f0664d9ec1b32dc9e6394f1dee496978c584f7484fc9ffb8250baf5b5986325b64e73d682d334d3dab07b7681951ad3b8f7316ab5f3bb769d13753cf56

data/README.md

@@ -1,4 +1,4 @@
-# aws-must - Minimum Viable Solution to Manage CloudFormation Templates - $Release:0.0.13$
+# aws-must - Minimum Viable Solution to Manage CloudFormation Templates - $Release:0.0.14$
 
 `aws-must` is a tool, which allows separating infrastructure
 configuration and Amazon related syntax in CloudFormation JSON

data/bin/aws-must.rb

@@ -1,308 +1,5 @@
 #!/usr/bin/env ruby
 
-
-require 'thor'
-require_relative '../lib/aws-must'
-
-class App < Thor
-
-  include Utils::MyLogger     # mix logger
-  PROGNAME = "main"           # logger progname
-
-  # default values
-
-  DEAFAULT_TEMPLATE="root"    # name of template in :template_path -directory
-
-  # DEFAUL_FOLD_ON="<!--*SED-MAGIC* <div class=window> -->"     # default output for +++fold-on+++ tag
-  # DEFAUL_FOLD_OFF="<!--*SED-MAGIC* </div>  -->"               # default output for +++fold-off+++ tag
-
-  # default output for +++fold-on+++ tag
-  DEFAUL_FOLD_ON="<div class='fold'>Check to show template: <input type='checkbox' class='toggle'/><div>"
-  DEFAUL_FOLD_OFF="</div></div>"                # default output for +++fold-off+++ tag
-
-  # ------------------------------------------------------------------
-  # make two thor tasks share options?
-  # http://stackoverflow.com/questions/14346285/how-to-make-two-thor-tasks-share-options
-
-  class << self
-    def add_shared_option(name, options = {})
-      @shared_options = {} if @shared_options.nil?
-      @shared_options[name] =  options
-    end
-
-    def shared_options(*option_names)
-      option_names.each do |option_name|
-        opt =  @shared_options[option_name]
-        raise "Tried to access shared option '#{option_name}' but it was not previously defined" if opt.nil?
-        option option_name, opt
-      end
-    end
-  end
-
-  def initialize(*args)
-    super
-    @logger = getLogger( PROGNAME, options )
-  end
-
-  # ------------------------------------------------------------------
-
-  class_option :log, :aliases => "-l", :type =>:string, :default => nil, 
-  :enum => [ "DEBUG", "INFO", "WARN", "ERROR" ],
-  :desc => "Set debug level "
-
-
-  # ------------------------------------------------------------------
-  add_shared_option :template_gem, :aliases => "-g", :type => :string,
-  :desc => "Mustache template Gem name (optionally with version constraint e.g. 'aws-must-templates,~>0.0.1') (DEPRECATED)"
-
-  add_shared_option :template_path, :aliases => "-t", :type =>
-  :string, :desc => "Directory holding mustache templates (DEPRECATED)"
-
-  add_shared_option :mustaches, :aliases => "-m", :type =>
-  :array, :default =>  [ "mustache/"], 
-  :desc => "Array of directory paths (ending with slash '/' char e.g. 'mustache/') of Gem names (optionally with version constraint e.g. 'aws-must-templates,~>0.0.1') holding mustache templates"
-
-  # ------------------------------------------------------------------
-  # action 'doc'
-
-  desc "doc", "Extract template documentation"
-
-  shared_options :template_path
-  shared_options :mustaches
-  shared_options :template_gem
-
-  option :fold_on, :aliases => "-n", :type => :string, 
-  :default => DEFAUL_FOLD_ON, 
-  :desc => "Output for +++fold-on+++ tag"
-
-  option :fold_off, :aliases => "-f", :type => :string, 
-  :default => DEFAUL_FOLD_OFF, 
-  :desc => "Output for +++fold-off+++ tag"
-
-  long_desc <<-LONGDESC
-
-  Extract documation from <template_name> in ':template_path' -directory.
-
-  <template_name> defaults to '#{DEAFAULT_TEMPLATE}'
-
-
-  Documentation is extracted from lines surrounded by #{AwsMust::Docu::DEFAULT_OPEN_TAG} and #{AwsMust::Docu::DEFAULT_CLOSE_TAG} tags,
-  or by  #{AwsMust::Docu::DEFAULT_FOLD_ON_TAG} and  #{AwsMust::Docu::DEFAULT_FOLD_OFF_TAG} tags. 
-
-  Following rules apply:
-
-  - #{AwsMust::Docu::DEFAULT_OPEN_TAG},  #{AwsMust::Docu::DEFAULT_CLOSE_TAG} -tags: nothing is outputted for these lines
-
-  - #{AwsMust::Docu::DEFAULT_FOLD_ON_TAG} -tag: output text for --fold_on option (defaults '#{DEFAUL_FOLD_ON}')
-
-  - #{AwsMust::Docu::DEFAULT_FOLD_OFF_TAG} -tag: output text for --fold_off option (defaults '#{DEFAUL_FOLD_OFF}')
-
-
-  Defult fold_on and fold_off parameters implement CCS-toggle when using following css-code
-
-          /* CSS-support fold-on/fold-off toggle */\n
-          div.fold { width: 90%; padding: .42rem; border-radius: 5px;  margin: 1rem; }\n
-          div.fold div { height: 0px; margin: .2rem; overflow: hidden; }\n
-          div.toggle ~ div { height: 0px; margin: .2rem; overflow: hidden; }\n
-          input.toggle:checked ~ div { height: auto;color: white; background: #c6a24b;font-family: monospace;white-space: pre; }\n
-
-
-LONGDESC
-
-  def doc( template_name=DEAFAULT_TEMPLATE )
-
-    @logger.info( "#{__method__} starting" )
-
-    
-    my_options = option_adjust_common( options )
-
-    app = ::AwsMust::AwsMust.new( my_options )
-    app.doc( template_name )
-
-  end
-
-  # ------------------------------------------------------------------
-  # action 'json'
-
-  desc "json <yaml_file> [with_adjust]", "Dump configuration in JSON format (with or without adjustment)"
-
-  long_desc <<-LONGDESC
-
-  Reads <yaml_file> and dumps it to stdout in JSON format
-  'with_adjust' (yes/no)
-
-  By default 'adjusts' data, i.e. adds property "_comma" with the
-  value "," to each sub document, expect the last sub-document is
-  adjusted with empty string "".
-
-  The "_comma" -property helps in generating valid json arrays in
-  mustache templates. For example, YAML construct
-
-    tags:
-       - Key: key1
-         Value: value1
-
-       - Key: key2
-         Value: value2
-
-  and Mustache template snippet
-
-  { "Tags" : [ 
-       {{#tags}}
-           { "Key" : "{{Key}}",  "Value" : "{{Value}}"{{_comma}} }
-       {{/tags}} 
-  ]}
-
-  results to valid JSON document
-
-  { "Tags" : [ 
-           { "Key" : "key1",  "Value" : "value1", 
-           { "Key" : "key2",  "Value" : "value2"
-  ]}
-
-LONGDESC
-
-
-  def json( yaml_file, with_adjust="true" )
-
-    app = ::AwsMust::AwsMust.new( options )
-    app.json( yaml_file, with_adjust =~ /^true$/ || with_adjust =~ /^yes$/  ? true : false  )
-
-  end
-
-
-  # ------------------------------------------------------------------
-  # action 'gen'
-
-  desc "gen <yaml_file> [<template_name>]", "Generate CloudFormation JSON template"
-
-  shared_options :template_path
-  shared_options :mustaches
-  shared_options :template_gem
-
-  long_desc <<-LONGDESC
-
-  Generate Amazon CloudFormation JSON file for <yaml_file> using
-  <template_name> in ':template_path' -directory.
-
-  <template_name> defaults to '#{DEAFAULT_TEMPLATE}'
-
-LONGDESC
-
-
-  def gen( yaml_file, template_name=DEAFAULT_TEMPLATE )
-
-    my_options = option_adjust_common( options )
-
-    app = ::AwsMust::AwsMust.new( my_options )
-    app.generate( template_name, yaml_file, my_options )
-
-  end
-
-  # ------------------------------------------------------------------
-  # common routines
-  no_commands do
-
-    def option_adjust_common( options ) 
-
-      raise "No optios given" unless options
-
-      # options readonly - dup allows modification
-      options = options.dup
-
-      @logger.debug( "#{__method__}, options '#{options}'" )
-
-      options = option_template_gem_to_template_path( options )  if options[:template_gem]
-      options = option_template_path( options )  if options[:template_path]
-
-      warn <<-EOS   unless options[:mustaches] && options[:mustaches].any?
-
-      Deprecation!!
-
-           Use option -m to define location of templates
-
-           Options -g and -t deprecated
-      EOS
-
-      options = option_mustaches_to_template_paths( options )  if options[:mustaches]
-      
-      return options
-    end
-
-    # set `options[:template_path]` to an array of local directory
-    # paths parsed from list of options[:mustaches]
-    def option_mustaches_to_template_paths( options ) 
-
-      # init, NB: plural
-      options[:template_paths] = []
-
-      options[:mustaches].each do |mustache_def|
-        if mustache_def[-1] == '/' then
-          # directory with last char removed
-          options[:template_paths] << mustache_def[0..-1]
-        else
-          # gemname 
-          options[:template_paths] << gem_name_to_template_path( mustache_def )
-        end
-          
-      end
-      return options
-    end
-
-    # overrides -m option
-    def option_template_path( options ) 
-      # overrides -m option
-      options[:mustaches] = []
-      return options
-    end
-
-    # set 'options[:template_path]' to mustache directory withing
-    # `options[:template_gem]` Gem
-    def option_template_gem_to_template_path( options ) 
-
-      # overrides -m option
-      options[:mustaches] = []
-
-      options[:template_path] = gem_name_to_template_path( options[:template_gem] )
-      
-      return options
-
-    end
-
-    # map 'gem_name_and_spec' to path of mustache templates
-    def gem_name_to_template_path( gem_name_and_spec ) 
-
-      # The version requirements are optional.
-      # You can also specify multiple version requirements, just append more at the end
-      gem_spec = gem_name_and_spec.split(',')
-      gem_name, *gem_ver_reqs = gem_spec[0], gem_spec[1]
-      @logger.debug( "#{__method__}, gem_name=#{gem_name}, *gem_ver_reqs=#{gem_ver_reqs}" )
-      gdep = Gem::Dependency.new(gem_name, *gem_ver_reqs)
-      # find latest that satisifies
-      found_gspec = gdep.matching_specs.sort_by(&:version).last
-      @logger.debug( "#{__method__}, found_gspec=#{found_gspec}" )
-      # instead of using Gem::Dependency, you can also do:
-      # Gem::Specification.find_all_by_name(gem_name, *gem_ver_reqs)
-
-      if found_gspec
-        @logger.debug( "#{__method__}, Requirement '#{gdep}' already satisfied by #{found_gspec.name}-#{found_gspec.version}" )
-        @logger.debug( "#{__method__}, old-options=#{options}" )
-        template_path = "#{found_gspec.gem_dir}/mustache"
-        @logger.debug( "#{__method__}, template_path=#{template_path}" )
-      else
-        #puts "Requirement '#{gdep}' not satisfied; installing..."
-        # ver_args = gdep.requirements_list.map{|s| ['-v', s] }.flatten
-        # # multi-arg is safer, to avoid injection attacks
-        # system('gem', 'install', gem_name, *ver_args)
-        raise "Could not find gem '#{gdep}' - try 'gem install #{gdep}'"
-      end
-      
-      return template_path
-
-    end
-    
-  end # no commands
-
-end
+require_relative "../lib/cli/aws-must-cli"
 
 App.start

data/lib/aws-must.rb

@@ -5,6 +5,7 @@ module AwsMust
   require_relative 'aws-must/aws-must'
   require_relative 'aws-must/template'
   require_relative 'aws-must/docu'
+  require_relative 'aws-must/fileprovider'
 
 end 
 

data/lib/aws-must/aws-must.rb

@@ -56,13 +56,15 @@ module AwsMust
     end
 
     # ------------------------------------------------------------------
-    # generate JSON by rendering 'template_name' using configurations
+    # output result of rendering 'template_name' using configurations
     # from 'yaml_file'
 
     def generate( template_name, yaml_file, options ) 
       puts generate_str( template_name, yaml_file, options )
     end
 
+    # return the result of rendering 'template_name' using
+    # configurations from 'yaml_file' as a string
     def generate_str( template_name, yaml_file, options ) 
 
       @logger.debug( "#{__method__}, template_name '#{template_name}'" )

data/lib/aws-must/docu.rb

@@ -61,7 +61,7 @@ module AwsMust
 
     def document( template_name )
 
-      @logger.debug( "#{__method__}, template_name '#{template_name}'" )
+      @logger.info( "#{__method__}, template_name '#{template_name}'" )
       
       # 
       template_string = @template.get_template( template_name )
@@ -81,6 +81,7 @@ module AwsMust
           if open_found then
 
             state_opened = true
+            @logger.info( "#{__method__}, open tag in '#{template_name}'" )
             
             # something follows the start -tag
             redo if line && ! line.empty?
@@ -95,9 +96,11 @@ module AwsMust
           # puts "close_found=#{close_found}, #{close_found.class}, line=#{line}"
           if  close_found then
             output( line_pre ) if line_pre && !line_pre.empty?
+            @logger.info( "#{__method__}, close tag in '#{template_name}'" )
             state_opened = false
             redo if line && ! line.empty?
           elsif template_name = directive_include( line ) then
+            @logger.info( "#{__method__}, include in '#{template_name}'" )
             document( template_name )
           else
             output( line )
@@ -112,7 +115,6 @@ module AwsMust
     # output - document output
 
     def output( line )
-
       puts( line ) 
     end
 

data/lib/aws-must/fileprovider.rb

@@ -0,0 +1,13 @@
+module AwsMust
+
+  # allow Docu class to access files 
+  class FileProvider 
+    def initialize( optionss=nil )
+    end
+    # return lines in a file as a long string
+    def get_template( file_name )
+      return File.readlines( file_name ).join
+    end
+  end
+
+end

data/lib/cli/aws-must-cli.rb

@@ -0,0 +1,338 @@
+
+require 'thor'
+require_relative '../aws-must'
+
+
+class App < Thor
+
+  include Utils::MyLogger     # mix logger
+  PROGNAME = "main"           # logger progname
+
+  # default values
+
+  DEAFAULT_TEMPLATE="root"    # name of template in :template_path -directory
+
+  # DEFAUL_FOLD_ON="<!--*SED-MAGIC* <div class=window> -->"     # default output for +++fold-on+++ tag
+  # DEFAUL_FOLD_OFF="<!--*SED-MAGIC* </div>  -->"               # default output for +++fold-off+++ tag
+
+  # default output for +++fold-on+++ tag
+  DEFAUL_FOLD_ON="<div class='fold'>Check to show template: <input type='checkbox' class='toggle'/><div>"
+  DEFAUL_FOLD_OFF="</div></div>"                # default output for +++fold-off+++ tag
+
+  # ------------------------------------------------------------------
+  # make two thor tasks share options?
+  # http://stackoverflow.com/questions/14346285/how-to-make-two-thor-tasks-share-options
+
+  class << self
+    def add_shared_option(name, options = {})
+      @shared_options = {} if @shared_options.nil?
+      @shared_options[name] =  options
+    end
+
+    def shared_options(*option_names)
+      option_names.each do |option_name|
+        opt =  @shared_options[option_name]
+        raise "Tried to access shared option '#{option_name}' but it was not previously defined" if opt.nil?
+        option option_name, opt
+      end
+    end
+  end
+
+  def initialize(*args)
+    super
+    @logger = getLogger( PROGNAME, options )
+  end
+
+  # ------------------------------------------------------------------
+
+  class_option :log, :aliases => "-l", :type =>:string, :default => nil, 
+  :enum => [ "DEBUG", "INFO", "WARN", "ERROR" ],
+  :desc => "Set debug level "
+
+
+  # ------------------------------------------------------------------
+  add_shared_option :template_gem, :aliases => "-g", :type => :string,
+  :desc => "Mustache template Gem name (optionally with version constraint e.g. 'aws-must-templates,~>0.0.1') (DEPRECATED)"
+
+  add_shared_option :template_path, :aliases => "-t", :type =>
+  :string, :desc => "Directory holding mustache templates (DEPRECATED)"
+
+  add_shared_option :mustaches, :aliases => "-m", :type =>
+  :array, :default =>  [ "mustache/"], 
+  :desc => "Array of directory paths (ending with slash '/' char e.g. 'mustache/') of Gem names (optionally with version constraint e.g. 'aws-must-templates,~>0.0.1') holding mustache templates"
+
+
+  add_shared_option :fold_on, :aliases => "-n", :type => :string, 
+  :default => DEFAUL_FOLD_ON, 
+  :desc => "Output for +++fold-on+++ tag"
+
+  add_shared_option :fold_off, :aliases => "-f", :type => :string, 
+  :default => DEFAUL_FOLD_OFF, 
+  :desc => "Output for +++fold-off+++ tag"
+
+
+
+  # ------------------------------------------------------------------
+  # action 'doc'
+
+  desc "doc", "Extract documentation in template"
+
+  shared_options :template_path
+  shared_options :mustaches
+  shared_options :template_gem
+
+  shared_options :fold_on
+  shared_options :fold_off
+
+
+  long_desc <<-LONGDESC
+
+  Extract documation from <template_name> in ':template_path' -directory.
+
+  <template_name> defaults to '#{DEAFAULT_TEMPLATE}'
+
+
+  Documentation is extracted from lines surrounded by #{AwsMust::Docu::DEFAULT_OPEN_TAG} and #{AwsMust::Docu::DEFAULT_CLOSE_TAG} tags,
+  or by  #{AwsMust::Docu::DEFAULT_FOLD_ON_TAG} and  #{AwsMust::Docu::DEFAULT_FOLD_OFF_TAG} tags. 
+
+  Following rules apply:
+
+  - #{AwsMust::Docu::DEFAULT_OPEN_TAG},  #{AwsMust::Docu::DEFAULT_CLOSE_TAG} -tags: nothing is outputted for these lines
+
+  - #{AwsMust::Docu::DEFAULT_FOLD_ON_TAG} -tag: output text for --fold_on option (defaults '#{DEFAUL_FOLD_ON}')
+
+  - #{AwsMust::Docu::DEFAULT_FOLD_OFF_TAG} -tag: output text for --fold_off option (defaults '#{DEFAUL_FOLD_OFF}')
+
+
+  Defult fold_on and fold_off parameters implement CCS-toggle when using following css-code
+
+          /* CSS-support fold-on/fold-off toggle */\n
+          div.fold { width: 90%; padding: .42rem; border-radius: 5px;  margin: 1rem; }\n
+          div.fold div { height: 0px; margin: .2rem; overflow: hidden; }\n
+          div.toggle ~ div { height: 0px; margin: .2rem; overflow: hidden; }\n
+          input.toggle:checked ~ div { height: auto;color: white; background: #c6a24b;font-family: monospace;white-space: pre; }\n
+
+
+LONGDESC
+
+  def doc( template_name=DEAFAULT_TEMPLATE )
+
+    @logger.info( "#{__method__} starting" )
+
+    
+    my_options = option_adjust_common( options )
+
+    app = ::AwsMust::AwsMust.new( my_options )
+    app.doc( template_name )
+
+  end
+
+  # ------------------------------------------------------------------
+  # action 'ddoc'
+
+  desc "ddoc <pattern>", "Extract documentation in <pattern> files"
+
+  shared_options :fold_on
+  shared_options :fold_off
+
+
+  def ddoc( pattern )
+
+    @logger.info( "#{__method__} starting, options '#{options}'" )
+
+
+    files = Dir.glob( pattern ).sort
+    files.each do |file|
+      @logger.debug( "#{__method__}, file '#{file}'" )
+      fileProvider = AwsMust::FileProvider.new( options )
+      docu = AwsMust::Docu.new( fileProvider, options )
+      docu.document( file )
+    end
+    
+  end
+
+
+  # ------------------------------------------------------------------
+  # action 'json'
+
+  desc "json <yaml_file> [with_adjust]", "Dump configuration in JSON format (with or without adjustment)"
+
+  long_desc <<-LONGDESC
+
+  Reads <yaml_file> and dumps it to stdout in JSON format
+  'with_adjust' (yes/no)
+
+  By default 'adjusts' data, i.e. adds property "_comma" with the
+  value "," to each sub document, expect the last sub-document is
+  adjusted with empty string "".
+
+  The "_comma" -property helps in generating valid json arrays in
+  mustache templates. For example, YAML construct
+
+    tags:
+       - Key: key1
+         Value: value1
+
+       - Key: key2
+         Value: value2
+
+  and Mustache template snippet
+
+  { "Tags" : [ 
+       {{#tags}}
+           { "Key" : "{{Key}}",  "Value" : "{{Value}}"{{_comma}} }
+       {{/tags}} 
+  ]}
+
+  results to valid JSON document
+
+  { "Tags" : [ 
+           { "Key" : "key1",  "Value" : "value1", 
+           { "Key" : "key2",  "Value" : "value2"
+  ]}
+
+LONGDESC
+
+
+  def json( yaml_file, with_adjust="true" )
+
+    app = ::AwsMust::AwsMust.new( options )
+    app.json( yaml_file, with_adjust =~ /^true$/ || with_adjust =~ /^yes$/  ? true : false  )
+
+  end
+
+
+  # ------------------------------------------------------------------
+  # action 'gen'
+
+  desc "gen <yaml_file> [<template_name>]", "Generate CloudFormation JSON template"
+
+  shared_options :template_path
+  shared_options :mustaches
+  shared_options :template_gem
+
+  long_desc <<-LONGDESC
+
+  Generate Amazon CloudFormation JSON file for <yaml_file> using
+  <template_name> in ':template_path' -directory.
+
+  <template_name> defaults to '#{DEAFAULT_TEMPLATE}'
+
+LONGDESC
+
+
+  def gen( yaml_file, template_name=DEAFAULT_TEMPLATE )
+
+    my_options = option_adjust_common( options )
+
+    app = ::AwsMust::AwsMust.new( my_options )
+    app.generate( template_name, yaml_file, my_options )
+
+  end
+
+  # ------------------------------------------------------------------
+  # common routines
+  no_commands do
+
+    def option_adjust_common( options ) 
+
+      raise "No optios given" unless options
+
+      # options readonly - dup allows modification
+      options = options.dup
+
+      @logger.debug( "#{__method__}, options '#{options}'" )
+
+      options = option_template_gem_to_template_path( options )  if options[:template_gem]
+      options = option_template_path( options )  if options[:template_path]
+
+      warn <<-EOS   unless options[:mustaches] && options[:mustaches].any?
+
+      Deprecation!!
+
+           Use option -m to define location of templates
+
+           Options -g and -t deprecated
+      EOS
+
+      options = option_mustaches_to_template_paths( options )  if options[:mustaches]
+      
+      return options
+    end
+
+    # set `options[:template_path]` to an array of local directory
+    # paths parsed from list of options[:mustaches]
+    def option_mustaches_to_template_paths( options ) 
+
+      # init, NB: plural
+      options[:template_paths] = []
+
+      options[:mustaches].each do |mustache_def|
+        if mustache_def[-1] == '/' then
+          # directory with last char removed
+          options[:template_paths] << mustache_def[0..-1]
+        else
+          # gemname 
+          options[:template_paths] << gem_name_to_template_path( mustache_def )
+        end
+          
+      end
+      return options
+    end
+
+    # overrides -m option
+    def option_template_path( options ) 
+      # overrides -m option
+      options[:mustaches] = []
+      return options
+    end
+
+    # set 'options[:template_path]' to mustache directory withing
+    # `options[:template_gem]` Gem
+    def option_template_gem_to_template_path( options ) 
+
+      # overrides -m option
+      options[:mustaches] = []
+
+      options[:template_path] = gem_name_to_template_path( options[:template_gem] )
+      
+      return options
+
+    end
+
+    # map 'gem_name_and_spec' to path of mustache templates
+    def gem_name_to_template_path( gem_name_and_spec ) 
+
+      # The version requirements are optional.
+      # You can also specify multiple version requirements, just append more at the end
+      gem_spec = gem_name_and_spec.split(',')
+      gem_name, *gem_ver_reqs = gem_spec[0], gem_spec[1]
+      @logger.debug( "#{__method__}, gem_name=#{gem_name}, *gem_ver_reqs=#{gem_ver_reqs}" )
+      gdep = Gem::Dependency.new(gem_name, *gem_ver_reqs)
+      # find latest that satisifies
+      found_gspec = gdep.matching_specs.sort_by(&:version).last
+      @logger.debug( "#{__method__}, found_gspec=#{found_gspec}" )
+      # instead of using Gem::Dependency, you can also do:
+      # Gem::Specification.find_all_by_name(gem_name, *gem_ver_reqs)
+
+      if found_gspec
+        @logger.debug( "#{__method__}, Requirement '#{gdep}' already satisfied by #{found_gspec.name}-#{found_gspec.version}" )
+        @logger.debug( "#{__method__}, old-options=#{options}" )
+        template_path = "#{found_gspec.gem_dir}/mustache"
+        @logger.debug( "#{__method__}, template_path=#{template_path}" )
+      else
+        #puts "Requirement '#{gdep}' not satisfied; installing..."
+        # ver_args = gdep.requirements_list.map{|s| ['-v', s] }.flatten
+        # # multi-arg is safer, to avoid injection attacks
+        # system('gem', 'install', gem_name, *ver_args)
+        raise "Could not find gem '#{gdep}' - try 'gem install #{gdep}'"
+      end
+      
+      return template_path
+
+    end
+    
+  end # no commands
+
+end
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-must
 version: !ruby/object:Gem::Version
-  version: 0.0.13
+  version: 0.0.14
 platform: ruby
 authors:
 - jarjuk
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-23 00:00:00.000000000 Z
+date: 2015-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mustache
@@ -101,7 +101,9 @@ files:
 - lib/aws-must.rb
 - lib/aws-must/aws-must.rb
 - lib/aws-must/docu.rb
+- lib/aws-must/fileprovider.rb
 - lib/aws-must/template.rb
+- lib/cli/aws-must-cli.rb
 - lib/tasks/demo.rake
 - lib/utils/hasher.rb
 - lib/utils/logger.rb
@@ -131,3 +133,4 @@ signing_key:
 specification_version: 4
 summary: Minimum Viable Solution to Manage CloudFormation Templates'
 test_files: []
+has_rdoc: