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 



102
103
104
105
106
107
 
# File 'lib/jets/lambda/task.rb', line 102

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) 


32
33
34
 
# File 'lib/jets/lambda/task.rb', line 32

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

#full_handler(handler_function) ⇒ Object 



79
80
81
 
# File 'lib/jets/lambda/task.rb', line 79

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



73
74
75
76
77
 
# File 'lib/jets/lambda/task.rb', line 73

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 



87
88
89
90
91
 
# File 'lib/jets/lambda/task.rb', line 87

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

#handler_path ⇒ Object 



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

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

#lang_ext ⇒ Object 



41
42
43
 
# File 'lib/jets/lambda/task.rb', line 41

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 



93
94
95
 
# File 'lib/jets/lambda/task.rb', line 93

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
 
# 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 == ''

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

#replacements ⇒ Object 



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

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