rubysl-socket 0.0.1 → 1.0.0

data/spec/socket/gethostbyaddr_spec.rb

@@ -0,0 +1 @@
+require File.expand_path('../../fixtures/classes', __FILE__)

data/spec/socket/gethostbyname_spec.rb

@@ -0,0 +1,26 @@
+# -*- encoding: US-ASCII -*-
+require File.expand_path('../../fixtures/classes', __FILE__)
+
+require 'socket'
+
+describe "Socket#gethostbyname" do
+  it "returns broadcast address info for '<broadcast>'" do
+    addr = Socket.gethostbyname('<broadcast>').first;
+    ["broadcasthost", "255.255.255.255"].should include(addr)
+  end
+
+  it "returns broadcast address info for '<any>'" do
+    addr = Socket.gethostbyname('<any>').first;
+    addr.should == "0.0.0.0"
+  end
+
+  it "returns address list in pack format (IPv4)" do
+    laddr = Socket.gethostbyname('127.0.0.1')[3..-1];
+    laddr.should == ["\x7f\x00\x00\x01"]
+  end
+
+  it "returns address list in pack format (IPv6)" do
+    laddr = Socket.gethostbyname('::1')[3..-1]
+    laddr.should == ["\x00" * 15 + "\x01"]
+  end
+end

data/spec/socket/gethostname_spec.rb

@@ -0,0 +1,9 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+
+describe "Socket.gethostname" do
+  # This currently works in Unix and Windows. Edit the helper
+  # to add other platforms.
+  it "returns the host name" do
+    Socket.gethostname.should == hostname
+  end
+end

data/spec/socket/getnameinfo_spec.rb

@@ -0,0 +1,57 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+
+require 'socket'
+
+describe "Socket.getnameinfo" do
+  before :all do
+    @reverse_lookup = BasicSocket.do_not_reverse_lookup
+    BasicSocket.do_not_reverse_lookup = true
+  end
+
+  after :all do
+    BasicSocket.do_not_reverse_lookup = @reverse_lookup
+  end
+
+  it "gets the name information and don't resolve it" do
+    sockaddr = Socket.sockaddr_in SocketSpecs.port, '127.0.0.1'
+    name_info = Socket.getnameinfo(sockaddr, Socket::NI_NUMERICHOST | Socket::NI_NUMERICSERV)
+    name_info.should == ['127.0.0.1', "#{SocketSpecs.port}"]
+  end
+
+  it "gets the name information and resolve the host" do
+    sockaddr = Socket.sockaddr_in SocketSpecs.port, '127.0.0.1'
+    name_info = Socket.getnameinfo(sockaddr, Socket::NI_NUMERICSERV)
+    name_info[0].should be_valid_DNS_name
+    name_info[1].should == SocketSpecs.port.to_s
+  end
+
+  it "gets the name information and resolves the service" do
+    sockaddr = Socket.sockaddr_in 80, '127.0.0.1'
+    name_info = Socket.getnameinfo(sockaddr)
+    name_info.size.should == 2
+    name_info[0].should be_valid_DNS_name
+    # see http://www.iana.org/assignments/port-numbers
+    name_info[1].should =~ /^(www|http|www-http)$/
+  end
+
+  it "gets a 3-element array and doesn't resolve hostname" do
+    name_info = Socket.getnameinfo(["AF_INET", SocketSpecs.port, '127.0.0.1'], Socket::NI_NUMERICHOST | Socket::NI_NUMERICSERV)
+    name_info.should == ['127.0.0.1', "#{SocketSpecs.port}"]
+  end
+
+  it "gets a 3-element array and resolves the service" do
+    name_info = Socket.getnameinfo ["AF_INET", 80, '127.0.0.1']
+    name_info[1].should =~ /^(www|http|www-http)$/
+  end
+
+  it "gets a 4-element array and doesn't resolve hostname" do
+    name_info = Socket.getnameinfo(["AF_INET", SocketSpecs.port, 'foo', '127.0.0.1'], Socket::NI_NUMERICHOST | Socket::NI_NUMERICSERV)
+    name_info.should == ['127.0.0.1', "#{SocketSpecs.port}"]
+  end
+
+  it "gets a 4-element array and resolves the service" do
+    name_info = Socket.getnameinfo ["AF_INET", 80, 'foo', '127.0.0.1']
+    name_info[1].should =~ /^(www|http|www-http)$/
+  end
+
+end

data/spec/socket/getservbyname_spec.rb

@@ -0,0 +1,24 @@
+require File.expand_path('../../../../spec_helper', __FILE__)
+require File.expand_path('../../fixtures/classes', __FILE__)
+
+describe "Socket#getservbyname" do
+  it "returns the port for service 'http'" do
+    Socket.getservbyname('http').should == 80
+  end
+
+  it "returns the port for service 'http' with protocol 'tcp'" do
+    Socket.getservbyname('http', 'tcp').should == 80
+  end
+
+  it "returns the port for service 'domain' with protocol 'udp'" do
+    Socket.getservbyname('domain', 'udp').should == 53
+  end
+
+  it "returns the port for service 'daytime'" do
+    Socket.getservbyname('daytime').should == 13
+  end
+
+  it "raises a SocketError when the service or port is invalid" do
+    lambda { Socket.getservbyname('invalid') }.should raise_error(SocketError)
+  end
+end

data/spec/socket/listen_spec.rb

@@ -0,0 +1,21 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+
+include Socket::Constants
+
+describe "Socket#listen" do
+  before :each do
+    @socket = Socket.new(AF_INET, SOCK_STREAM, 0)
+  end
+
+  after :each do
+    @socket.closed?.should be_false
+    @socket.close
+  end
+
+  it "verifies we can listen for incoming connections" do
+    sockaddr = Socket.pack_sockaddr_in(SocketSpecs.port, "127.0.0.1")
+    @socket.setsockopt(Socket::SOL_SOCKET, Socket::SO_REUSEADDR, true)
+    @socket.bind(sockaddr)
+    @socket.listen(1).should == 0
+  end
+end

data/spec/socket/new_spec.rb

@@ -0,0 +1,109 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+
+describe "Socket.new" do
+  before :each do
+    @socket = nil
+  end
+
+  after :each do
+    @socket.close if @socket and not @socket.closed?
+  end
+
+  describe "with a Socket::PF_INET family" do
+    it "creates a socket with a :DGRAM type specifier" do
+      @socket = Socket.new Socket::PF_INET, "SOCK_DGRAM", 0
+      @socket.should be_an_instance_of(Socket)
+    end
+
+    it "creates a socket with a Socket::PF_STREAM type specifier" do
+      @socket = Socket.new Socket::PF_INET, "SOCK_STREAM", 0
+      @socket.should be_an_instance_of(Socket)
+    end
+  end
+
+  describe "with a Socket::PF_UNIX family" do
+    it "creates a socket with a :DGRAM type specifier" do
+      @socket = Socket.new Socket::PF_UNIX, "SOCK_DGRAM", 0
+      @socket.should be_an_instance_of(Socket)
+    end
+
+    it "creates a socket with a :STREAM type specifier" do
+      @socket = Socket.new Socket::PF_UNIX, "SOCK_STREAM", 0
+      @socket.should be_an_instance_of(Socket)
+    end
+  end
+
+  it "calls #to_str to convert the family to a String" do
+    family = mock("socket new family")
+    family.should_receive(:to_str).and_return("PF_UNIX")
+    @socket = Socket.new family, "SOCK_STREAM", 0
+    @socket.should be_an_instance_of(Socket)
+  end
+
+  it "raises a TypeError if #to_str does not return a String" do
+    family = mock("socket new family")
+    family.should_receive(:to_str).and_return(1)
+    lambda { @socket = Socket.new family, "SOCK_STREAM", 0 }.should raise_error(TypeError)
+  end
+
+  ruby_version_is ""..."1.9" do
+    it "raises an Errno::EPROTONOSUPPORT if socket type is not a string or integer" do
+      lambda { Socket.new(Socket::PF_UNIX, :DGRAM, 0) }.should raise_error(Errno::EPROTONOSUPPORT)
+    end
+  end
+
+  ruby_version_is "1.9" do
+    it "raises a SocketError if given symbol is not a Socket constants reference" do
+      lambda { Socket.new(Socket::PF_UNIX, :NO_EXIST, 0) }.should raise_error(SocketError)
+    end
+
+    it "creates a socket with an :INET family specifier" do
+      @socket = Socket.new :INET, :STREAM
+      @socket.should be_an_instance_of(Socket)
+    end
+
+    it "creates a socket with an 'INET' family specifier" do
+      @socket = Socket.new "INET", :STREAM
+      @socket.should be_an_instance_of(Socket)
+    end
+
+    it "creates a socket with a :UNIX family specifier" do
+      @socket = Socket.new :UNIX, :STREAM
+      @socket.should be_an_instance_of(Socket)
+    end
+
+    it "creates a socket with a 'UNIX' family specifier" do
+      @socket = Socket.new "UNIX", :STREAM
+      @socket.should be_an_instance_of(Socket)
+    end
+
+    describe "with an :INET family" do
+      it "creates a socket with a :DGRAM type specifier" do
+        @socket = Socket.new :INET, :DGRAM
+        @socket.should be_an_instance_of(Socket)
+      end
+
+      it "creates a socket with a :STREAM type specifier" do
+        @socket = Socket.new :INET, :STREAM
+        @socket.should be_an_instance_of(Socket)
+      end
+    end
+
+    describe "with a :UNIX family" do
+      it "creates a socket with a :DGRAM type specifier" do
+        @socket = Socket.new :UNIX, :DGRAM
+        @socket.should be_an_instance_of(Socket)
+      end
+
+      it "creates a socket with a :STREAM type specifier" do
+        @socket = Socket.new :UNIX, :STREAM
+        @socket.should be_an_instance_of(Socket)
+      end
+    end
+
+    it "accepts an optional protocol parameter" do
+      @socket = Socket.new Socket::PF_UNIX, Socket::SOCK_DGRAM, 0
+      @socket.should be_an_instance_of(Socket)
+    end
+  end
+end

data/spec/socket/pack_sockaddr_in_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+require File.expand_path('../../shared/pack_sockaddr', __FILE__)
+
+describe "Socket#pack_sockaddr_in" do
+  it_behaves_like :socket_pack_sockaddr_in, :pack_sockaddr_in
+end

data/spec/socket/pack_sockaddr_un_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+require File.expand_path('../../shared/pack_sockaddr', __FILE__)
+
+describe "Socket#pack_sockaddr_un" do
+  it_behaves_like :socket_pack_sockaddr_un, :pack_sockaddr_un
+end

data/spec/socket/pair_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+require File.expand_path('../../shared/socketpair', __FILE__)
+
+describe "Socket#pair" do
+  it_behaves_like :socket_socketpair, :pair
+end

data/spec/socket/recvfrom_nonblock_spec.rb

@@ -0,0 +1 @@
+require File.expand_path('../../fixtures/classes', __FILE__)

data/spec/socket/recvfrom_spec.rb

@@ -0,0 +1 @@
+require File.expand_path('../../fixtures/classes', __FILE__)

data/spec/socket/sockaddr_in_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+require File.expand_path('../../shared/pack_sockaddr', __FILE__)
+
+describe "Socket#sockaddr_in" do
+  it_behaves_like :socket_pack_sockaddr_in, :sockaddr_in
+end

data/spec/socket/sockaddr_un_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+require File.expand_path('../../shared/pack_sockaddr', __FILE__)
+
+describe "Socket#sockaddr_un" do
+  it_behaves_like :socket_pack_sockaddr_un, :sockaddr_un
+end

data/spec/socket/socket_spec.rb

@@ -0,0 +1,37 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+
+describe "Socket" do
+  it "inherits from BasicSocket and IO" do
+    Socket.superclass.should == BasicSocket
+    BasicSocket.superclass.should == IO
+  end
+end
+
+describe "The socket class hierarchy" do
+  it "has an IPSocket in parallel to Socket" do
+    Socket.ancestors.include?(IPSocket).should == false
+    IPSocket.ancestors.include?(Socket).should == false
+    IPSocket.superclass.should == BasicSocket
+  end
+
+  it "has TCPSocket and UDPSocket subclasses of IPSocket" do
+    TCPSocket.superclass.should == IPSocket
+    UDPSocket.superclass.should == IPSocket
+  end
+
+  not_supported_on :jruby, :windows do
+    it "has a UNIXSocket in parallel to Socket" do
+      Socket.ancestors.include?(UNIXSocket).should == false
+      UNIXSocket.ancestors.include?(Socket).should == false
+      UNIXSocket.superclass.should == BasicSocket
+    end
+  end
+end
+
+not_supported_on :jruby, :windows do
+  describe "Server class hierarchy" do
+    it "contains UNIXServer" do
+      UNIXServer.superclass.should == UNIXSocket
+    end
+  end
+end

data/spec/socket/socketpair_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+require File.expand_path('../../shared/socketpair', __FILE__)
+
+describe "Socket#socketpair" do
+  it_behaves_like :socket_socketpair, :socketpair
+end

data/spec/socket/sysaccept_spec.rb

@@ -0,0 +1 @@
+require File.expand_path('../../fixtures/classes', __FILE__)

data/spec/socket/unpack_sockaddr_in_spec.rb

@@ -0,0 +1,16 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+require 'socket'
+
+describe "Socket#unpack_sockaddr_in" do
+
+  it "decodes the host name and port number of a packed sockaddr_in" do
+    sockaddr = Socket.sockaddr_in SocketSpecs.port, '127.0.0.1'
+    Socket.unpack_sockaddr_in(sockaddr).should == [SocketSpecs.port, '127.0.0.1']
+  end
+
+  it "raises an ArgumentError when the sin_family is not AF_INET" do
+    sockaddr = Socket.sockaddr_un '/tmp/x'
+    lambda { Socket.unpack_sockaddr_in sockaddr }.should raise_error(ArgumentError)
+  end
+
+end

data/spec/socket/unpack_sockaddr_un_spec.rb

@@ -0,0 +1,2 @@
+require File.expand_path('../../../../spec_helper', __FILE__)
+require File.expand_path('../../fixtures/classes', __FILE__)

data/spec/tcpserver/accept_nonblock_spec.rb

@@ -0,0 +1,30 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+
+describe "Socket::TCPServer.accept_nonblock" do
+  before :each do
+    @server =  TCPServer.new("127.0.0.1", SocketSpecs.port)
+  end
+
+  after :each do
+    @server.close
+  end
+
+  it "accepts non blocking connections" do
+    @server.listen(5)
+    lambda { @server.accept_nonblock}.should raise_error(Errno::EAGAIN)
+
+    c = TCPSocket.new("127.0.0.1", SocketSpecs.port)
+    sleep 0.1
+    s = @server.accept_nonblock
+
+    # commenting while we get some input on the current JRuby situation
+    #    port, address = Socket.unpack_sockaddr_in(s.getsockname)
+
+    #    port.should == SocketSpecs.port
+    #    address.should == "127.0.0.1"
+    s.should be_kind_of(TCPSocket)
+
+    c.close
+    s.close
+  end
+end

data/spec/tcpserver/accept_spec.rb

@@ -0,0 +1,60 @@
+require File.expand_path('../../fixtures/classes', __FILE__)
+
+
+describe "TCPServer#accept" do
+  before :each do
+    @server = TCPServer.new("127.0.0.1", SocketSpecs.port)
+  end
+
+  after :each do
+    @server.close unless @server.closed?
+  end
+
+  it "accepts a connection and returns a TCPSocket" do
+    data = nil
+    t = Thread.new do
+      client = @server.accept
+      client.should be_kind_of(TCPSocket)
+      data = client.read(5)
+      client << "goodbye"
+      client.close
+    end
+    Thread.pass while t.status and t.status != "sleep"
+
+    socket = TCPSocket.new('127.0.0.1', SocketSpecs.port)
+    socket.write('hello')
+    socket.shutdown(1) # we are done with sending
+    socket.read.should == 'goodbye'
+    t.join
+    data.should == 'hello'
+    socket.close
+  end
+
+  it "can be interrupted by Thread#kill" do
+    t = Thread.new { @server.accept }
+
+    Thread.pass while t.status and t.status != "sleep"
+
+    # kill thread, ensure it dies in a reasonable amount of time
+    t.kill
+    a = 1
+    while a < 2000
+      break unless t.alive?
+      Thread.pass
+      sleep 0.2
+      a += 1
+    end
+    a.should < 2000
+  end
+
+  it "can be interrupted by Thread#raise" do
+    t = Thread.new { @server.accept }
+
+    Thread.pass while t.status and t.status != "sleep"
+
+    # raise in thread, ensure the raise happens
+    ex = Exception.new
+    t.raise ex
+    lambda { t.join }.should raise_error(Exception)
+  end
+end