Add in-tree mspec and ruby/spec

* For easier modifications of ruby/spec by MRI developers.
* .gitignore: track changes under spec.
* spec/mspec, spec/rubyspec: add in-tree mspec and ruby/spec.
  These files can therefore be updated like any other file in MRI.
  Instructions are provided in spec/README.
  [Feature #13156] [ruby-core:79246]

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@58595 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

4 files changed, 140 insertions, 0 deletions

diff --git a/spec/rubyspec/library/socket/shared/pack_sockaddr.rb b/spec/rubyspec/library/socket/shared/pack_sockaddr.rb
new file mode 100644
index 0000000000..4ffa02a8d8
--- /dev/null
+++ b/spec/rubyspec/library/socket/shared/pack_sockaddr.rb
@@ -0,0 +1,50 @@
+# coding: utf-8
+describe :socket_pack_sockaddr_in, shared: true do
+  it "packs and unpacks" do
+    sockaddr_in = Socket.public_send(@method, 0, nil)
+    port, addr = Socket.unpack_sockaddr_in(sockaddr_in)
+    ["127.0.0.1", "::1"].include?(addr).should == true
+    port.should == 0
+
+    sockaddr_in = Socket.public_send(@method, 0, '')
+    Socket.unpack_sockaddr_in(sockaddr_in).should == [0, '0.0.0.0']
+
+    sockaddr_in = Socket.public_send(@method, 80, '127.0.0.1')
+    Socket.unpack_sockaddr_in(sockaddr_in).should == [80, '127.0.0.1']
+
+    sockaddr_in = Socket.public_send(@method, '80', '127.0.0.1')
+    Socket.unpack_sockaddr_in(sockaddr_in).should == [80, '127.0.0.1']
+
+    sockaddr_in = Socket.public_send(@method, nil, '127.0.0.1')
+    Socket.unpack_sockaddr_in(sockaddr_in).should == [0, '127.0.0.1']
+  end
+end
+
+describe :socket_pack_sockaddr_un, shared: true do
+  platform_is_not :windows do
+    it 'should be idempotent' do
+      bytes = Socket.public_send(@method, '/tmp/foo').bytes
+      bytes[2..9].should == [47, 116, 109, 112, 47, 102, 111, 111]
+      bytes[10..-1].all?(&:zero?).should == true
+    end
+
+    it "packs and unpacks" do
+      sockaddr_un = Socket.public_send(@method, '/tmp/s')
+      Socket.unpack_sockaddr_un(sockaddr_un).should == '/tmp/s'
+    end
+
+    it "handles correctly paths with multibyte chars" do
+      sockaddr_un = Socket.public_send(@method, '/home/вася/sock')
+      path = Socket.unpack_sockaddr_un(sockaddr_un).encode('UTF-8', 'UTF-8')
+      path.should == '/home/вася/sock'
+    end
+  end
+
+  platform_is_not :windows, :aix do
+    it "raises if path length exceeds max size" do
+      # AIX doesn't raise error
+      long_path = Array.new(512, 0).join
+      lambda { Socket.public_send(@method, long_path) }.should raise_error(ArgumentError)
+    end
+  end
+end
diff --git a/spec/rubyspec/library/socket/shared/partially_closable_sockets.rb b/spec/rubyspec/library/socket/shared/partially_closable_sockets.rb
new file mode 100644
index 0000000000..1309f15f85
--- /dev/null
+++ b/spec/rubyspec/library/socket/shared/partially_closable_sockets.rb
@@ -0,0 +1,13 @@
+describe "partially closable sockets", shared: true do
+  specify "if the write end is closed then the other side can read past EOF without blocking" do
+    @s1.write("foo")
+    @s1.close_write
+    @s2.read("foo".size + 1).should == "foo"
+  end
+
+  specify "closing the write end ensures that the other side can read until EOF" do
+    @s1.write("hello world")
+    @s1.close_write
+    @s2.read.should == "hello world"
+  end
+end
diff --git a/spec/rubyspec/library/socket/shared/recv_nonblock.rb b/spec/rubyspec/library/socket/shared/recv_nonblock.rb
new file mode 100644
index 0000000000..4a63b16024
--- /dev/null
+++ b/spec/rubyspec/library/socket/shared/recv_nonblock.rb
@@ -0,0 +1,54 @@
+describe :socket_recv_nonblock, shared: true do
+  before :each do
+    @s1 = Socket.new(Socket::AF_INET, Socket::SOCK_DGRAM, 0)
+    @s2 = Socket.new(Socket::AF_INET, Socket::SOCK_DGRAM, 0)
+  end
+
+  after :each do
+    @s1.close unless @s1.closed?
+    @s2.close unless @s2.closed?
+  end
+
+  it "raises an exception extending IO::WaitReadable if there's no data available" do
+    @s1.bind(Socket.pack_sockaddr_in(SocketSpecs.port, "127.0.0.1"))
+    lambda {
+      @s1.recv_nonblock(5)
+    }.should raise_error(IO::WaitReadable) { |e|
+      platform_is_not :windows do
+        e.should be_kind_of(Errno::EAGAIN)
+      end
+      platform_is :windows do
+        e.should be_kind_of(Errno::EWOULDBLOCK)
+      end
+    }
+  end
+
+  it "receives data after it's ready" do
+    @s1.bind(Socket.pack_sockaddr_in(SocketSpecs.port, "127.0.0.1"))
+    @s2.send("aaa", 0, @s1.getsockname)
+    IO.select([@s1], nil, nil, 2)
+    @s1.recv_nonblock(5).should == "aaa"
+  end
+
+  ruby_version_is "2.3" do
+    it "allows an output buffer as third argument" do
+      @s1.bind(Socket.pack_sockaddr_in(SocketSpecs.port, "127.0.0.1"))
+      @s2.send("data", 0, @s1.getsockname)
+      IO.select([@s1], nil, nil, 2)
+
+      buf = "foo"
+      @s1.recv_nonblock(5, 0, buf)
+      buf.should == "data"
+    end
+  end
+
+  it "does not block if there's no data available" do
+    @s1.bind(Socket.pack_sockaddr_in(SocketSpecs.port, "127.0.0.1"))
+    @s2.send("a", 0, @s1.getsockname)
+    IO.select([@s1], nil, nil, 2)
+    @s1.recv_nonblock(1).should == "a"
+    lambda {
+      @s1.recv_nonblock(5)
+    }.should raise_error(IO::WaitReadable)
+  end
+end
diff --git a/spec/rubyspec/library/socket/shared/socketpair.rb b/spec/rubyspec/library/socket/shared/socketpair.rb
new file mode 100644
index 0000000000..03ee0e1a52
--- /dev/null
+++ b/spec/rubyspec/library/socket/shared/socketpair.rb
@@ -0,0 +1,23 @@
+describe :socket_socketpair, shared: true do
+  platform_is_not :windows do
+    it "ensures the returned sockets are connected" do
+      s1, s2 = Socket.public_send(@method, Socket::AF_UNIX, 1, 0)
+      s1.puts("test")
+      s2.gets.should == "test\n"
+      s1.close
+      s2.close
+    end
+
+    it "responses with array of two sockets" do
+      begin
+        s1, s2 = Socket.public_send(@method, :UNIX, :STREAM)
+
+        s1.should be_an_instance_of(Socket)
+        s2.should be_an_instance_of(Socket)
+      ensure
+        s1.close
+        s2.close
+      end
+    end
+  end
+end