async-io 0.1.0

data/spec/async/io/generic_spec.rb

@@ -0,0 +1,47 @@
+# 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/io'
+
+RSpec.describe Async::IO::Generic do
+	include_context Async::RSpec::Reactor
+	
+	let(:pipe) {IO.pipe}
+	let(:input) {Async::IO::Generic.new(pipe.first)}
+	let(:output) {Async::IO::Generic.new(pipe.last)}
+	
+	it "should send and receive data within the same reactor" do
+		message = nil
+		
+		output_task = reactor.async do
+			message = input.read(1024)
+		end
+		
+		reactor.async do
+			output.write("Hello World")
+		end
+		
+		output_task.wait
+		expect(message).to be == "Hello World"
+		
+		input.close
+		output.close
+	end
+end

data/spec/async/io/tcp_socket_spec.rb

@@ -0,0 +1,115 @@
+# 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/io/tcp_socket'
+
+RSpec.describe Async::Reactor do
+	include_context Async::RSpec::Leaks
+	
+	# Shared port for localhost network tests.
+	let(:server_address) {Async::IO::Address.tcp("localhost", 6779)}
+	let(:data) {"The quick brown fox jumped over the lazy dog."}
+	
+	around(:each) do |example|
+		# Accept a single incoming connection and then finish.
+		subject.async do |task|
+			Async::IO::Socket.bind(server_address) do |server|
+				server.listen(10)
+				
+				server.accept do |peer, address|
+					data = peer.read(512)
+					peer.write(data)
+				end
+			end
+		end
+		
+		result = example.run
+		
+		if result.is_a? Exception
+			result 
+		else
+			subject.run
+		end
+	end
+	
+	describe 'basic tcp server' do
+		it "should start server and send data" do
+			subject.async do
+				Async::IO::Socket.connect(server_address) do |client|
+					client.write(data)
+					expect(client.read(512)).to be == data
+				end
+			end
+		end
+	end
+	
+	describe 'non-blocking tcp connect' do
+		it "should start server and send data" do
+			subject.async do |task|
+				Async::IO::Socket.connect(server_address) do |client|
+					client.write(data)
+					expect(client.read(512)).to be == data
+				end
+			end
+		end
+		
+		it "can connect socket and read/write in a different task" do
+			socket = nil
+			
+			subject.async do |task|
+				socket = Async::IO::Socket.connect(server_address)
+				
+				# Stop the reactor once the connection was made.
+				subject.stop
+			end
+		
+			subject.run
+			
+			expect(socket).to_not be_nil
+			expect(socket).to be_kind_of Async::Wrapper
+			
+			subject.async do
+				socket.write(data)
+				
+				expect(socket.read(512)).to be == data
+			end
+			
+			subject.run
+			
+			socket.close
+		end
+		
+		it "can't use a socket in nested tasks" do
+			subject.async do |task|
+				socket = Async::IO::Socket.connect(server_address)
+				expect(socket).to be_kind_of Async::Wrapper
+				
+				expect do
+					subject.async do
+						socket.write(data)
+						# expect(socket.read(512)).to be == data
+					end
+				end.to_not raise_error
+				
+				socket.close
+			end
+		end
+	end
+end

data/spec/async/io/udp_socket_spec.rb

@@ -0,0 +1,73 @@
+# 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/io/udp_socket'
+
+RSpec.describe Async::Reactor do
+	include_context Async::RSpec::Leaks
+	
+	# Shared port for localhost network tests.
+	let(:server_address) {Async::IO::Address.udp("127.0.0.1", 6778)}
+	let(:data) {"The quick brown fox jumped over the lazy dog."}
+	
+	describe 'basic udp server' do
+		it "should echo data back to peer" do
+			subject.async do
+				Async::IO::Socket.bind(server_address) do |server|
+					packet, address = server.recvfrom(512)
+					
+					server.send(packet, 0, address)
+				end
+			end
+			
+			subject.async do
+				Async::IO::Socket.connect(server_address) do |client|
+					client.send(data)
+					response = client.recv(512)
+					
+					expect(response).to be == data
+				end
+			end
+			
+			subject.run
+		end
+		
+		it "should use unconnected socket" do
+			subject.async do
+				Async::IO::Socket.bind(server_address) do |server|
+					packet, address = server.recvfrom(512)
+					
+					server.send(packet, 0, address)
+				end
+			end
+			
+			subject.async do
+				Async::IO::UDPSocket.wrap(server_address.afamily) do |client|
+					client.send(data, 0, server_address)
+					response, address = client.recvfrom(512)
+					
+					expect(response).to be == data
+				end
+			end
+			
+			subject.run
+		end
+	end
+end

data/spec/async/io/unix_socket_spec.rb

@@ -0,0 +1,55 @@
+# 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/io/unix_socket'
+
+RSpec.describe Async::Reactor do
+	include_context Async::RSpec::Leaks
+	
+	let(:path) {File.join(__dir__, "unix-socket")}
+	let(:data) {"The quick brown fox jumped over the lazy dog."}
+	
+	before(:each) do
+		FileUtils.rm_f path
+	end
+	
+	describe 'basic unix socket' do
+		it "should echo data back to peer" do
+			subject.async do
+				Async::IO::UNIXServer.wrap(path) do |server|
+					server.accept do |peer|
+						peer.send(peer.recv(512))
+					end
+				end
+			end
+			
+			subject.async do
+				Async::IO::UNIXSocket.wrap(path) do |client|
+					client.send(data)
+					response = client.recv(512)
+				
+					expect(response).to be == data
+				end
+			end
+			
+			subject.run
+		end
+	end
+end

data/spec/async/io/wrap/tcp_spec.rb

@@ -0,0 +1,40 @@
+# 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 'net/http'
+
+require 'async/io/wrap/tcp'
+
+RSpec.describe Async::IO::Wrap::TCPSocket do
+	include_context Async::RSpec::Reactor
+	
+	before(:all) do
+		# This injects the asynchronous sockets into Net::HTTP.
+		Net::HTTP.send(:include, Async::IO::Wrap)
+	end
+	
+	it "should fetch page" do
+		expect(Async::IO::Wrap::TCPSocket).to receive(:new).and_call_original
+		
+		expect do
+			Net::HTTP.get_response('www.google.com', '/')
+		end.to_not raise_error
+	end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,32 @@
+
+if ENV['COVERAGE'] || ENV['TRAVIS']
+	begin
+		require 'simplecov'
+		
+		SimpleCov.start do
+			add_filter "/spec/"
+		end
+		
+		if ENV['TRAVIS']
+			require 'coveralls'
+			Coveralls.wear!
+		end
+	rescue LoadError
+		warn "Could not load simplecov: #{$!}"
+	end
+end
+
+require "bundler/setup"
+require "async/io"
+
+# Shared rspec helpers:
+require "async/rspec"
+
+RSpec.configure do |config|
+	# Enable flags like --only-failures and --next-failure
+	config.example_status_persistence_file_path = ".rspec_status"
+
+	config.expect_with :rspec do |c|
+		c.syntax = :expect
+	end
+end

metadata

@@ -0,0 +1,145 @@
+--- !ruby/object:Gem::Specification
+name: async-io
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Samuel Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-05-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: async-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- samuel.williams@oriontransfer.co.nz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- async-io.gemspec
+- lib/async/io.rb
+- lib/async/io/address.rb
+- lib/async/io/generic.rb
+- lib/async/io/socket.rb
+- lib/async/io/tcp_socket.rb
+- lib/async/io/udp_socket.rb
+- lib/async/io/unix_socket.rb
+- lib/async/io/version.rb
+- lib/async/io/wrap/tcp.rb
+- spec/async/io/address_spec.rb
+- spec/async/io/echo_spec.rb
+- spec/async/io/generic_spec.rb
+- spec/async/io/tcp_socket_spec.rb
+- spec/async/io/udp_socket_spec.rb
+- spec/async/io/unix_socket_spec.rb
+- spec/async/io/wrap/tcp_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/socketry/async-io
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.10
+signing_key: 
+specification_version: 4
+summary: Provides support for asynchonous TCP, UDP, UNIX and SSL sockets.
+test_files:
+- spec/async/io/address_spec.rb
+- spec/async/io/echo_spec.rb
+- spec/async/io/generic_spec.rb
+- spec/async/io/tcp_socket_spec.rb
+- spec/async/io/udp_socket_spec.rb
+- spec/async/io/unix_socket_spec.rb
+- spec/async/io/wrap/tcp_spec.rb
+- spec/spec_helper.rb