Class: Jets::Lambda::Task

Inherits:
Object
  • Object
show all
Defined in:
lib/jets/lambda/task.rb

Constant Summary collapse

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

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

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

Returns a new instance of Task.



4
5
6
7
8
9
10
11
12
13
14
15
 
# File 'lib/jets/lambda/task.rb', line 4

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 = 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.



3
4
5
 
# File 'lib/jets/lambda/task.rb', line 3

def associated_resources
  @associated_resources
end

#class_name ⇒ Object

Returns the value of attribute class_name.



2
3
4
 
# File 'lib/jets/lambda/task.rb', line 2

def class_name
  @class_name
end

#iam_policy ⇒ Object (readonly)

Returns the value of attribute iam_policy.



3
4
5
 
# File 'lib/jets/lambda/task.rb', line 3

def iam_policy
  @iam_policy
end

#lang ⇒ Object (readonly)

Returns the value of attribute lang.



3
4
5
 
# File 'lib/jets/lambda/task.rb', line 3

def lang
  @lang
end

#managed_iam_policy ⇒ Object (readonly)

Returns the value of attribute managed_iam_policy.



3
4
5
 
# File 'lib/jets/lambda/task.rb', line 3

def managed_iam_policy
  @managed_iam_policy
end

#meth ⇒ Object (readonly)

Returns the value of attribute meth.



3
4
5
 
# File 'lib/jets/lambda/task.rb', line 3

def meth
  @meth
end

#properties ⇒ Object (readonly)

Returns the value of attribute properties.



3
4
5
 
# File 'lib/jets/lambda/task.rb', line 3

def properties
  @properties
end

#type ⇒ Object

Returns the value of attribute type.



2
3
4
 
# File 'lib/jets/lambda/task.rb', line 2

def type
  @type
end

Instance Method Details

#baseline_replacements ⇒ Object 



105
106
107
108
109
110
 
# File 'lib/jets/lambda/task.rb', line 105

def baseline_replacements
  {
    # camelized because used in not just keys but common used in values
    namespace: @meth.to_s.camelize,
  }
end

#build_function_iam? ⇒ Boolean

Returns:

  • (Boolean) 


35
36
37
 
# File 'lib/jets/lambda/task.rb', line 35

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

#full_handler(handler_function) ⇒ Object 



82
83
84
 
# File 'lib/jets/lambda/task.rb', line 82

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



76
77
78
79
80
 
# File 'lib/jets/lambda/task.rb', line 76

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 



90
91
92
93
94
 
# File 'lib/jets/lambda/task.rb', line 90

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

#handler_path ⇒ Object 



86
87
88
 
# File 'lib/jets/lambda/task.rb', line 86

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

#lang_ext ⇒ Object 



44
45
46
 
# File 'lib/jets/lambda/task.rb', line 44

def lang_ext
  @@lang_exts[@lang]
end

#name ⇒ Object 



17
18
19
 
# File 'lib/jets/lambda/task.rb', line 17

def name
  @meth
end

#poly_src_path ⇒ Object 



96
97
98
 
# File 'lib/jets/lambda/task.rb', line 96

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

#public_meth? ⇒ Boolean

Returns:

  • (Boolean) 


21
22
23
24
25
26
27
28
29
30
31
32
33
 
# File 'lib/jets/lambda/task.rb', line 21

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 



100
101
102
103
 
# File 'lib/jets/lambda/task.rb', line 100

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