async 1.25.2 → 1.28.0

data/spec/async/condition_spec.rb

@@ -1,72 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'async/rspec'
-require 'async/condition'
-
-require_relative 'condition_examples'
-
-RSpec.describe Async::Condition do
-	include_context Async::RSpec::Reactor
-	
-	it 'should continue after condition is signalled' do
-		task = reactor.async do
-			subject.wait
-		end
-		
-		expect(task.status).to be :running
-		
-		# This will cause the task to exit:
-		subject.signal
-		
-		expect(task.status).to be :complete
-		
-		task.stop
-	end
-	
-	it 'can stop nested task' do
-		producer = nil
-		
-		consumer = reactor.async do |task|
-			condition = Async::Condition.new
-			
-			producer = task.async do |subtask|
-				subtask.yield
-				condition.signal
-				subtask.sleep(10)
-			end
-			
-			condition.wait
-			expect do
-				producer.stop
-			end.to_not raise_error
-		end
-		
-		consumer.wait
-		producer.wait
-		
-		expect(producer.status).to be :stopped
-		expect(consumer.status).to be :complete
-	end
-	
-	it_behaves_like Async::Condition
-end

data/spec/async/logger_spec.rb

@@ -1,65 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'async'
-require 'async/logger'
-require 'console/capture'
-
-RSpec.describe 'Async.logger' do
-	let(:name) {"nested"}
-	let(:message) {"Talk is cheap. Show me the code."}
-	
-	let(:capture) {Console::Capture.new}
-	let(:logger) {Console::Logger.new(capture, name: name)}
-	
-	it "can use nested logger" do
-		Async(logger: logger) do |task|
-			expect(task.logger).to be == logger
-			logger.warn message
-		end.wait
-		
-		expect(capture.events.last).to include({
-			severity: :warn,
-			name: name,
-			subject: message,
-		})
-	end
-	
-	it "can change nested logger" do
-		Async do |parent|
-			parent.async(logger: logger) do |task|
-				expect(task.logger).to be == logger
-				expect(Async.logger).to be == logger
-			end.wait
-		end.wait
-	end
-	
-	it "can use parent logger" do
-		Async(logger: logger) do |parent|
-			child = parent.async{|task| task.yield}
-			
-			expect(parent.logger).to be == logger
-			expect(child.logger).to be == logger
-			expect(Async.logger).to be == logger
-		end.wait
-	end
-end

data/spec/async/node_spec.rb

@@ -1,193 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'async/node'
-
-RSpec.describe Async::Node do
-	describe '#parent=' do
-		let(:child) {Async::Node.new(subject)}
-		
-		it "should construct nested tree" do
-			expect(child.parent).to be subject
-			expect(subject.children).to include(child)
-		end
-		
-		it "should break nested tree" do
-			child.parent = nil
-			
-			expect(child.parent).to be_nil
-			expect(subject.children).to be_nil
-		end
-		
-		it "can consume bottom to top" do
-			child.consume
-			
-			expect(child.parent).to be_nil
-			expect(subject.children).to be_nil
-		end
-	end
-	
-	describe '#print_hierarchy' do
-		let(:buffer) {StringIO.new}
-		let(:output) {buffer.string}
-		let(:lines) {output.lines}
-		
-		let!(:child) {Async::Node.new(subject)}
-		
-		it "can print hierarchy to bufffer" do
-			subject.print_hierarchy(buffer)
-			
-			expect(lines.size).to be 2
-			
-			expect(lines[0]).to be =~ /#<Async::Node:0x\h+>\n/
-			expect(lines[1]).to be =~ /\t#<Async::Node:0x\h+>\n/
-		end
-	end
-	
-	describe '#consume' do
-		it "can't consume middle node" do
-			middle = Async::Node.new(subject)
-			bottom = Async::Node.new(middle)
-			
-			expect(bottom.parent).to be middle
-			
-			middle.consume
-			
-			expect(bottom.parent).to be middle
-		end
-		
-		it "can consume node while enumerating children" do
-			3.times do
-				Async::Node.new(subject)
-			end
-			
-			children = subject.children.each.to_a
-			expect(subject.children.size).to be 3
-			
-			enumerated = []
-			
-			subject.children.each do |child|
-				child.consume
-				enumerated << child
-			end
-			
-			expect(enumerated).to be == children
-		end
-	end
-	
-	describe '#annotate' do
-		let(:annotation) {'reticulating splines'}
-		
-		it "should have no annotation by default" do
-			expect(subject.annotation).to be_nil
-		end
-		
-		it 'should output annotation when invoking #to_s' do
-			subject.annotate(annotation) do
-				expect(subject.to_s).to include(annotation)
-			end
-		end
-		
-		it 'can assign annotation' do
-			subject.annotate(annotation)
-			
-			expect(subject.annotation).to be == annotation
-		end
-	end
-	
-	describe '#transient' do
-		it 'can move transient child to parent' do
-			# This example represents a persistent web connection (middle) with a background reader (child). We look at how when that connection goes out of scope, what happens to the child.
-			
-			# subject -> middle -> child (transient)
-			
-			middle = Async::Node.new(subject)
-			child = Async::Node.new(middle, transient: true)
-			
-			expect(child).to be_transient
-			expect(middle).to be_finished
-			
-			allow(child).to receive(:finished?).and_return(false)
-			
-			middle.consume
-			
-			# subject -> child (transient)
-			expect(child.parent).to be subject
-			expect(subject.children).to include(child)
-			expect(subject.children).to_not include(middle)
-			
-			expect(child).to_not be_finished
-			expect(subject).to be_finished
-			
-			expect(child).to receive(:stop)
-			subject.stop
-		end
-		
-		it 'can move transient sibling to parent' do
-			# This example represents a server task (middle) which has a single task listening on incoming connections (child2), and a transient task which is monitoring those connections/some shared resource (child1). We look at what happens when the server listener finishes.
-			
-			# subject -> middle -> child1 (transient)
-			#                   -> child2
-			middle = Async::Node.new(subject, annotation: "middle")
-			child1 = Async::Node.new(middle, transient: true, annotation: "child1")
-			child2 = Async::Node.new(middle, annotation: "child2")
-			
-			allow(child1).to receive(:finished?).and_return(false)
-			
-			middle.consume
-			
-			# subject -> middle -> child1 (transient)
-			#                   -> child2
-			expect(child1.parent).to be middle
-			expect(child2.parent).to be middle
-			expect(middle.parent).to be subject
-			expect(subject.children).to include(middle)
-			expect(middle.children).to include(child1)
-			expect(middle.children).to include(child2)
-			
-			child2.consume
-			
-			# subject -> child1 (transient)
-			expect(child1.parent).to be subject
-			expect(child2.parent).to be_nil
-			expect(middle.parent).to be_nil
-			expect(subject.children).to include(child1)
-			expect(middle.children).to be_nil
-		end
-		
-		it 'ignores non-transient children of transient parent' do
-			# subject -> middle (transient) -> child
-			middle = Async::Node.new(subject, transient: true)
-			child = Async::Node.new(middle)
-			
-			allow(middle).to receive(:finished?).and_return(false)
-			
-			child.consume
-			
-			# subject -> middle (transient)
-			expect(child.parent).to be_nil
-			expect(middle.parent).to be subject
-			expect(subject.children).to include(middle)
-			expect(middle.children).to be_nil
-		end
-	end
-end

data/spec/async/notification_spec.rb

@@ -1,66 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'async/rspec'
-require 'async/notification'
-
-require_relative 'condition_examples'
-
-RSpec.describe Async::Notification do
-	include_context Async::RSpec::Reactor
-	
-	it 'should continue after notification is signalled' do
-		sequence = []
-		
-		task = reactor.async do
-			sequence << :waiting
-			subject.wait
-			sequence << :resumed
-		end
-		
-		expect(task.status).to be :running
-		
-		sequence << :running
-		# This will cause the task to exit:
-		subject.signal
-		sequence << :signalled
-		
-		expect(task.status).to be :running
-		
-		sequence << :yielding
-		reactor.yield
-		sequence << :finished
-		
-		expect(task.status).to be :complete
-		
-		expect(sequence).to be == [
-			:waiting,
-			:running,
-			:signalled,
-			:yielding,
-			:resumed,
-			:finished
-		]
-	end
-	
-	it_behaves_like Async::Condition
-end

data/spec/async/performance_spec.rb

@@ -1,72 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright, 2019, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'benchmark/ips'
-require 'async'
-
-RSpec.describe Async::Wrapper do
-	let(:pipe) {IO.pipe}
-	
-	after do
-		pipe.each(&:close)
-	end
-	
-	let(:input) {described_class.new(pipe.first)}
-	let(:output) {described_class.new(pipe.last)}
-	
-	it "should be fast to wait until readable" do
-		Benchmark.ips do |x|
-			x.report('Wrapper#wait_readable') do |repeats|
-				Async do |task|
-					input = Async::Wrapper.new(pipe.first, task.reactor)
-					output = pipe.last
-					
-					repeats.times do
-						output.write(".")
-						input.wait_readable
-						input.io.read(1)
-					end
-					
-					input.reactor = nil
-				end
-			end
-			
-			x.report('Reactor#register') do |repeats|
-				Async do |task|
-					input = pipe.first
-					monitor = task.reactor.register(input, :r)
-					output = pipe.last
-					
-					repeats.times do
-						output.write(".")
-						Async::Task.yield
-						input.read(1)
-					end
-					
-					monitor.close
-				end
-			end
-			
-			x.compare!
-		end
-	end
-end