Contents

# frozen_string_literal: true

# Released under the MIT License.
# Copyright, 2019-2022, by Samuel Williams.
# Copyright, 2022, by Anton Sozontov.

require_relative 'forked'
require_relative 'threaded'

module Async
	module Container
		# Provides a hybrid multi-process multi-thread container.
		class Hybrid < Forked
			# Run multiple instances of the same block in the container.
			# @parameter count [Integer] The number of instances to start.
			# @parameter forks [Integer] The number of processes to fork.
			# @parameter threads [Integer] the number of threads to start.
			def run(count: nil, forks: nil, threads: nil, **options, &block)
				processor_count = Container.processor_count
				count ||= processor_count ** 2
				forks ||= [processor_count, count].min
				threads ||= (count / forks).ceil
				
				forks.times do
					self.spawn(**options) do |instance|
						container = Threaded.new
						
						container.run(count: threads, **options, &block)
						
						container.wait_until_ready
						instance.ready!
						
						container.wait
					rescue Async::Container::Terminate
						# Stop it immediately:
						container.stop(false)
					ensure
						# Stop it gracefully (also code path for Interrupt):
						container.stop
					end
				end
				
				return self
			end
		end
	end
end

Version data entries

7 entries across 7 versions & 1 rubygems

Version	Path
async-container-0.18.3	lib/async/container/hybrid.rb
async-container-0.18.2	lib/async/container/hybrid.rb
async-container-0.18.1	lib/async/container/hybrid.rb
async-container-0.18.0	lib/async/container/hybrid.rb
async-container-0.17.1	lib/async/container/hybrid.rb
async-container-0.17.0	lib/async/container/hybrid.rb
async-container-0.16.13	lib/async/container/hybrid.rb