lib/async/queue.rb



# frozen_string_literal: true

# Released under the MIT License.
# Copyright, 2018-2022, by Samuel Williams.
# Copyright, 2019, by Ryan Musgrave.
# Copyright, 2020-2022, by Bruno Sutic.

require_relative 'notification'

module Async
	# A queue which allows items to be processed in order.
	# @public Since `stable-v1`.
	class Queue < Notification
		def initialize(parent: nil)
			super()
			
			@items = []
			@parent = parent
		end
		
		attr :items
		
		def size
			@items.size
		end

		def empty?
			@items.empty?
		end
		
		def <<(item)
			@items << item
			
			self.signal unless self.empty?
		end
		
		def enqueue(*items)
			@items.concat(items)
			
			self.signal unless self.empty?
		end
		
		def dequeue
			while @items.empty?
				self.wait
			end
			
			@items.shift
		end
		
		def async(parent: (@parent or Task.current), &block)
			while item = self.dequeue
				parent.async(item, &block)
			end
		end
		
		def each
			while item = self.dequeue
				yield item
			end
		end
	end
	
	# @public Since `stable-v1`.
	class LimitedQueue < Queue
		def initialize(limit = 1, **options)
			super(**options)
			
			@limit = limit
			
			@full = Notification.new
		end
		
		attr :limit
		
		# @returns [Boolean] Whether trying to enqueue an item would block.
		def limited?
			@items.size >= @limit
		end
		
		def <<(item)
			while limited?
				@full.wait
			end
			
			super
		end
		
		def enqueue *items
			while !items.empty?
				while limited?
					@full.wait
				end
				
				available = @limit - @items.size
				@items.concat(items.shift(available))
				
				self.signal unless self.empty?
			end
		end
		
		def dequeue
			item = super
			
			@full.signal
			
			return item
		end
	end
end