cfn2dsl 0.1.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 586d1c3a0f6716123303a6cfe7f7af3a7c85b13c
+  data.tar.gz: f4d6d21a4e9b79073f0ddbf0b7f9562bc33b4174
+SHA512:
+  metadata.gz: 65bd8bf97a568b05a128cec15804d6f218c8ca39943ce791ce7d6c68a1b132e2f664d9d7b5c9dae151d5e1512554b1b1b3ee4d2638a681382c27349f9d82bcb1
+  data.tar.gz: 057ba371b67b737e833ce29a2266e6c35ad64b652fd200946b59be27d16437639a3d194b07afaf9460185cbdd5166e2552b59bdddacde6276cd107ee0d215508

data/bin/cfn2dsl

@@ -0,0 +1,42 @@
+#!/usr/bin/env ruby
+require_relative '../lib/cfn2dsl'
+
+USAGE = "Usage: #{File.basename(__FILE__)} -t|--template file [-o|--output file]"
+options = {}
+OptionParser.new do |opts|
+  opts.banner = USAGE
+  opts.on('-t', '--template file', 'Template file path') do |v|
+    options[:template] = v
+  end
+
+  opts.on('-o', '--output [file]', 'Output file path') do |v|
+    options[:output] = v
+  end
+
+  opts.on_tail('-h', '--help', 'show this message') do |_v|
+    puts opts
+    exit
+  end
+
+  opts.on_tail('-v', '--version', 'show the version') do |_v|
+    puts VERSION
+    exit
+  end
+end.parse!
+
+unless options[:template]
+  puts USAGE
+  exit 1
+else
+  template = JSON.load(File.new(options[:template]))
+  cfndsl   = CloudFormation.new(template)
+end
+
+if options[:output]
+  File.open(options[:output], 'w') do |file|
+    file.write(Render.new(cfndsl).cfn_to_cfndsl)
+  end
+else
+  puts Render.new(cfndsl).cfn_to_cfndsl
+end
+

data/lib/cfn2dsl.rb

@@ -0,0 +1,24 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require 'json'
+require 'optparse'
+require 'ap'
+
+require 'cfn_parser'
+require 'cloudformation'
+require 'condition'
+require 'intrinsic_function'
+require 'mapping'
+require 'output'
+require 'parameter'
+require 'resource'
+require 'render'
+
+AwesomePrint.defaults = {
+  :indent    => -2,
+  :index     => false,
+  :sort_keys => true,
+  :plain     => true
+}
+
+VERSION="0.1.4"

data/lib/cfn_parser.rb

@@ -0,0 +1,40 @@
+module CfnParser
+
+  def parse_cfn_json(json)
+    send(element_type(json).to_s.snake_case, json)
+  end
+
+  def intrinsic_function?(obj)
+    obj.instance_of?(Hash) &&
+    obj.keys.size == 1 &&
+    (obj.keys.first =~ /^Fn::/ or obj.keys.first == "Ref")
+  end
+
+  def array(json)
+    return json.map { |a| parse_cfn_json(a) }
+  end
+
+  def intrinsic_function(json)
+    fn_name    = json.keys.first
+    values     = json[fn_name]
+    parameters = parse_cfn_json(values)
+    return IntrinsicFunction.new(fn_name, parameters)
+  end
+
+  def hash(json)
+    return json.merge(json) { |k, v| parse_cfn_json(v) }
+  end
+
+  def primitive(json)
+    json
+  end
+
+  private
+  def element_type(json)
+    return :Array             if json.instance_of?(Array)
+    return :IntrinsicFunction if intrinsic_function?(json)
+    return :Hash              if json.instance_of?(Hash)
+    return :Primitive
+  end
+end
+

data/lib/cfndsl.erb

@@ -0,0 +1,204 @@
+CloudFormation do
+  <% if @cfn.description %>
+  Description(<%= @cfn.description.dump %>)
+  <% end %>
+  <% if @cfn.aws_template_format_version %>
+  AWSTemplateFormatVersion(<%= @cfn.aws_template_format_version.dump %>)
+  <% end %>
+  <% # Parameters %>
+  <%
+  if @cfn.parameters
+    @cfn.parameters.each do |param|
+  %>
+
+  Parameter(<%= param.name.dump %>) do
+    <% if param.description %>
+    Description(<%= param.description.dump %>)
+    <% end %>
+    <% if param.type %>
+    Type(<%= param.type.dump %>)
+    <% end %>
+    <% if param.default
+          default_value = param.default
+          if param.default.respond_to? :dump
+            default_value = param.default.dump
+          end
+    %>
+    Default(<%= default_value %>)
+    <% end %>
+    <% if param.allowed_values %>
+    AllowedValues(<%= param.allowed_values.ai %>)
+    <% end %>
+    <% if param.allowed_pattern %>
+    AllowedPattern(<%= param.allowed_pattern.dump %>)
+    <% end %>
+    <% if param.no_echo %>
+    NoEcho(<%= param.no_echo %>)
+    <% end %>
+    <% if param.max_length %>
+    MaxLength(<%= param.max_length.to_i %>)
+    <% end %>
+    <% if param.min_length %>
+    MinLength(<%= param.min_length.to_i %>)
+    <% end %>
+    <% if param.max_value %>
+    MaxValue(<%= param.max_value %>)
+    <% end %>
+    <% if param.min_value %>
+    MinValue(<%= param.min_value %>)
+    <% end %>
+    <% if param.constraint_description %>
+    ConstraintDescription(<%= param.constraint_description.dump %>)
+    <% end %>
+  end
+  <%
+    end
+  end
+  %>
+  <% # Mappings %>
+  <%
+  if @cfn.mappings
+    @cfn.mappings.each do |map|
+  %>
+
+  Mapping(<%= map.name.dump %>, <%= map.values.ai %>)
+  <%
+    end
+  end
+  %>
+  <% # Conditions %>
+  <%
+  if @cfn.conditions
+    @cfn.conditions.each do |cond|
+  %>
+
+  Condition(<%= cond.name.dump %>, <%= cond.evaluations.ai %>)
+  <%
+    end
+  end
+  %>
+  <% # Resources %>
+  <%
+  @cfn.resources.each do |res|
+  %>
+
+  Resource(<%= res.name.dump %>) do
+    Type("<%= res.type %>")
+    <%
+    if res.creation_policy
+    %>
+    CreationPolicy(<%= res.creation_policy.dump %>)
+    <%
+    end
+    %>
+    <%
+    if res.deletion_policy
+    %>
+    DeletionPolicy(<%= res.deletion_policy.dump %>)
+    <%
+    end
+    %>
+    <%
+    if res.condition
+    %>
+    Condition(<%= res.condition.dump %>)
+    <%
+    end
+    %>
+    <%
+    if res.update_policy
+      res.update_policy.each_pair do |name, value|
+        if value.instance_of? String
+          value = value.dump
+        else
+          value = value.ai
+        end
+    %>
+    UpdatePolicy(<%= name.dump %>,<%= value %>)
+    <%
+      end
+    end
+    %>
+    <%
+    if res.metadata
+      res.metadata.each_pair do |name, value|
+        if value.instance_of? String
+          value = value.dump
+        else
+          value = value.ai
+        end
+    %>
+    Metadata(<%= name.dump %>, <%= value %>)
+    <%
+      end
+    end
+    %>
+    <%
+    if res.depends_on
+      if res.depends_on.instance_of? String
+        value = res.depends_on.dump
+      else
+        value = res.depends_on.ai
+      end
+    %>
+    DependsOn(<%= value %>)
+    <%
+    end
+    %>
+    <%
+    if res.properties
+      res.properties.each_pair do |name, value|
+        if value.instance_of? String
+          value = value.dump
+        else
+          value = value.ai
+        end
+    %>
+    Property(<%= name.dump %>, <%= value %>)
+    <%
+      end
+    end
+    %>
+  end
+  <%
+  end
+  %>
+  <% # Output %>
+  <%
+  if @cfn.outputs
+    @cfn.outputs.each do |out|
+  %>
+
+  Output(<%= out.name.dump %>) do
+    <%
+    if out.condition
+    %>
+    Condition(<%= out.condition.dump %>)
+    <%
+    end
+    %>
+    <%
+    if out.description
+    %>
+    Description(<%= out.description.dump %>)
+    <%
+    end
+    %>
+    <%
+    if out.value
+      if out.value.instance_of? String
+        value = out.value.dump
+      else
+        value = out.value.ai
+      end
+    %>
+    Value(<%= value %>)
+    <%
+    end
+    %>
+  end
+  <%
+    end
+  end
+  %>
+end

data/lib/cloudformation.rb

@@ -0,0 +1,67 @@
+require 'extlib'
+class CloudFormation
+
+  ELEMENTS = [
+    :parameters,
+    :resources,
+    :conditions,
+    :outputs,
+    :mappings,
+    :description,
+    :aws_template_format_version
+  ]
+
+  attr_reader(*ELEMENTS)
+
+  def initialize(json)
+    ELEMENTS.each do |e|
+      key  = e.to_s.camel_case
+      if key =~ /^Aws/
+        key = key.sub(/^Aws/, "AWS")
+      end
+
+      if json[key]
+        attr = parse_element(e, json[key])
+        instance_variable_set("@" + e.to_s, attr)
+      end
+    end
+  end
+
+  private
+  def parse_element(elm_name, json)
+    function = parser(elm_name)
+    send(function, elm_name, json)
+  end
+
+  def parser(name)
+    case name
+    when :description
+      :simple_parser
+    when :aws_template_format_version
+      :simple_parser
+    else
+      :complex_parser
+    end
+  end
+
+  def simple_parser(name, json)
+    json
+  end
+
+  def complex_parser(name, json)
+    elms = []
+    case name
+    when :parameters
+      json.each_pair { |k, v| elms << Parameter.new(k, v) }
+    when :resources
+      json.each_pair { |k, v| elms << Resource.new(k, v) }
+    when :outputs
+      json.each_pair { |k, v| elms << Output.new(k, v) }
+    when :mappings
+      json.each_pair { |k, v| elms << Mapping.new(k, v) }
+    when :conditions
+      json.each_pair { |k, v| elms << Condition.new(k, v) }
+    end
+    return elms
+  end
+end

data/lib/condition.rb

@@ -0,0 +1,9 @@
+class Condition
+  include CfnParser
+  attr_reader(:name, :evaluations)
+
+  def initialize(name, eval)
+    @name        = name
+    @evaluations = parse_cfn_json(eval)
+  end
+end

data/lib/intrinsic_function.rb

@@ -0,0 +1,121 @@
+class IntrinsicFunction
+  attr_reader :name, :parameters
+
+  def initialize(name, parameters)
+    @name = name
+    @parameters = parameters
+  end
+
+  def to_s
+    function_name = @name.delete(':').snake_case
+    send(function_name)
+  end
+
+  alias_method :inspect, :to_s
+
+  def ==(o)
+    o.instance_of?(IntrinsicFunction) and o.name == @name and @parameters == o.parameters
+  end
+
+  private
+  def fn_base64
+    if @parameters.instance_of? String
+      value = '"' + @parameters.gsub('"'){'\\"'} + '"'
+    else
+      value = @parameters.ai
+    end
+    return "FnBase64(#{value})"
+  end
+
+  def fn_select
+    return "FnSelect(#{@parameters[0]}, #{@parameters[1..@parameters.size].ai})"
+  end
+
+  def ref
+    return "Ref(\"#{@parameters.gsub('"'){'\\"'}}\")"
+  end
+
+  def fn_and
+    return "FnAnd(#{@parameters.ai})"
+  end
+
+  def fn_equals
+    if @parameters[0].instance_of? String
+      arg1 = '"' + @parameters[0].gsub('"'){'\\"'} + '"'
+    else
+      arg1 = @parameters[0].ai
+    end
+
+    if @parameters[1].instance_of? String
+      arg2 = '"' + @parameters[1].gsub('"'){'\\"'} + '"'
+    else
+      arg2 = @parameters[1].ai
+    end
+
+    return "FnEquals(#{arg1}, #{arg2})"
+  end
+
+  def fn_if
+    cond_name = '"' + @parameters[0].gsub('"'){'\\"'} + '"'
+    if @parameters[1].instance_of? String
+      true_value = '"' + @parameters[1].gsub('"'){'\\"'} + '"'
+    else
+      true_value = @parameters[1].ai
+    end
+
+    if @parameters[2].instance_of? String
+      false_value = '"' + @parameters[2].gsub('"'){'\\"'} + '"'
+    else
+      false_value = @parameters[2].ai
+    end
+    return "FnIf(#{cond_name}, #{true_value}, #{false_value})"
+  end
+
+  def fn_not
+    return "FnNot(#{@parameters.ai})"
+  end
+
+  def fn_or
+    return "FnOr(#{@parameters.ai})"
+  end
+
+  def fn_find_in_map
+    map_name = '"' + @parameters[0] + '"'
+
+    if @parameters[1].instance_of? String
+      top_level_key = '"' + @parameters[1] + '"'
+    else
+      top_level_key = @parameters[1].ai
+    end
+
+    if @parameters[2].instance_of? String
+      sec_level_key = '"' + @parameters[2] + '"'
+    else
+      sec_level_key = @parameters[2].ai
+    end
+
+    return "FnFindInMap(#{map_name}, #{top_level_key}, #{sec_level_key})"
+  end
+
+  def fn_get_att
+    resource_name = '"' + @parameters[0] + '"'
+    attr_name     = '"' + @parameters[1] + '"'
+    return "FnGetAtt(#{resource_name}, #{attr_name})"
+  end
+
+  def fn_join
+    seperator = '"' + @parameters[0].gsub('"'){'\\"'} + '"'
+    values    = @parameters[1].ai
+    return "FnJoin(#{seperator}, #{values})"
+  end
+
+  def fn_get_a_zs
+    if @parameters.instance_of? String
+      value = '"' + @parameters.gsub('"'){'\\"'} + '"'
+    else
+      value = @parameters.ai
+    end
+    
+    return "FnGetAZs(#{value})"
+  end
+end

data/lib/mapping.rb

@@ -0,0 +1,9 @@
+class Mapping
+  include CfnParser
+  attr_reader(:name, :values)
+
+  def initialize(name, values)
+    @name   = name
+    @values = parse_cfn_json(values)
+  end
+end

data/lib/output.rb

@@ -0,0 +1,26 @@
+class Output
+  include CfnParser
+
+  ATTRIBUTES = [
+    :value,
+    :condition,
+    :description
+  ]
+
+  attr_reader(:name, *ATTRIBUTES)
+
+  def initialize(name, json)
+    @name = name
+    ATTRIBUTES.each {|a| attribute(a, json)}
+  end
+
+  private
+  def attribute(name, json)
+    key = name.to_s.camel_case
+    if json[key]
+      value = parse_cfn_json(json[key])
+      instance_variable_set("@" + name.to_s, value)
+    end
+  end
+end
+

data/lib/parameter.rb

@@ -0,0 +1,27 @@
+require 'extlib'
+class Parameter
+  ELEMENTS = [
+    :name,
+    :type,
+    :default,
+    :description,
+    :allowed_values,
+    :allowed_pattern,
+    :no_echo,
+    :max_length,
+    :min_length,
+    :max_value,
+    :min_value,
+    :constraint_description
+  ]
+
+  attr_reader(*ELEMENTS)
+
+  def initialize(name, json)
+    @name = name
+    ELEMENTS.each do |e|
+      key_name = e.to_s.camel_case
+      instance_variable_set('@' + e.to_s, json[key_name]) if json[key_name]
+    end
+  end
+end

data/lib/render.rb

@@ -0,0 +1,15 @@
+require 'erubis'
+class Render
+
+  attr_reader :cfn
+
+  def initialize(cfn)
+    @cfn = cfn
+  end
+
+  def cfn_to_cfndsl
+    input = File.read("#{File.dirname(__FILE__)}/cfndsl.erb")
+    context = { :cfn => @cfn }
+    Erubis::Eruby.new(input).evaluate(context).to_s
+  end
+end

data/lib/resource.rb

@@ -0,0 +1,54 @@
+class Resource
+  include CfnParser
+
+  ATTRIBUTES = [
+    :deletion_policy,
+    :depends_on,
+    :metadata,
+    :update_policy,
+    :condition,
+    :type,
+    :properties,
+    :creation_policy
+  ]
+
+  attr_reader(:name, *ATTRIBUTES)
+
+  def initialize(name, json)
+    @name = name
+    ATTRIBUTES.each do |a|
+      send(attribute_type(a), json, a.to_s)
+    end
+  end
+
+  private
+  def attribute_type(name)
+    type = ''
+    case name
+    when name == :properties    ||
+         name == :metadata      || 
+         name == :update_policy ||
+         name == :depends_on    || 
+         name == :creation_policy
+      type = "complex_attribute"
+    else
+      type = "basic_attribute"
+    end
+    return type
+  end
+
+  def complex_attribute(json, name)
+    if json[name.camel_case]
+      values = json[name.camel_case].merge do |k, v|
+        parse_cfn_json(v)
+      end
+      instance_variable_set('@' + name, values)
+    end
+  end
+
+  def basic_attribute(json, name)
+    if json[name.camel_case]
+      instance_variable_set('@' + name, parse_cfn_json(json[name.camel_case]))
+    end
+  end
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: cfn2dsl
+version: !ruby/object:Gem::Version
+  version: 0.1.4
+platform: ruby
+authors:
+- kevin yung (kevin.yung@rea-group.com)
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: extlib
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ruby-beautify
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: erubis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A tool to convert CloudFormation JSON template into a Ruby DSL cfndsl
+email: 
+executables:
+- cfn2dsl
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/cfn2dsl
+- lib/cfn2dsl.rb
+- lib/cfn_parser.rb
+- lib/cfndsl.erb
+- lib/cloudformation.rb
+- lib/condition.rb
+- lib/intrinsic_function.rb
+- lib/mapping.rb
+- lib/output.rb
+- lib/parameter.rb
+- lib/render.rb
+- lib/resource.rb
+homepage: https://github.com/realestate-com-au/cfn2dsl.git
+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.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A tool to convert CloudFormation JSON template into a Ruby DSL cfndsl
+test_files: []