Class: Jets::Lambda::Definition

Inherits:
Object
  • Object
show all
Includes:
Util::Camelize
Defined in:
lib/jets/lambda/definition.rb

Constant Summary collapse

@@lang_exts = 
{
  ruby: '.rb',
  python: '.py',
  node: '.js',
}

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Util::Camelize

#camelize

Constructor Details

#initialize(class_name, meth, options = {}) ⇒ Definition

Returns a new instance of Definition.



7
8
9
10
11
12
13
14
15
16
17
18
 
# File 'lib/jets/lambda/definition.rb', line 7

def initialize(class_name, meth, options={})
  @class_name = class_name.to_s
  @meth = meth
  @options = options
  @type = options[:type] || get_type  # controller, job, or function
  @properties = camelize(options[:properties]) || {}
  @iam_policy = options[:iam_policy]
  @managed_iam_policy = options[:managed_iam_policy]
  @lang = options[:lang] || :ruby
  @associated_resources = options[:associated_resources] || {}
  @replacements = options[:replacements] || {} # added to baseline replacements
end

Instance Attribute Details

#associated_resources ⇒ Object (readonly)

Returns the value of attribute associated_resources.



6
7
8
 
# File 'lib/jets/lambda/definition.rb', line 6

def associated_resources
  @associated_resources
end

#class_name ⇒ Object

Returns the value of attribute class_name.



5
6
7
 
# File 'lib/jets/lambda/definition.rb', line 5

def class_name
  @class_name
end

#iam_policy ⇒ Object (readonly)

Returns the value of attribute iam_policy.



6
7
8
 
# File 'lib/jets/lambda/definition.rb', line 6

def iam_policy
  @iam_policy
end

#lang ⇒ Object (readonly)

Returns the value of attribute lang.



6
7
8
 
# File 'lib/jets/lambda/definition.rb', line 6

def lang
  @lang
end

#managed_iam_policy ⇒ Object (readonly)

Returns the value of attribute managed_iam_policy.



6
7
8
 
# File 'lib/jets/lambda/definition.rb', line 6

def managed_iam_policy
  @managed_iam_policy
end

#meth ⇒ Object (readonly)

Returns the value of attribute meth.



6
7
8
 
# File 'lib/jets/lambda/definition.rb', line 6

def meth
  @meth
end

#properties ⇒ Object (readonly)

Returns the value of attribute properties.



6
7
8
 
# File 'lib/jets/lambda/definition.rb', line 6

def properties
  @properties
end

#type ⇒ Object

Returns the value of attribute type.



5
6
7
 
# File 'lib/jets/lambda/definition.rb', line 5

def type
  @type
end

Instance Method Details

#base_replacements ⇒ Object 



108
109
110
 
# File 'lib/jets/lambda/definition.rb', line 108

def base_replacements
  { namespace: namespace }
end

#build_function_iam? ⇒ Boolean

Returns:

  • (Boolean) 


38
39
40
 
# File 'lib/jets/lambda/definition.rb', line 38

def build_function_iam?
  !!(@iam_policy || @managed_iam_policy)
end

#full_handler(handler_function) ⇒ Object 



85
86
87
 
# File 'lib/jets/lambda/definition.rb', line 85

def full_handler(handler_function)
  "#{handler_base}.#{handler_function}"
end

#get_type ⇒ Object

The get_type method works for controller and job classes.

Usually able to get the type from the class name. Examples:

PostsController => controller
HardJob => job

However, for function types, we are not able to get the type for multiple of reasons. First, function types are allowed to be named with or without _function. Examples:

path => class => type
app/functions/hello.rb => Hello => function
app/functions/hello_function.rb => HelloFunction => function

The second reason is that functions are not regular ruby classes. Instead they are anonymous classes created with Class.new. When classes are created with Class.new the method_added hook has “” (blank string) as the self class name. We add the class_type to the task later on as we are constructing the class as part of the Class.new logic.

For controller and job standard ruby classes though it can easily be determinated as part of initialization. So we get the type for convenience then.

For anonymous function classes, we just set to nil and will later fix in FunctionConstructor.

Returns: “controller”, “job” or nil



79
80
81
82
83
 
# File 'lib/jets/lambda/definition.rb', line 79

def get_type
  unless @class_name.empty? # when anonymous class is created with Class.new
    @class_name.underscore.split('_').last # controller, job or rule
  end
end

#handler_base ⇒ Object 



93
94
95
96
97
 
# File 'lib/jets/lambda/definition.rb', line 93

def handler_base
  base = "handlers/#{@type.pluralize}/#{@class_name.underscore}"
  base += "/#{@lang}" if @lang != :ruby
  base += "/#{@meth}"
end

#handler_path ⇒ Object 



89
90
91
 
# File 'lib/jets/lambda/definition.rb', line 89

def handler_path
  "#{handler_base}#{lang_ext}"
end

#lang_ext ⇒ Object 



47
48
49
 
# File 'lib/jets/lambda/definition.rb', line 47

def lang_ext
  @@lang_exts[@lang]
end

#name ⇒ Object 



20
21
22
 
# File 'lib/jets/lambda/definition.rb', line 20

def name
  @meth
end

#namespace ⇒ Object 



112
113
114
115
116
 
# File 'lib/jets/lambda/definition.rb', line 112

def namespace
  ns = @class_name.gsub('::','').camelize
  ns += @meth.to_s.camelize if @meth
  ns
end

#poly_src_path ⇒ Object 



99
100
101
 
# File 'lib/jets/lambda/definition.rb', line 99

def poly_src_path
  handler_path.sub("handlers/", "app/")
end

#public_meth? ⇒ Boolean

Returns:

  • (Boolean) 


24
25
26
27
28
29
30
31
32
33
34
35
36
 
# File 'lib/jets/lambda/definition.rb', line 24

def public_meth?
  # For anonymous classes (app/functions/hello.rb) the class name will be blank.
  # These types of classes are treated specially and has only one handler method
  # that is registered. So we know it is public.
  return true if @class_name.nil? || @class_name == ''

  # Consider all polymorphic methods public for now
  return true if @lang != :ruby

  klass = @class_name.constantize
  public_methods = klass.public_instance_methods
  public_methods.include?(meth.to_sym)
end

#replacements ⇒ Object 



103
104
105
106
 
# File 'lib/jets/lambda/definition.rb', line 103

def replacements
  # Merge in the custom replacements specific to each app class: ConfigRule, Job, etc.
  base_replacements.merge(@replacements)
end