On this page
class Bundler::Worker
Constants
- POISON
Attributes
@return [String] the name of the worker
Public Class Methods
# File lib/bundler/worker.rb, line 24
def initialize(size, name, func)
@name = name
@request_queue = Queue.new
@response_queue = Queue.new
@func = func
@size = size
@threads = nil
SharedHelpers.trap("INT") { abort_threads }
end
Creates a worker pool of specified size
@param size [Integer] Size of pool @param name [String] name the name of the worker @param func [Proc] job to run in inside the worker pool
Public Instance Methods
# File lib/bundler/worker.rb, line 43
def deq
result = @response_queue.deq
raise result.exception if result.is_a?(WrappedException)
result
end
Retrieves results of job function being executed in worker pool
# File lib/bundler/worker.rb, line 37
def enq(obj)
create_threads unless @threads
@request_queue.enq obj
end
Enqueue a request to be executed in the worker pool
@param obj [String] mostly it is name of spec that should be downloaded
# File lib/bundler/worker.rb, line 49
def stop
stop_threads
end
Private Instance Methods
# File lib/bundler/worker.rb, line 78
def abort_threads
return unless @threads
Bundler.ui.debug("\n#{caller.join("\n")}")
@threads.each(&:exit)
exit 1
end
# File lib/bundler/worker.rb, line 63
def apply_func(obj, i)
@func.call(obj, i)
rescue Exception => e
WrappedException.new(e)
end
# File lib/bundler/worker.rb, line 85
def create_threads
creation_errors = []
@threads = Array.new(@size) do |i|
begin
Thread.start { process_queue(i) }.tap do |thread|
thread.name = "#{name} Worker ##{i}" if thread.respond_to?(:name=)
end
rescue ThreadError => e
creation_errors << e
nil
end
end.compact
return if creation_errors.empty?
message = "Failed to create threads for the #{name} worker: #{creation_errors.map(&:to_s).uniq.join(", ")}"
raise ThreadCreationError, message if @threads.empty?
Bundler.ui.info message
end
# File lib/bundler/worker.rb, line 55
def process_queue(i)
loop do
obj = @request_queue.deq
break if obj.equal? POISON
@response_queue.enq apply_func(obj, i)
end
end
# File lib/bundler/worker.rb, line 71
def stop_threads
return unless @threads
@threads.each { @request_queue.enq POISON }
@threads.each(&:join)
@threads = nil
end
Stop the worker threads by sending a poison object down the request queue so as worker threads after retrieving it, shut themselves down
Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.