Module: SparkleFormation::SparkleAttribute::Aws

Defined in:
lib/sparkle_formation/sparkle_attribute/aws.rb

Overview

AWS specific helper implementations

Instance Method Summary collapse

Instance Method Details

#_account_id ⇒ Hash Also known as: account_id!

Account ID generator

Returns:

  • (Hash) 


246
247
248
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 246

def 
  _ref('AWS::AccountId')
end

#_and(*args) ⇒ Hash Also known as: and!

Note:

symbols will be processed and set as condition. strings will be set as condition directly. procs will be evaluated

Fn::And generator

Parameters:

  • args (Object)

Returns:

  • (Hash) 


160
161
162
163
164
165
166
167
168
169
170
171
172
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 160

def _and(*args)
  {
    'Fn::And' => _array(
      *args.map{|v|
        if(v.is_a?(Symbol) || v.is_a?(String))
          _condition(v)
        else
          v
        end
      }
    )
  }
end

#_cf_attr(*args) ⇒ Hash Also known as: _cf_get_att, get_att!, attr!

Fn::GetAtt generator

Parameters:

  • pass (Object) —

    through arguments

Returns:

  • (Hash) 


66
67
68
69
70
71
72
73
74
75
76
77
78
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 66

def _cf_attr(*args)
  r_name = args.first
  args = args.slice(1, args.size)
  __t_stringish(r_name)
  args = args.map do |thing|
    if(thing.is_a?(Symbol))
      _process_key(thing, :force)
    else
      thing
    end
  end
  {'Fn::GetAtt' => [__attribute_key(r_name), *args]}
end

#_cf_base64(arg) ⇒ Hash Also known as: base64!

Fn::Base64 generator

Parameters:

  • arg (Object) —

    pass through

Returns:

  • (Hash) 


87
88
89
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 87

def _cf_base64(arg)
  {'Fn::Base64' => arg}
end

#_cf_get_azs(region = nil) ⇒ Hash Also known as: get_azs!, azs!

Fn::GetAZs generator

Parameters:

  • region (String, Symbol) (defaults to: nil) —

    String will pass through. Symbol will be converted to ref

Returns:

  • (Hash) 


96
97
98
99
100
101
102
103
104
105
106
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 96

def _cf_get_azs(region=nil)
  region = case region
           when Symbol
             _cf_ref(region)
           when NilClass
             ''
           else
             region
           end
  {'Fn::GetAZs' => region}
end

#_cf_join(*args) ⇒ Hash Also known as: join!

Fn::Join generator

Parameters:

  • args (Object)

Returns:

  • (Hash) 


15
16
17
18
19
20
21
22
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 15

def _cf_join(*args)
  options = args.detect{|i| i.is_a?(Hash) && i[:options]} || {:options => {}}
  args.delete(options)
  unless(args.size == 1)
    args = [args]
  end
  {'Fn::Join' => [options[:options][:delimiter] || '', *args]}
end

#_cf_map(thing, key, *suffix) ⇒ Hash Also known as: _cf_find_in_map, find_in_map!, map!

Fn::FindInMap generator

Parameters:

  • thing (String, Symbol) —

    thing to find

  • key (String, Symbol) —

    thing to search

  • suffix (Object) —

    additional args

Returns:

  • (Hash) 


43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 43

def _cf_map(thing, key, *suffix)
  __t_stringish(thing)
  suffix = suffix.map do |item|
    if(item.is_a?(Symbol))
      _process_key(item, :force)
    else
      item
    end
  end
  thing = __attribute_key(thing)
  if(key.is_a?(Symbol))
    key = ref!(key)
  end
  {'Fn::FindInMap' => [thing, key, *suffix]}
end

#_cf_ref(thing) ⇒ Hash Also known as: _ref, ref!

Note:

Symbol value will force key processing

Ref generator

Parameters:

  • thing (String, Symbol) —

    reference name

Returns:

  • (Hash) 


30
31
32
33
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 30

def _cf_ref(thing)
  __t_stringish(thing)
  {'Ref' => __attribute_key(thing)}
end

#_cf_select(index, item) ⇒ Hash Also known as: select!

Fn::Select generator

Parameters:

  • index (String, Symbol, Integer) —

    Symbol will be converted to ref

  • item (Object, Symbol) —

    Symbol will be converted to ref

Returns:

  • (Hash) 


115
116
117
118
119
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 115

def _cf_select(index, item)
  index = index.is_a?(Symbol) ? _cf_ref(index) : index
  item = _cf_ref(item) if item.is_a?(Symbol)
  {'Fn::Select' => [index, item]}
end

#_condition(name) ⇒ Hash Also known as: condition!

Condition generator

Parameters:

  • name (String, Symbol) —

    symbol will be processed

Returns:

  • (Hash) 


126
127
128
129
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 126

def _condition(name)
  __t_stringish(name)
  {'Condition' => __attribute_key(name)}
end

#_depends_on(*args) ⇒ Array<String> Also known as: depends_on!

Resource dependency generator

Parameters:

  • resource (Symbol, String, Array<Symbol, String>) —

    names

Returns:

  • (Array<String>) 


271
272
273
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 271

def _depends_on(*args)
  _set('DependsOn', [args].flatten.compact.map{|s| __attribute_key(s)})
end

#_equals(v1, v2) ⇒ Hash Also known as: equals!

Fn::Equals generator

Parameters:

  • v1 (Object)
  • v2 (Object)

Returns:

  • (Hash) 


180
181
182
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 180

def _equals(v1, v2)
  {'Fn::Equals' => _array(v1, v2)}
end

#_if(cond, true_value, false_value) ⇒ Hash Also known as: if!

Fn::If generator

Parameters:

  • cond (String, Symbol) —

    symbol will be case processed

  • true_value (Object)
  • false_value (Object)

Returns:

  • (Hash) 


149
150
151
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 149

def _if(cond, true_value, false_value)
  {'Fn::If' => _array(__attribute_key(cond), true_value, false_value)}
end

#_no_value ⇒ String Also known as: no_value!

No value generator

Returns:

  • (String) 


222
223
224
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 222

def _no_value
  _ref('AWS::NoValue')
end

#_not(arg) ⇒ Hash Also known as: not!

Fn::Not generator

Parameters:

  • arg (Object)

Returns:

  • (Hash) 


189
190
191
192
193
194
195
196
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 189

def _not(arg)
  if(arg.is_a?(String) || arg.is_a?(Symbol))
    arg = _condition(arg)
  else
    arg = _array(arg).first
  end
  {'Fn::Not' => [arg]}
end

#_notification_arns ⇒ Hash Also known as: notification_arns!

Notification ARNs generator

Returns:

  • (Hash) 


238
239
240
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 238

def _notification_arns
  _ref('AWS::NotificationARNs')
end

#_on_condition(name) ⇒ SparkleStruct Also known as: on_condition!

Note:

this is used to set a => “Name” into the current context, generally the top level of a resource

Condition setter

Parameters:

  • name (String, Symbol) —

    condition name

Returns:



138
139
140
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 138

def _on_condition(name)
  _set(*_condition(name).to_a.flatten)
end

#_or(*args) ⇒ Hash Also known as: or!

Fn::Or generator

Parameters:

  • v1 (Object)
  • v2 (Object)

Returns:

  • (Hash) 


204
205
206
207
208
209
210
211
212
213
214
215
216
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 204

def _or(*args)
  {
    'Fn::Or' => _array(
      *args.map{|v|
        if(v.is_a?(Symbol) || v.is_a?(String))
          _condition(v)
        else
          v
        end
      }
    )
  }
end

#_region ⇒ Hash Also known as: region!

Region generator

Returns:

  • (Hash) 


230
231
232
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 230

def _region
  _ref('AWS::Region')
end

#_stack_id ⇒ Hash Also known as: stack_id!

Stack ID generator

Returns:

  • (Hash) 


254
255
256
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 254

def _stack_id
  _ref('AWS::StackId')
end

#_stack_name ⇒ Hash Also known as: stack_name!

Stack name generator

Returns:

  • (Hash) 


262
263
264
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 262

def _stack_name
  _ref('AWS::StackName')
end

#_stack_output(stack_name, output_name) ⇒ Object Also known as: stack_output!

Reference output value from nested stack

Parameters:

  • stack_name (String, Symbol) —

    logical resource name of stack



280
281
282
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 280

def _stack_output(stack_name, output_name)
  _cf_attr(_process_key(stack_name), "Outputs.#{__attribute_key(output_name)}")
end

#_tags(hash) ⇒ SparkleStruct Also known as: tags!

Set tags on a resource

Parameters:

  • hash (Hash) —

    Key/value pair tags

Returns:



301
302
303
304
305
306
307
308
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 301

def _tags(hash)
  __t_hashish(hash)
  _set('Tags',
    hash.map{ |k, v|
      {'Key' => __attribute_key(k), 'Value' => v}
    }
  )
end

#taggable? ⇒ TrueClass, FalseClass

Returns resource can be tagged.

Returns:

  • (TrueClass, FalseClass) —

    resource can be tagged



286
287
288
289
290
291
292
293
294
295
 
# File 'lib/sparkle_formation/sparkle_attribute/aws.rb', line 286

def taggable?
  if(self[:type])
    resource = _self.lookup(self[:type].gsub('::', '_').downcase)
    resource && resource[:properties].include?('Tags')
  else
    if(_parent)
      _parent.taggable?
    end
  end
end