async 1.20.1 → 1.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54073e0570fc66e2aedec5657883edaf4aa90ed0e93241c9d2210debf8886441
-  data.tar.gz: 24377adc700b7631969fd299765427ca06208508857eacd5be33b41a137c76c7
+  metadata.gz: b9c9a081ed81fc6b4b0b34ebb5282063574994045189a9544b968c7729543cf1
+  data.tar.gz: df9d9266a02ff86895cfc9934fbafbeeb7159cb1b964f10705323d9f4798ae34
 SHA512:
-  metadata.gz: e6a0f47087e557cfb5d2c9ed32b6fe5738ae1f756b99f23c1ab98bf8722ce22d63cddb629cab9225a98ea901b20912c04e267ac94f194ab913e5a511912bb187
-  data.tar.gz: fae19fc4eaad3c8ae827bdf54b2ecacf793c31890bbc47088bc7c01af704cde8eb6f98a7b273706898137d4ca368bcecb15823f8b5f151344e6bada5b12c9adf
+  metadata.gz: 1f5014904c26006fd50462c9161f3ae24f867ed995569bc1faecebe67d3a1b8799eb4a91896121a07885512ae21361be18f9f9ea3614825140cb3596239cc13b
+  data.tar.gz: 26c13f37945ceb4d2542a2ef0736b6fe04cc9515d90053d4b2a00888a5501c008ce614849462b006216a94a1eece3fc781cf378f25f369ae65bceeede12dbfe6

data/.github/FUNDING.yml

@@ -0,0 +1,4 @@
+# These are supported funding model platforms
+
+# github: ioquatix
+custom: https://github.com/socketry/community/#funding

data/benchmark/fiber_count.rb

@@ -0,0 +1,9 @@
+
+fibers = []
+
+(1..).each do |i|
+	fibers << Fiber.new{}
+	fibers.last.resume
+	puts i
+end
+

data/benchmark/thread_count.rb

@@ -0,0 +1,8 @@
+
+threads = []
+
+(1..).each do |i|
+	threads << Thread.new{sleep}
+	puts i
+end
+

data/benchmark/thread_vs_fiber.rb

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+
+# 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'
+
+GC.disable
+
+Benchmark.ips do |benchmark|
+	benchmark.time = 1
+	benchmark.warmup = 1
+	
+	benchmark.report("Thread.new{}") do |count|
+		while count > 0
+			Thread.new{count -= 1}.join
+		end
+	end
+	
+	benchmark.report("Fiber.new{}") do |count|
+		while count > 0
+			Fiber.new{count -= 1}.resume
+		end
+	end
+	
+	benchmark.compare!
+end

data/examples/capture/capture.rb

@@ -34,10 +34,10 @@ def parse(value)
 	end
 end
 
-def strace(pid, duration = 10)
+def strace(pid, duration = 60)
 	input, output = IO.pipe
 	
-	pid = Process.spawn("strace", "-p", pid.to_s, "-cqf", "-w", "-e", "trace=read,write,sendto,recvfrom", err: output)
+	pid = Process.spawn("strace", "-p", pid.to_s, "-cqf", "-w", "-e", "!futex", err: output)
 	
 	output.close
 	
@@ -46,15 +46,21 @@ def strace(pid, duration = 10)
 		Signal.trap(:INT, :DEFAULT)
 	end
 	
+	Thread.new do
+		sleep duration
+		Process.kill(:INT, pid)
+	end
+	
 	summary = {}
 	
-	if line = input.gets
-		rule = input.gets # horizontal separator
-		pattern = Regexp.new(
-			rule.split(/\s/).map{|s| "(.{1,#{s.size}})"}.join(' ')
-		)
-		
-		header = pattern.match(line).captures.map{|key| key.strip.to_sym}
+	if first_line = input.gets
+		if rule = input.gets # horizontal separator
+			pattern = Regexp.new(
+				rule.split(/\s/).map{|s| "(.{1,#{s.size}})"}.join(' ')
+			)
+			
+			header = pattern.match(first_line).captures.map{|key| key.strip.to_sym}
+		end
 		
 		while line = input.gets
 			break if line == rule
@@ -71,7 +77,11 @@ def strace(pid, duration = 10)
 		end
 	end
 	
-	Process.waitpid(pid)
+	_, status = Process.waitpid2(pid)
+	
+	Console.logger.error(status) do |buffer|
+		buffer.puts first_line
+	end unless status.success?
 	
 	return summary
 end
@@ -80,6 +90,7 @@ pids.each do |pid|
 	start_times = getrusage(pid)
 	Console.logger.info("Process #{pid} start times:", start_times)
 	
+	# sleep 60
 	summary = strace(pid)
 	
 	Console.logger.info("strace -p #{pid}") do |buffer|
@@ -94,7 +105,7 @@ pids.each do |pid|
 	if total = summary[:total]
 		process_duration = end_times.utime - start_times.utime
 		wait_duration = summary[:total][:seconds]
-		
+	
 		Console.logger.info("Process Waiting: #{wait_duration.round(4)}s out of #{process_duration.round(4)}s") do |buffer|
 			buffer.puts "Wait percentage: #{(wait_duration / process_duration * 100.0).round(2)}%"
 		end

data/examples/queue/producer.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+
+require 'async'
+require 'async/queue'
+
+Async do
+	# Queue of up to 10 items:
+	items = Async::LimitedQueue.new(10)
+	
+	# Five producers:
+	5.times do
+		Async do |task|
+			while true
+				t = rand
+				task.sleep(t)
+				items.enqueue(t)
+			end
+		end
+	end
+	
+	# A single consumer:
+	Async do |task|
+		while item = items.dequeue
+			puts "dequeue -> #{item}"
+		end
+	end
+end

data/examples/stop/condition.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+
+# require 'async'; require 'async/queue'
+
+require_relative '../../lib/async'; require_relative '../../lib/async/queue'
+
+Async do |consumer|
+	consumer.annotate "consumer"
+	condition = Async::Condition.new
+	
+	producer = Async do |subtask|
+		subtask.annotate "subtask"
+		
+		(1..).each do |value|
+			puts "producer yielding"
+			subtask.yield # (1) Fiber.yield, (3) Reactor -> producer.resume
+			condition.signal(value) # (4) consumer.resume(value)
+		end
+		
+		puts "producer exiting"
+	end
+	
+	value = condition.wait # (2) value = Fiber.yield
+	puts "producer.stop"
+	producer.stop # (5) [producer is resumed already] producer.stop
+	
+	puts "consumer exiting"
+end
+
+puts "Done."

data/examples/stop/sleep.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+
+require_relative '../../lib/async'
+
+require 'async/http/endpoint'
+require 'async/http/server'
+
+require 'async/http/internet'
+
+# To query the web server:
+# curl http://localhost:9292/kittens
+
+Async do |parent|
+	endpoint = Async::HTTP::Endpoint.parse("http://localhost:9292")
+	internet = Async::HTTP::Internet.new
+	
+	server = Async::HTTP::Server.for(endpoint) do |request|
+		if request.path =~ /\/(.*)/
+			keyword = $1
+			
+			response = internet.get("https://www.google.com/search?q=#{keyword}")
+			
+			count = response.read.scan(keyword).size
+			
+			Protocol::HTTP::Response[200, [], ["Google found #{count} instance(s) of #{keyword}.\n"]]
+		else
+			Protocol::HTTP::Response[404, [], []]
+		end
+	end
+	
+	tasks = server.run
+	
+	#while true
+	parent.sleep(10)
+	parent.reactor.print_hierarchy
+	#end
+	
+	parent.stop # -> Async::Stop
+	
+	tasks.each(&:stop)
+end

data/lib/async.rb

@@ -22,15 +22,11 @@ require_relative "async/version"
 require_relative "async/logger"
 require_relative "async/reactor"
 
+require_relative "kernel/async"
+
 module Async
 	# Invoke `Reactor.run` with all arguments/block.
 	def self.run(*args, &block)
 		Reactor.run(*args, &block)
 	end
-end
-
-module Kernel
-	def Async(*args, &block)
-		Async::Reactor.run(*args, &block)
-	end
-end
+end

data/lib/async/reactor.rb

@@ -201,7 +201,7 @@ module Async
 					interval = 0
 				end
 				
-				# logger.debug(self) {"Selecting with #{@children&.count} children with interval = #{interval.inspect}..."}
+				# logger.debug(self) {"Selecting with #{@children&.size} children with interval = #{interval.inspect}..."}
 				if monitors = @selector.select(interval)
 					monitors.each do |monitor|
 						monitor.value.resume

data/lib/async/task.rb

@@ -27,13 +27,26 @@ require_relative 'condition'
 module Async
 	# Raised when a task is explicitly stopped.
 	class Stop < Exception
+		class Later
+			def initialize(task)
+				@task = task
+			end
+			
+			def alive?
+				true
+			end
+			
+			def resume
+				@task.stop
+			end
+		end
 	end
 	
 	# A task represents the state associated with the execution of an asynchronous
 	# block.
 	class Task < Node
 		extend Forwardable
-	
+		
 		# Yield the unerlying `result` for the task. If the result
 		# is an Exception, then that result will be raised an its
 		# exception.
@@ -85,7 +98,7 @@ module Async
 		
 		# Yield back to the reactor and allow other fibers to execute.
 		def yield
-			reactor.yield
+			Task.yield{reactor.yield}
 		end
 		
 		# @attr fiber [Fiber] The fiber which is being used for the execution of this task.
@@ -137,29 +150,34 @@ module Async
 		# Stop the task and all of its children.
 		# @return [void]
 		def stop
-			if self.stopping?
-				# If we are already stopping this task... don't try to stop it again.
-				return true
-			elsif self.running?
-				@status = :stopping
-				
+			if self.stopped?
+				# If we already stopped this task... don't try to stop it again:
+				return
+			end
+			
+			if self.running?
 				if self.current?
 					raise Stop, "Stopping current fiber!"
 				elsif @fiber&.alive?
-					@fiber.resume(Stop.new)
+					begin
+						@fiber.resume(Stop.new)
+					rescue FiberError
+						@reactor << Stop::Later.new(self)
+					end
 				end
+			else
+				# We are not running, but children might be, so transition directly into stopped state:
+				stop!
 			end
-		ensure
-			@children&.each(&:stop)
 		end
-	
+		
 		# Lookup the {Task} for the current fiber. Raise `RuntimeError` if none is available.
 		# @return [Async::Task]
 		# @raise [RuntimeError] if task was not {set!} for the current fiber.
 		def self.current
 			Thread.current[:async_task] or raise RuntimeError, "No async task available!"
 		end
-	
+		
 		# Check if there is a task defined for the current fiber.
 		# @return [Async::Task, nil]
 		def self.current?
@@ -175,7 +193,7 @@ module Async
 		def running?
 			@status == :running
 		end
-	
+		
 		# Whether we can remove this node from the reactor graph.
 		# @return [Boolean]
 		def finished?
@@ -217,7 +235,9 @@ module Async
 		end
 		
 		def stop!
+			# logger.debug(self) {"Task was stopped with #{@children.size} children!"}
 			@status = :stopped
+			@children&.each(&:stop)
 		end
 		
 		def make_fiber(&block)
@@ -227,7 +247,7 @@ module Async
 				begin
 					@result = yield(self, *args)
 					@status = :complete
-					# logger.debug("Task #{self} completed normally.")
+					# logger.debug(self) {"Task was completed with #{@children.size} children!"}
 				rescue Stop
 					stop!
 				rescue StandardError => error
@@ -235,7 +255,7 @@ module Async
 				rescue Exception => exception
 					fail!(exception, true)
 				ensure
-					# logger.debug("Task #{self} closing: #{$!}")
+					# logger.debug(self) {"Task ensure $!=#{$!} with #{@children.size} children!"}
 					finish!
 				end
 			end
@@ -254,7 +274,7 @@ module Async
 				@finished.signal(@result)
 			end
 		end
-	
+		
 		# Set the current fiber's `:async_task` to this task.
 		def set!
 			# This is actually fiber-local:

data/lib/async/version.rb

@@ -19,5 +19,5 @@
 # THE SOFTWARE.
 
 module Async
-	VERSION = "1.20.1"
+	VERSION = "1.21.0"
 end

data/lib/async/wrapper.rb

@@ -24,9 +24,29 @@ module Async
 	# Represents an asynchronous IO within a reactor.
 	class Wrapper
 		class Cancelled < StandardError
+			class From
+				def initialize
+					@backtrace = caller[5..-1]
+				end
+				
+				attr :backtrace
+				
+				def cause
+					nil
+				end
+				
+				def message
+					"Cancelled"
+				end
+			end
+			
 			def initialize
 				super "The operation has been cancelled!"
+				
+				@cause = From.new
 			end
+			
+			attr :cause
 		end
 		
 		# wait_readable, wait_writable and wait_any are not re-entrant, and will raise this failure.

data/lib/kernel/async.rb

@@ -0,0 +1,28 @@
+# 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_relative "../async/reactor"
+
+module Kernel
+	# Run the given block of code in a task, asynchronously, creating a reactor if necessary.
+	def Async(*args, &block)
+		::Async::Reactor.run(*args, &block)
+	end
+end

data/lib/kernel/sync.rb

@@ -0,0 +1,32 @@
+# 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_relative "../async/reactor"
+
+module Kernel
+	# Run the given block of code synchronously, but within a reactor if not already in one.
+	def Sync(&block)
+		if task = ::Async::Task.current?
+			yield
+		else
+			::Async::Reactor.run(&block).wait
+		end
+	end
+end

data/spec/async/condition_spec.rb

@@ -41,5 +41,30 @@ RSpec.describe Async::Condition do
 		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/node_spec.rb

@@ -54,7 +54,7 @@ RSpec.describe Async::Node do
 		it "can print hierarchy to bufffer" do
 			subject.print_hierarchy(buffer)
 			
-			expect(lines.count).to be 2
+			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/

data/spec/async/performance_spec.rb

@@ -1,5 +1,25 @@
+# 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}

data/spec/async/task_spec.rb

@@ -181,7 +181,7 @@ RSpec.describe Async::Task do
 			expect(task).to be_stopped
 		end
 		
-		it "should kill direct child" do
+		it "should stop direct child" do
 			parent_task = child_task = nil
 			
 			reactor.async do |task|
@@ -221,6 +221,27 @@ RSpec.describe Async::Task do
 			bottom_task.stop
 			expect(top_task.children).to include(middle_task)
 		end
+		
+		it "can stop resumed task" do
+			items = [1, 2, 3]
+			
+			Async do
+				condition = Async::Condition.new
+				
+				producer = Async do |subtask|
+					while item = items.pop
+						subtask.yield # (1) Fiber.yield, (3) Reactor -> producer.resume
+						condition.signal(item) # (4) consumer.resume(value)
+					end
+				end
+				
+				value = condition.wait # (2) value = Fiber.yield
+				expect(value).to be == 3
+				producer.stop # (5) [producer is resumed already] producer.stop
+			end
+			
+			expect(items).to be == [1]
+		end
 	end
 	
 	describe '#sleep' do

data/spec/async_spec.rb

@@ -21,14 +21,6 @@
 require 'async'
 
 RSpec.describe Async do
-	describe '#Async' do
-		it "can run an asynchronous task" do
-			Async do |task|
-				expect(task).to be_a Async::Task
-			end
-		end
-	end
-	
 	describe '.run' do
 		it "can run an asynchronous task" do
 			Async.run do |task|

data/spec/kernel/async_spec.rb

@@ -0,0 +1,31 @@
+# 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 'kernel/async'
+
+RSpec.describe Async do
+	describe '#Async' do
+		it "can run an asynchronous task" do
+			Async do |task|
+				expect(task).to be_a Async::Task
+			end
+		end
+	end
+end

data/spec/kernel/sync_spec.rb

@@ -0,0 +1,49 @@
+# 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 'kernel/sync'
+
+RSpec.describe Kernel do
+	describe '#Sync' do
+		let(:value) {10}
+		
+		it "can run a synchronous task" do
+			result = Sync do
+				expect(Async::Task.current).to_not be nil
+				
+				next value
+			end
+			
+			expect(result).to be == value
+		end
+		
+		it "can run inside reactor" do
+			Async do |task|
+				result = Sync do
+					expect(Async::Task.current).to be task
+					
+					next value
+				end
+				
+				expect(result).to be == value
+			end
+		end
+	end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: async
 version: !ruby/object:Gem::Version
-  version: 1.20.1
+  version: 1.21.0
 platform: ruby
 authors:
 - Samuel Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-14 00:00:00.000000000 Z
+date: 2019-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nio4r
@@ -132,6 +132,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".editorconfig"
+- ".github/FUNDING.yml"
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
@@ -142,12 +143,18 @@ files:
 - Rakefile
 - async.gemspec
 - benchmark/async_vs_lightio.rb
+- benchmark/fiber_count.rb
+- benchmark/thread_count.rb
+- benchmark/thread_vs_fiber.rb
 - examples/async_method.rb
 - examples/callback/loop.rb
 - examples/capture/README.md
 - examples/capture/capture.rb
 - examples/fibers.rb
+- examples/queue/producer.rb
 - examples/sleep_sort.rb
+- examples/stop/condition.rb
+- examples/stop/sleep.rb
 - gems/event.gemfile
 - lib/async.rb
 - lib/async/clock.rb
@@ -163,6 +170,8 @@ files:
 - lib/async/task.rb
 - lib/async/version.rb
 - lib/async/wrapper.rb
+- lib/kernel/async.rb
+- lib/kernel/sync.rb
 - logo.png
 - logo.svg
 - papers/1982 Grossman.pdf
@@ -182,6 +191,8 @@ files:
 - spec/async/wrapper_spec.rb
 - spec/async_spec.rb
 - spec/enumerator_spec.rb
+- spec/kernel/async_spec.rb
+- spec/kernel/sync_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/socketry/async
 licenses:
@@ -202,7 +213,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.4
 signing_key: 
 specification_version: 4
 summary: Async is an asynchronous I/O framework based on nio4r.
@@ -222,4 +233,6 @@ test_files:
 - spec/async/wrapper_spec.rb
 - spec/async_spec.rb
 - spec/enumerator_spec.rb
+- spec/kernel/async_spec.rb
+- spec/kernel/sync_spec.rb
 - spec/spec_helper.rb