mkstack 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa22c1f1c57234678eefa866bc219909dc00334d91d6d4daf70be9762233d51c
-  data.tar.gz: c5a1f8095d6b34d467fafd443fbc9605b206a42ef70e65f47ec9290ed8783ca3
+  metadata.gz: aaf1a841fa0de51efa15c58884b99939a940d2c1bf2e87873d8b3e63d2a1ff6b
+  data.tar.gz: 7241af85e09c860e3bd5c105a7ec0e8dea22a9614d4b8a3d21aac72288abb26c
 SHA512:
-  metadata.gz: b0a0588f47fbc38f7efddb0175afbfacb7d40604a41094a9bc705a26fc6edc154c00bc9f2146e1a19d3326d1d7bfdbb2a6f2de9918a5f8a67ca11e06e202d286
-  data.tar.gz: b23350d9abe01bb969d9dbf617d7025f5572481e526b37a7632a6ec8fb46c7a64aebb92266166105bfd55ffd73f5187b642620d04bdf4ede746ceeb99bf696ee
+  metadata.gz: 5bd88c3603c614382a10fbcb1009704b661afe89f3553162c4a2a0b4e04494f82c9cb025eada3451c65d93a981ad2161d14d0ea50f89ab40bc0d6451b8a4a4fd
+  data.tar.gz: e90035e6ab6a9f37f6b9b8837efbc349e391f24c3d03e2a9c4179314e7c294e7243705f580a8425240ed9b4ec98280a2a5d05954a6969772f19d30b1d87bd710

data/bin/mkstack

@@ -15,12 +15,11 @@ $logger.formatter = proc { |s, d, p, m|
   "[%s] %5s [%5s] - %s\n" % [ d.strftime("%Y-%m-%d %H:%M:%S"), s, caller(4, 1).first.split(":")[1], m ]
 }
 
-
 # Default options
 options = {}
 options[:erb] = true
 options[:format] = "json"
-
+options[:erb_argv] = []
 
 # Command line options
 opts = OptionParser.new do |p|
@@ -36,7 +35,7 @@ opts = OptionParser.new do |p|
   p.on("-d", "--debug",   "Show debug messages")         { $logger.level = Logger::DEBUG }
   p.on("-v", "--verbose", "Be verbose")                  { $logger.level = Logger::INFO }
   p.on("-q", "--quiet",   "Only show errors")            { $logger.level = Logger::ERROR }
-  p.on("-s", "--silient", "Don't show any log messages") { $logger.level = Logger::FATAL }
+  p.on("-s", "--silent",  "Don't show any log messages") { $logger.level = Logger::FATAL }
   p.separator(" ")
 
   # Output
@@ -49,18 +48,36 @@ opts = OptionParser.new do |p|
   # Operations
   p.on("--erb", "--[no-]erb", "Perform ERB processing (default is true)") { |x| options[:erb] = x }
   p.on("--validate", "Call ValidateTemplate after merging") { options[:validate] = true }
+  p.separator(" ")
+
+  # ERB options
+  p.on("---", "Marks end of mkstack options") { p.terminate("---") }
+  p.on("%s Remaining arguments are available to ERB as an Array argv" % [ desc_padding ])
 end
 
-files = opts.parse!.uniq
-opts.parse "--help" if files.count == 0
+# Separate files from ERB arguments
+args = opts.parse!
 
-template = MkStack::Template.new(options[:format])
+if args.index("---")
+  files = args[0..(args.index("---") - 1)]
+  options[:erb_argv] = args[(args.index("---") + 1)..]
+else
+  files = args
+end
 
+# At least one file is required
+files.uniq!
+opts.parse "--help" if ((files.count == 0) or (files[0].eql?("---")))
 
 # Merge files
+template = MkStack::Template.new(options[:format], options[:erb_argv])
+
 files.each do |file|
   begin
-    Dir.chdir(File.dirname(file)) { template.merge(File.basename(file), options[:erb]) }
+    Dir.chdir(File.dirname(file)) {
+      $logger.info { "Loading #{file}" }
+      template.merge(File.basename(file), options[:erb])
+    }
   rescue KeyError => e
     $logger.warn { "#{file}: already parsed" }
   rescue Exception => e
@@ -68,7 +85,6 @@ files.each do |file|
   end
 end
 
-
 # Check limits
 $logger.debug { "Checking limits" }
 
@@ -79,19 +95,17 @@ end
 $logger.warn { "At least one Resources member must be defined" } if template["Resources"].length == 0
 $logger.warn { "Template too large (#{template.length} > #{template.limit})" } if template.exceeds_limit?
 
-
 # Validate template
 if options[:validate] then
   begin
     $logger.info { "Validating #{template.format} template" }
 
-    $logger.debug { template.validate }
+    template.validate
   rescue Exception => e
     $logger.error { e.message }
   end
 end
 
-
 # Save template
 if options[:save] then
   begin

data/lib/mkstack.rb

@@ -71,6 +71,19 @@ tags defined in one file to be referenced in subsequent files.
 
 Note that foo.yaml is processed <i>before</i> bar.json.
 
+== Passing arguments to ERB
+
+Any command line arguments following "---" are added to an Array
+called <b>argv</b>, which can be referenced in your ERB code.
+
+=== foo.yaml
+
+  <% puts "#{argv.class} with #{argv.length} items: #{argv}" %>
+
+$ mkstack foo.yaml --- a 2 test
+
+Array with 3 items: ["a", "2", "test"]
+
 == See Also
 
   MkStack::Template

data/lib/mkstack/template.rb

@@ -10,20 +10,20 @@ module MkStack
   class Template
     attr_reader :sections, :limit, :format
 
-    def initialize(format = "json")
+    def initialize(format = "json", argv = nil)
       @format = format
 
       @sections = {
         "AWSTemplateFormatVersion" => Section.new("AWSTemplateFormatVersion", String, nil),
         "Description" => Section.new("Description", String, 1024),
 
-        "Conditions"  => Section.new("Conditions",  Hash, nil),
-        "Mappings"    => Section.new("Mappings",    Hash, 100),
-        "Metadata"    => Section.new("Metadata",    Hash, nil),
-        "Outputs"     => Section.new("Outputs",     Hash, 60),
-        "Parameters"  => Section.new("Parameters",  Hash, 60),
-        "Resources"   => Section.new("Resources",   Hash, nil),
-        "Transforms"  => Section.new("Transforms",  Hash, nil),
+        "Conditions" => Section.new("Conditions", Hash, nil),
+        "Mappings"   => Section.new("Mappings",   Hash, 100),
+        "Metadata"   => Section.new("Metadata",   Hash, nil),
+        "Outputs"    => Section.new("Outputs",    Hash, 60),
+        "Parameters" => Section.new("Parameters", Hash, 60),
+        "Resources"  => Section.new("Resources",  Hash, nil),
+        "Transform"  => Section.new("Transform",  Hash, nil),
       }
       @limit = 51200
 
@@ -36,7 +36,7 @@ module MkStack
       @binding = binding
 
       # See add_domain_types
-      @yaml_domain = "mlfs.org,2019"
+      @yaml_domain = "mlfs.org,2020"
       @global_tag = "tag:#{@yaml_domain}:"
     end
 
@@ -157,20 +157,15 @@ module MkStack
         "If",
         "Not",
         "Or",
-      ].each do |function|
-        YAML::add_domain_type(@yaml_domain, function) do |type, val|
-          @format = "yaml"
-          "#{type} #{val}"
-        end
-      end
-
-      # The syntax for !Sub requires double-quotes around Strings
-      functions = [
         "Sub",
       ].each do |function|
         YAML::add_domain_type(@yaml_domain, function) do |type, val|
-          @format = "yaml"
-          val.is_a?(String)? "#{type} \"#{val}\"" : "#{type} #{val}"
+          unless @format.eql?("yaml")
+            $logger.debug "Setting output to YAML for short form intrinsic function !#{function}"
+            @format = "yaml"
+          end
+
+          (function.eql?("Sub") and val.is_a?(String))? "#{type} \"#{val}\"" : "#{type} #{val}"
         end
       end
     end

data/mkstack.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name	= "mkstack"
-  s.version	= "1.0.0"
+  s.version	= "1.1.0"
   s.summary	= "Merge multiple CloudFormation template files into a single template"
   s.description	= <<-EOF
 Merge multiple CloudFormation template files into a single template.  Each file may be in either JSON or YAML format.  By default all files are run through an ERB (Embedded RuBy) processor.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mkstack
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Andy Rosen
@@ -10,9 +10,9 @@ bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIEOjCCAqKgAwIBAgIBATANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBphanIv
-  REM9Y29ycC9EQz1tbGZzL0RDPW9yZzAeFw0xOTA1MDEwMjIwNTBaFw0yMDA0MzAw
-  MjIwNTBaMCUxIzAhBgNVBAMMGmFqci9EQz1jb3JwL0RDPW1sZnMvREM9b3JnMIIB
+  MIID/jCCAmagAwIBAgIBAjANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBphanIv
+  REM9Y29ycC9EQz1tbGZzL0RDPW9yZzAeFw0yMDA2MjMyMjA0MDdaFw0yMTA2MjMy
+  MjA0MDdaMCUxIzAhBgNVBAMMGmFqci9EQz1jb3JwL0RDPW1sZnMvREM9b3JnMIIB
   ojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAqQ2xCUJ4wY8WujSzYd3OGTbj
   JDMeU44pXOTLc49Rs8ydukGfd0YBvYMzifmiVRj6depGx2+Ln28Y2mT6IB+zHq8X
   s1lrMdFCReztJjQ7OYS16YcZ6pmLkYClnHN3VNqayk1lQEJGCr8aawMeroSB01om
@@ -21,20 +21,19 @@ cert_chain:
   JbnFW7mFQGtBpfh8zY8OCQ76Aw8cb5bEIPTI+Hd4FoJLPKnexTI28endSLigOUCF
   76kLOiVOVOjdqZ8vEdSgWVugEAzIC30xW5b8yD6N7GdT7n3ktgoZu7jZMUW3D6PQ
   wS6BaABVsXbeVtFrzK2tQ65EwLfRluRLTfbnQ7qvMIYCwC3Ib9DTMLavCiOot1vc
-  RBWXIrDex0tt3EN0dDIxP9O+7ciDgM4zPe6BvaF/AgMBAAGjdTBzMAkGA1UdEwQC
-  MAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBRDowzw+kmcX6FV7T9BkQsUgmzLZjAc
-  BgNVHREEFTATgRFhanJAY29ycC5tbGZzLm9yZzAcBgNVHRIEFTATgRFhanJAY29y
-  cC5tbGZzLm9yZzANBgkqhkiG9w0BAQsFAAOCAYEAbbgfVpRCtujGFRHNYLWnq/iQ
-  vGtNs265jQKdq3SZ5HIsPP4RdiknOk2Q0BP4GDkXOhadtuuqeCVlJUczcrCKiKuP
-  Vu7iOQKpOq9bafhjvTpRPZL7uXDu0lwBrDyL9PGouBBsijTtGCc/A8cu/2HVoX+Z
-  X1pqmuJqVlgXp9ktbzPBeIdaFFT+9WzIzWCJ73oBYNZ1EP/4CRKIlmRCWzBGZtu6
-  QqNypgW/OCQVRcJGZ99myNQO5/EImQp1py6iHymkdCx2RMsdTUpcm3gUl4XaFd4J
-  pQ1HNcDdD3UCSDqlPpv2nVpOV4u1s3yojIHt0RcVXhSzqGHgmXNjKDIP0zokFBKx
-  NigI/5A3vv9PplxXMatOeirqPqDY5F4Aim4t2Dn+d+9OiPADkIBwuIuwwgRmcWhE
-  E2DV+ftSSpAT1zeHEZXx6BsvJVwtXq1kMDYibgB4lTU4lq1oHrx2x+PO2cukHlom
-  4cVT/heohjMDtNBaDMVsTjTxtNq6oi/pvyLqBGmQ
+  RBWXIrDex0tt3EN0dDIxP9O+7ciDgM4zPe6BvaF/AgMBAAGjOTA3MAkGA1UdEwQC
+  MAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBRDowzw+kmcX6FV7T9BkQsUgmzLZjAN
+  BgkqhkiG9w0BAQsFAAOCAYEAAmnuLwfJOuo9JlIMPCArwX0wIZcuKJ1Ms5S9RpTT
+  MYqNwa52//SCZ5VG0bZknXNgHGs1qm4kHekxOVjjjdawVHQFZvDJJxblSvj1OTe0
+  J4OF7hiWldeUE7ezeHDpzcVpGkHBGYCPkLBPyjMkRwlZpgth9DVO7FP3mV9SMHyP
+  x1/55FYk0A62NgXSzmLghePC+trYllv54YURP4/R8RYnZPZNf5MFMjF94BoWGFzQ
+  9BKJ+1DbdAVwCMSWEcGOkw5euwofwf6PpvLlmhB9pM+acsjLJkaS/OU7v5/X0F6+
+  MkYSejwDmyV9/u/cPgStxlOOu4x7Ur2qOzfb8OEKMmautB7ZEdCivdG/Qa634dDq
+  dnrb3iC4VliJf0o5SVrYjRxBYn9WQV1eJaygRunfhVo9AqRPg+rcbkQ/XIWUQDeY
+  kLyoFawGT9fF6+lXyIT9XiaUzOCjQUJo94on5U601Y2GXB4Sa1oxLSBlEtkSwuD3
+  gMHlHdBRvoJurkVzYNWkN+Cz
   -----END CERTIFICATE-----
-date: 2019-05-02 00:00:00.000000000 Z
+date: 2020-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-cloudformation
@@ -86,8 +85,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Merge multiple CloudFormation template files into a single template