shoryuken 3.0.9 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,192 @@
1
+ module Shoryuken
2
+ class Options
3
+ DEFAULTS = {
4
+ concurrency: 25,
5
+ queues: [],
6
+ aws: {},
7
+ delay: 0,
8
+ timeout: 8,
9
+ lifecycle_events: {
10
+ startup: [],
11
+ dispatch: [],
12
+ quiet: [],
13
+ shutdown: []
14
+ }
15
+ }.freeze
16
+
17
+ @@groups = {}
18
+ @@worker_registry = DefaultWorkerRegistry.new
19
+ @@active_job_queue_name_prefixing = false
20
+ @@sqs_client = nil
21
+ @@sqs_client_receive_message_opts = {}
22
+ @@start_callback = nil
23
+ @@stop_callback = nil
24
+
25
+ class << self
26
+ def add_group(group, concurrency)
27
+ groups[group] ||= {
28
+ concurrency: concurrency,
29
+ queues: []
30
+ }
31
+ end
32
+
33
+ def groups
34
+ @@groups
35
+ end
36
+
37
+ def add_queue(queue, weight, group)
38
+ weight.times do
39
+ groups[group][:queues] << queue
40
+ end
41
+ end
42
+
43
+ def ungrouped_queues
44
+ groups.values.flat_map { |options| options[:queues] }
45
+ end
46
+
47
+ def worker_registry
48
+ @@worker_registry
49
+ end
50
+
51
+ def worker_registry=(worker_registry)
52
+ @@worker_registry = worker_registry
53
+ end
54
+
55
+ def polling_strategy(group)
56
+ options[group].to_h.fetch(:polling_strategy, Polling::WeightedRoundRobin)
57
+ end
58
+
59
+ def start_callback
60
+ @@start_callback
61
+ end
62
+
63
+ def start_callback=(start_callback)
64
+ @@start_callback = start_callback
65
+ end
66
+
67
+ def stop_callback
68
+ @@stop_callback
69
+ end
70
+
71
+ def stop_callback=(stop_callback)
72
+ @@stop_callback = stop_callback
73
+ end
74
+
75
+ def active_job_queue_name_prefixing
76
+ @@active_job_queue_name_prefixing
77
+ end
78
+
79
+ def active_job_queue_name_prefixing=(active_job_queue_name_prefixing)
80
+ @@active_job_queue_name_prefixing = active_job_queue_name_prefixing
81
+ end
82
+
83
+ def sqs_client
84
+ @@sqs_client ||= Aws::SQS::Client.new
85
+ end
86
+
87
+ def sqs_client=(sqs_client)
88
+ @@sqs_client = sqs_client
89
+ end
90
+
91
+ def sqs_client_receive_message_opts
92
+ @@sqs_client_receive_message_opts
93
+ end
94
+
95
+ def sqs_client_receive_message_opts=(sqs_client_receive_message_opts)
96
+ @@sqs_client_receive_message_opts['default'] = sqs_client_receive_message_opts
97
+ end
98
+
99
+ def options
100
+ @@options ||= DEFAULTS.dup
101
+ end
102
+
103
+ def logger
104
+ Shoryuken::Logging.logger
105
+ end
106
+
107
+ def register_worker(*args)
108
+ @@worker_registry.register_worker(*args)
109
+ end
110
+
111
+ def configure_server
112
+ yield self if server?
113
+ end
114
+
115
+ def server_middleware
116
+ @@server_chain ||= default_server_middleware
117
+ yield @@server_chain if block_given?
118
+ @@server_chain
119
+ end
120
+
121
+ def configure_client
122
+ yield self unless server?
123
+ end
124
+
125
+ def client_middleware
126
+ @@client_chain ||= default_client_middleware
127
+ yield @@client_chain if block_given?
128
+ @@client_chain
129
+ end
130
+
131
+ def default_worker_options
132
+ @@default_worker_options ||= {
133
+ 'queue' => 'default',
134
+ 'delete' => false,
135
+ 'auto_delete' => false,
136
+ 'auto_visibility_timeout' => false,
137
+ 'retry_intervals' => nil,
138
+ 'batch' => false
139
+ }
140
+ end
141
+
142
+ def default_worker_options=(default_worker_options)
143
+ @@default_worker_options = default_worker_options
144
+ end
145
+
146
+ def on_start(&block)
147
+ @@start_callback = block
148
+ end
149
+
150
+ def on_stop(&block)
151
+ @@stop_callback = block
152
+ end
153
+
154
+ # Register a block to run at a point in the Shoryuken lifecycle.
155
+ # :startup, :quiet or :shutdown are valid events.
156
+ #
157
+ # Shoryuken.configure_server do |config|
158
+ # config.on(:shutdown) do
159
+ # puts "Goodbye cruel world!"
160
+ # end
161
+ # end
162
+ def on(event, &block)
163
+ fail ArgumentError, "Symbols only please: #{event}" unless event.is_a?(Symbol)
164
+ fail ArgumentError, "Invalid event name: #{event}" unless options[:lifecycle_events].key?(event)
165
+ options[:lifecycle_events][event] << block
166
+ end
167
+
168
+ private
169
+
170
+ def default_server_middleware
171
+ Middleware::Chain.new do |m|
172
+ m.add Middleware::Server::Timing
173
+ m.add Middleware::Server::ExponentialBackoffRetry
174
+ m.add Middleware::Server::AutoDelete
175
+ m.add Middleware::Server::AutoExtendVisibility
176
+ if defined?(::ActiveRecord::Base)
177
+ require 'shoryuken/middleware/server/active_record'
178
+ m.add Middleware::Server::ActiveRecord
179
+ end
180
+ end
181
+ end
182
+
183
+ def default_client_middleware
184
+ Middleware::Chain.new
185
+ end
186
+
187
+ def server?
188
+ defined?(Shoryuken::CLI)
189
+ end
190
+ end
191
+ end
192
+ end
@@ -0,0 +1,67 @@
1
+ module Shoryuken
2
+ module Polling
3
+ QueueConfiguration = Struct.new(:name, :options) do
4
+ def hash
5
+ name.hash
6
+ end
7
+
8
+ def ==(other)
9
+ case other
10
+ when String
11
+ if options.empty?
12
+ name == other
13
+ else
14
+ false
15
+ end
16
+ else
17
+ super
18
+ end
19
+ end
20
+
21
+ alias_method :eql?, :==
22
+
23
+ def to_s
24
+ if options.empty?
25
+ name
26
+ else
27
+ "#<QueueConfiguration #{name} options=#{options.inspect}>"
28
+ end
29
+ end
30
+ end
31
+
32
+ class BaseStrategy
33
+ include Util
34
+
35
+ def next_queue
36
+ fail NotImplementedError
37
+ end
38
+
39
+ def messages_found(queue, messages_found)
40
+ fail NotImplementedError
41
+ end
42
+
43
+ def active_queues
44
+ fail NotImplementedError
45
+ end
46
+
47
+ def ==(other)
48
+ case other
49
+ when Array
50
+ @queues == other
51
+ else
52
+ if other.respond_to?(:active_queues)
53
+ active_queues == other.active_queues
54
+ else
55
+ false
56
+ end
57
+ end
58
+ end
59
+
60
+ private
61
+
62
+ def delay
63
+ Shoryuken.options[:delay].to_f
64
+ end
65
+ end
66
+ end
67
+ end
@@ -0,0 +1,77 @@
1
+ module Shoryuken
2
+ module Polling
3
+ class StrictPriority < BaseStrategy
4
+ def initialize(queues)
5
+ # Priority ordering of the queues, highest priority first
6
+ @queues = queues
7
+ .group_by { |q| q }
8
+ .sort_by { |_, qs| -qs.count }
9
+ .map(&:first)
10
+
11
+ # Pause status of the queues, default to past time (unpaused)
12
+ @paused_until = queues
13
+ .each_with_object(Hash.new) { |queue, h| h[queue] = Time.at(0) }
14
+
15
+ # Start queues at 0
16
+ reset_next_queue
17
+ end
18
+
19
+ def next_queue
20
+ next_queue = next_active_queue
21
+ next_queue.nil? ? nil : QueueConfiguration.new(next_queue, {})
22
+ end
23
+
24
+ def messages_found(queue, messages_found)
25
+ if messages_found == 0
26
+ pause(queue)
27
+ else
28
+ reset_next_queue
29
+ end
30
+ end
31
+
32
+ def active_queues
33
+ @queues
34
+ .reverse
35
+ .map.with_index(1)
36
+ .reject { |q, _| queue_paused?(q) }
37
+ .reverse
38
+ end
39
+
40
+ private
41
+
42
+ def next_active_queue
43
+ reset_next_queue if queues_unpaused_since?
44
+
45
+ size = @queues.length
46
+ size.times do
47
+ queue = @queues[@next_queue_index]
48
+ @next_queue_index = (@next_queue_index + 1) % size
49
+ return queue unless queue_paused?(queue)
50
+ end
51
+
52
+ nil
53
+ end
54
+
55
+ def queues_unpaused_since?
56
+ last = @last_unpause_check
57
+ now = @last_unpause_check = Time.now
58
+
59
+ last && @paused_until.values.any? { |t| t > last && t <= now }
60
+ end
61
+
62
+ def reset_next_queue
63
+ @next_queue_index = 0
64
+ end
65
+
66
+ def queue_paused?(queue)
67
+ @paused_until[queue] > Time.now
68
+ end
69
+
70
+ def pause(queue)
71
+ return unless delay > 0
72
+ @paused_until[queue] = Time.now + delay
73
+ logger.debug "Paused #{queue}"
74
+ end
75
+ end
76
+ end
77
+ end
@@ -0,0 +1,66 @@
1
+ module Shoryuken
2
+ module Polling
3
+ class WeightedRoundRobin < BaseStrategy
4
+ def initialize(queues)
5
+ @initial_queues = queues
6
+ @queues = queues.dup.uniq
7
+ @paused_queues = []
8
+ end
9
+
10
+ def next_queue
11
+ unpause_queues
12
+ queue = @queues.shift
13
+ return nil if queue.nil?
14
+
15
+ @queues << queue
16
+ QueueConfiguration.new(queue, {})
17
+ end
18
+
19
+ def messages_found(queue, messages_found)
20
+ if messages_found == 0
21
+ pause(queue)
22
+ return
23
+ end
24
+
25
+ maximum_weight = maximum_queue_weight(queue)
26
+ current_weight = current_queue_weight(queue)
27
+ if maximum_weight > current_weight
28
+ logger.info { "Increasing #{queue} weight to #{current_weight + 1}, max: #{maximum_weight}" }
29
+ @queues << queue
30
+ end
31
+ end
32
+
33
+ def active_queues
34
+ unparse_queues(@queues)
35
+ end
36
+
37
+ private
38
+
39
+ def pause(queue)
40
+ return unless @queues.delete(queue)
41
+ @paused_queues << [Time.now + delay, queue]
42
+ logger.debug "Paused #{queue}"
43
+ end
44
+
45
+ def unpause_queues
46
+ return if @paused_queues.empty?
47
+ return if Time.now < @paused_queues.first[0]
48
+ pause = @paused_queues.shift
49
+ @queues << pause[1]
50
+ logger.debug "Unpaused #{pause[1]}"
51
+ end
52
+
53
+ def current_queue_weight(queue)
54
+ queue_weight(@queues, queue)
55
+ end
56
+
57
+ def maximum_queue_weight(queue)
58
+ queue_weight(@initial_queues, queue)
59
+ end
60
+
61
+ def queue_weight(queues, queue)
62
+ queues.count { |q| q == queue }
63
+ end
64
+ end
65
+ end
66
+ end
@@ -2,35 +2,41 @@ module Shoryuken
2
2
  class Processor
3
3
  include Util
4
4
 
5
- def initialize(manager)
6
- @manager = manager
5
+ attr_reader :queue, :sqs_msg
6
+
7
+ def initialize(queue, sqs_msg)
8
+ @queue = queue
9
+ @sqs_msg = sqs_msg
7
10
  end
8
11
 
9
- def process(queue, sqs_msg)
10
- worker = Shoryuken.worker_registry.fetch_worker(queue, sqs_msg)
11
- body = get_body(worker.class, sqs_msg)
12
+ def process
13
+ return logger.error { "No worker found for #{queue}" } unless worker
12
14
 
13
15
  worker.class.server_middleware.invoke(worker, queue, sqs_msg, body) do
14
16
  worker.perform(sqs_msg, body)
15
17
  end
16
18
  rescue Exception => ex
17
- @manager.processor_failed(ex)
19
+ logger.error { "Processor failed: #{ex.message}" }
20
+ logger.error { ex.backtrace.join("\n") } unless ex.backtrace.nil?
21
+
18
22
  raise
19
- ensure
20
- @manager.processor_done(queue)
21
23
  end
22
24
 
23
25
  private
24
26
 
25
- def get_body(worker_class, sqs_msg)
26
- if sqs_msg.is_a? Array
27
- sqs_msg.map { |m| parse_body(worker_class, m) }
28
- else
29
- parse_body(worker_class, sqs_msg)
30
- end
27
+ def worker
28
+ @_worker ||= Shoryuken.worker_registry.fetch_worker(queue, sqs_msg)
31
29
  end
32
30
 
33
- def parse_body(worker_class, sqs_msg)
31
+ def worker_class
32
+ worker.class
33
+ end
34
+
35
+ def body
36
+ @_body ||= sqs_msg.is_a?(Array) ? sqs_msg.map(&method(:parse_body)) : parse_body(sqs_msg)
37
+ end
38
+
39
+ def parse_body(sqs_msg)
34
40
  body_parser = worker_class.get_shoryuken_options['body_parser']
35
41
 
36
42
  case body_parser
@@ -50,9 +56,6 @@ module Shoryuken
50
56
  body_parser.load(sqs_msg.body)
51
57
  end
52
58
  end
53
- rescue => ex
54
- logger.error { "Error parsing the message body: #{ex.message}\nbody_parser: #{body_parser}\nsqs_msg.body: #{sqs_msg.body}" }
55
- raise
56
59
  end
57
60
  end
58
61
  end
@@ -49,21 +49,22 @@ module Shoryuken
49
49
 
50
50
  private
51
51
 
52
- def set_name_and_url(name_or_url)
53
- if name_or_url.start_with?('https://sqs.')
54
- self.name = name_or_url.split('/').last
55
- self.url = name_or_url
56
-
57
- # Test if the supplied URL is valid
58
- fifo?
59
- else
60
- self.name = name_or_url
61
- self.url = client.get_queue_url(queue_name: name_or_url).queue_url
62
- end
52
+ def set_name(name)
53
+ self.name = name
54
+ self.url = client.get_queue_url(queue_name: name).queue_url
63
55
  rescue Aws::Errors::NoSuchEndpointError, Aws::SQS::Errors::NonExistentQueue => ex
64
56
  raise ex, "The specified queue #{name} does not exist."
65
57
  end
66
58
 
59
+ def set_url(url)
60
+ self.name = url.split('/').last
61
+ self.url = url
62
+ end
63
+
64
+ def set_name_and_url(name_or_url)
65
+ name_or_url.start_with?('https://sqs.') ? set_url(name_or_url) : set_name(name_or_url)
66
+ end
67
+
67
68
  def queue_attributes
68
69
  # Note: Retrieving all queue attributes as requesting `FifoQueue` on non-FIFO queue raises error.
69
70
  # See issue: https://github.com/aws/aws-sdk-ruby/issues/1350
@@ -19,7 +19,7 @@ module Shoryuken
19
19
  def run(options)
20
20
  self_read, self_write = IO.pipe
21
21
 
22
- %w(INT TERM USR1 USR2 TTIN).each do |sig|
22
+ %w(INT TERM USR1 TTIN).each do |sig|
23
23
  begin
24
24
  trap sig do
25
25
  self_write.puts(sig)
@@ -43,22 +43,15 @@ module Shoryuken
43
43
 
44
44
  @launcher = Shoryuken::Launcher.new
45
45
 
46
- if (callback = Shoryuken.start_callback)
47
- logger.info { 'Calling on_start callback' }
48
- callback.call
49
- end
50
-
51
- fire_event(:startup)
52
-
53
46
  begin
54
- @launcher.run
47
+ @launcher.start
55
48
 
56
49
  while (readable_io = IO.select([self_read]))
57
50
  signal = readable_io.first[0].gets.strip
58
51
  handle_signal(signal)
59
52
  end
60
53
  rescue Interrupt
61
- @launcher.stop(shutdown: true)
54
+ @launcher.stop!
62
55
  exit 0
63
56
  end
64
57
  end
@@ -110,7 +103,6 @@ module Shoryuken
110
103
  logger.info { 'Received USR1, will soft shutdown down' }
111
104
 
112
105
  @launcher.stop
113
- fire_event(:quiet, true)
114
106
  exit 0
115
107
  end
116
108
 
@@ -126,13 +118,9 @@ module Shoryuken
126
118
  end
127
119
 
128
120
  def handle_signal(sig)
129
- logger.info { "Got #{sig} signal" }
130
-
131
121
  case sig
132
122
  when 'USR1' then execute_soft_shutdown
133
123
  when 'TTIN' then print_threads_backtrace
134
- when 'USR2'
135
- logger.warn { "Received #{sig}, will do nothing. To execute soft shutdown, please send USR1" }
136
124
  else
137
125
  logger.info { "Received #{sig}, will shutdown down" }
138
126
 
@@ -1,3 +1,3 @@
1
1
  module Shoryuken
2
- VERSION = '3.0.9'.freeze
2
+ VERSION = '3.1.0'.freeze
3
3
  end