rubysl-stringio 1.0.0

data/spec/rewind_spec.rb

@@ -0,0 +1,23 @@
+require File.expand_path('../fixtures/classes', __FILE__)
+
+describe "StringIO#rewind" do
+  before(:each) do
+    @io = StringIO.new("hello\nworld")
+    @io.pos = 3
+    @io.lineno = 1
+  end
+
+  it "returns 0" do
+    @io.rewind.should eql(0)
+  end
+
+  it "resets the position" do
+    @io.rewind
+    @io.pos.should == 0
+  end
+
+  it "resets the line number" do
+    @io.rewind
+    @io.lineno.should == 0
+  end
+end

data/spec/seek_spec.rb

@@ -0,0 +1,75 @@
+require File.expand_path('../fixtures/classes', __FILE__)
+
+describe "StringIO#seek" do
+  before(:each) do
+    @io = StringIO.new("12345678")
+  end
+
+  it "seeks from the current position when whence is IO::SEEK_CUR" do
+    @io.pos = 1
+    @io.seek(1, IO::SEEK_CUR)
+    @io.pos.should eql(2)
+
+    @io.seek(-1, IO::SEEK_CUR)
+    @io.pos.should eql(1)
+  end
+
+  it "seeks from the end of self when whence is IO::SEEK_END" do
+    @io.seek(3, IO::SEEK_END)
+    @io.pos.should eql(11) # Outside of the StringIO's content
+
+    @io.seek(-2, IO::SEEK_END)
+    @io.pos.should eql(6)
+  end
+
+  it "seeks to an absolute position when whence is IO::SEEK_SET" do
+    @io.seek(5, IO::SEEK_SET)
+    @io.pos.should == 5
+
+    @io.pos = 3
+    @io.seek(5, IO::SEEK_SET)
+    @io.pos.should == 5
+  end
+
+  it "raises an Errno::EINVAL error on negative amounts when whence is IO::SEEK_SET" do
+    lambda { @io.seek(-5, IO::SEEK_SET) }.should raise_error(Errno::EINVAL)
+  end
+
+  it "raises an Errno::EINVAL error on incorrect whence argument" do
+    lambda { @io.seek(0, 3) }.should raise_error(Errno::EINVAL)
+    lambda { @io.seek(0, -1) }.should raise_error(Errno::EINVAL)
+    lambda { @io.seek(0, 2**16) }.should raise_error(Errno::EINVAL)
+    lambda { @io.seek(0, -2**16) }.should raise_error(Errno::EINVAL)
+  end
+
+  it "tries to convert the passed Object to a String using #to_int" do
+    obj = mock("to_int")
+    obj.should_receive(:to_int).and_return(2)
+    @io.seek(obj)
+    @io.pos.should eql(2)
+  end
+
+  it "raises a TypeError when the passed Object can't be converted to an Integer" do
+    lambda { @io.seek(Object.new) }.should raise_error(TypeError)
+  end
+end
+
+describe "StringIO#seek when self is closed" do
+  before(:each) do
+    @io = StringIO.new("example")
+    @io.close
+  end
+
+  ruby_version_is "" ... "1.8.7" do
+    it "does not raise an IOError" do
+      @io.seek(5)
+      @io.pos.should eql(5)
+    end
+  end
+
+  ruby_version_is "1.8.7" do
+    it "raises an IOError" do
+      lambda { @io.seek(5) }.should raise_error(IOError)
+    end
+  end
+end

data/spec/set_encoding_spec.rb

@@ -0,0 +1,34 @@
+require 'stringio'
+require File.expand_path('../../../spec_helper', __FILE__)
+
+ruby_version_is "1.9.2" do
+  describe "StringIO#set_encoding" do
+    before :each do
+      @default_external = Encoding.default_external
+      Encoding.default_external = Encoding::UTF_8
+    end
+
+    after :each do
+      Encoding.default_external = @default_external
+    end
+
+    it "sets the encoding of the underlying String to the specified encoding" do
+      io = StringIO.new
+      io.set_encoding Encoding::UTF_8
+      io.string.encoding.should == Encoding::UTF_8
+    end
+
+    it "sets the encoding of the underlying String to the named encoding" do
+      io = StringIO.new
+      io.set_encoding "UTF-8"
+      io.string.encoding.should == Encoding::UTF_8
+    end
+
+    it "sets the encoding of the underlying String to the default external encoding when passed nil" do
+      Encoding.default_external = Encoding::UTF_8
+      io = StringIO.new
+      io.set_encoding nil
+      io.string.encoding.should == Encoding::UTF_8
+    end
+  end
+end

data/spec/shared/codepoints.rb

@@ -0,0 +1,45 @@
+# -*- encoding: utf-8 -*-
+describe :stringio_codepoints, :shared => true do
+  before(:each) do
+    @io = StringIO.new("∂φ/∂x = gaîté")
+    @enum = @io.send(@method)
+  end
+
+  it "returns an Enumerator" do
+    @enum.should be_an_instance_of(enumerator_class)
+  end
+
+  it "yields each codepoint code in turn" do
+    @enum.to_a.should == [8706, 966, 47, 8706, 120, 32, 61, 32, 103, 97, 238, 116, 233]
+  end
+
+  it "yields each codepoint starting from the current position" do
+    @io.pos = 15
+    @enum.to_a.should == [238, 116, 233]
+  end
+
+  it "raises an error if reading invalid sequence" do
+    @io.pos = 1  # inside of a multibyte sequence
+    lambda { @enum.first }.should raise_error(ArgumentError)
+  end
+
+  it "raises an IOError if not readable" do
+    @io.close_read
+    lambda { @enum.to_a }.should raise_error(IOError)
+
+    io = StringIO.new("xyz", "w")
+    lambda { io.send(@method).to_a }.should raise_error(IOError)
+  end
+
+
+  it "calls the given block" do
+    r  = []
+    @io.send(@method){|c| r << c }
+    r.should == [8706, 966, 47, 8706, 120, 32, 61, 32, 103, 97, 238, 116, 233]
+  end
+
+  it "returns self" do
+    @io.send(@method) {|l| l }.should equal(@io)
+  end
+
+end

data/spec/shared/each.rb

@@ -0,0 +1,162 @@
+describe :stringio_each_separator, :shared => true do
+  before(:each) do
+    @io = StringIO.new("a b c d e\n1 2 3 4 5")
+    ScratchPad.record []
+  end
+
+  it "uses the passed argument as the line separator" do
+    seen = []
+    @io.send(@method, " ") {|s| seen << s}
+    seen.should == ["a ", "b ", "c ", "d ", "e\n1 ", "2 ", "3 ", "4 ", "5"]
+  end
+
+  it "does not change $_" do
+    $_ = "test"
+    @io.send(@method, " ") { |s| s}
+    $_.should == "test"
+  end
+
+  it "returns self" do
+    @io.send(@method) {|l| l }.should equal(@io)
+  end
+
+  ruby_version_is "1.9" do
+    it "returns at most limit characters when limit is positive" do
+      @io.send(@method, $/, 5) { |x| ScratchPad << x }
+      ScratchPad.recorded.should == ["a b c", " d e\n", "1 2 3", " 4 5"]
+    end
+
+    it "calls #to_str to convert a single argument to a String" do
+      sep = mock("stringio each sep")
+      sep.should_receive(:to_str).at_least(1).times.and_return($/)
+      sep.should_not_receive(:to_int)
+
+      @io.send(@method, sep) { |x| }
+    end
+
+    it "calls #to_int to convert a single argument if #to_str does not return a String" do
+      limit = mock("stringio each limit")
+      limit.should_receive(:to_str).at_least(1).times.and_return(nil)
+      limit.should_receive(:to_int).at_least(1).times.and_return(5)
+
+      @io.send(@method, limit) { |x| }
+    end
+
+    it "calls #to_int to convert the limit" do
+      limit = mock("stringio each limit")
+      limit.should_receive(:to_int).at_least(1).times.and_return(5)
+
+      @io.send(@method, limit) { |x| }
+    end
+
+    it "calls #to_int to convert the limit when passed separator and limit" do
+      limit = mock("stringio each limit")
+      limit.should_receive(:to_int).at_least(1).times.and_return(6)
+
+      @io.send(@method, $/, limit) { |x| }
+    end
+
+    it "raises an ArgumentError if length is 0 and #each is called on the Enumerator" do
+      enum = @io.send(@method, 0)
+      lambda { enum.each { } }.should raise_error(ArgumentError)
+    end
+
+    it "raises an ArgumentError if length is 0" do
+      lambda { @io.send(@method, 0) { } }.should raise_error(ArgumentError)
+    end
+  end
+
+  it "tries to convert the passed separator to a String using #to_str" do
+    obj = mock("to_str")
+    obj.stub!(:to_str).and_return(" ")
+
+    seen = []
+    @io.send(@method, obj) { |l| seen << l }
+    seen.should == ["a ", "b ", "c ", "d ", "e\n1 ", "2 ", "3 ", "4 ", "5"]
+  end
+
+  it "yields self's content starting from the current position when the passed separator is nil" do
+    seen = []
+    io = StringIO.new("1 2 1 2 1 2")
+    io.pos = 2
+    io.send(@method, nil) {|s| seen << s}
+    seen.should == ["2 1 2 1 2"]
+  end
+
+  ruby_bug "", "1.8.8" do
+    it "yields each paragraph when passed an empty String as separator" do
+      seen = []
+      io = StringIO.new("para1\n\npara2\n\n\npara3")
+      io.send(@method, "") {|s| seen << s}
+      seen.should == ["para1\n\n", "para2\n\n", "para3"]
+    end
+  end
+end
+
+describe :stringio_each_no_arguments, :shared => true do
+  before(:each) do
+    @io = StringIO.new("a b c d e\n1 2 3 4 5")
+  end
+
+  it "yields each line to the passed block" do
+    seen = []
+    @io.send(@method) {|s| seen << s }
+    seen.should == ["a b c d e\n", "1 2 3 4 5"]
+  end
+
+  it "yields each line starting from the current position" do
+    seen = []
+    @io.pos = 4
+    @io.send(@method) {|s| seen << s }
+    seen.should == ["c d e\n", "1 2 3 4 5"]
+  end
+
+  it "does not change $_" do
+    $_ = "test"
+    @io.send(@method) { |s| s}
+    $_.should == "test"
+  end
+
+  it "uses $/ as the default line separator" do
+    seen = []
+    begin
+      old_rs, $/ = $/, " "
+      @io.send(@method) {|s| seen << s }
+      seen.should eql(["a ", "b ", "c ", "d ", "e\n1 ", "2 ", "3 ", "4 ", "5"])
+    ensure
+      $/ = old_rs
+    end
+  end
+
+  it "returns self" do
+    @io.send(@method) {|l| l }.should equal(@io)
+  end
+
+  ruby_version_is "" ... "1.8.7" do
+    it "yields a LocalJumpError when passed no block" do
+      lambda { @io.send(@method) }.should raise_error(LocalJumpError)
+    end
+  end
+
+  ruby_version_is "1.8.7" do
+    it "returns an Enumerator when passed no block" do
+      enum = @io.send(@method)
+      enum.instance_of?(enumerator_class).should be_true
+
+      seen = []
+      enum.each { |b| seen << b }
+      seen.should == ["a b c d e\n", "1 2 3 4 5"]
+    end
+  end
+end
+
+describe :stringio_each_not_readable, :shared => true do
+  it "raises an IOError" do
+    io = StringIO.new("a b c d e", "w")
+    lambda { io.send(@method) { |b| b } }.should raise_error(IOError)
+
+    io = StringIO.new("a b c d e")
+    io.close_read
+    lambda { io.send(@method) { |b| b } }.should raise_error(IOError)
+  end
+end

data/spec/shared/each_byte.rb

@@ -0,0 +1,60 @@
+describe :stringio_each_byte, :shared => true do
+  before(:each) do
+    @io = StringIO.new("xyz")
+  end
+
+  it "yields each character code in turn" do
+    seen = []
+    @io.send(@method) { |b| seen << b }
+    seen.should == [120, 121, 122]
+  end
+
+  it "updates the position before each yield" do
+    seen = []
+    @io.send(@method) { |b| seen << @io.pos }
+    seen.should == [1, 2, 3]
+  end
+
+  it "does not yield if the current position is out of bounds" do
+    @io.pos = 1000
+    seen = nil
+    @io.send(@method) { |b| seen = b }
+    seen.should be_nil
+  end
+
+  ruby_version_is "" ... "1.8.7" do
+    it "returns nil" do
+      @io.send(@method) {}.should be_nil
+    end
+
+    it "yields a LocalJumpError when passed no block" do
+      lambda { @io.send(@method) }.should raise_error(LocalJumpError)
+    end
+  end
+
+  ruby_version_is "1.8.7" do
+    it "returns self" do
+      @io.send(@method) {}.should equal(@io)
+    end
+
+    it "returns an Enumerator when passed no block" do
+      enum = @io.send(@method)
+      enum.instance_of?(enumerator_class).should be_true
+
+      seen = []
+      enum.each { |b| seen << b }
+      seen.should == [120, 121, 122]
+    end
+  end
+end
+
+describe :stringio_each_byte_not_readable, :shared => true do
+  it "raises an IOError" do
+    io = StringIO.new("xyz", "w")
+    lambda { io.send(@method) { |b| b } }.should raise_error(IOError)
+
+    io = StringIO.new("xyz")
+    io.close_read
+    lambda { io.send(@method) { |b| b } }.should raise_error(IOError)
+  end
+end

data/spec/shared/each_char.rb

@@ -0,0 +1,50 @@
+# -*- encoding: utf-8 -*-
+describe :stringio_each_char, :shared => true do
+  before(:each) do
+    old_kcode, $KCODE = "UTF-8", $KCODE
+    @io = StringIO.new("xyz äöü")
+    $KCODE = old_kcode
+  end
+
+  it "yields each character code in turn" do
+    seen = []
+    @io.send(@method) { |c| seen << c }
+    seen.should == ["x", "y", "z", " ", "ä", "ö", "ü"]
+  end
+
+  ruby_version_is "" ... "1.8.7" do
+    it "returns nil" do
+      @io.send(@method) {}.should be_nil
+    end
+
+    it "yields a LocalJumpError when passed no block" do
+      lambda { @io.send(@method) }.should raise_error(LocalJumpError)
+    end
+  end
+
+  ruby_version_is "1.8.7" do
+    it "returns self" do
+      @io.send(@method) {}.should equal(@io)
+    end
+
+    it "returns an Enumerator when passed no block" do
+      enum = @io.send(@method)
+      enum.instance_of?(enumerator_class).should be_true
+
+      seen = []
+      enum.each { |c| seen << c }
+      seen.should == ["x", "y", "z", " ", "ä", "ö", "ü"]
+    end
+  end
+end
+
+describe :stringio_each_char_not_readable, :shared => true do
+  it "raises an IOError" do
+    io = StringIO.new("xyz", "w")
+    lambda { io.send(@method) { |b| b } }.should raise_error(IOError)
+
+    io = StringIO.new("xyz")
+    io.close_read
+    lambda { io.send(@method) { |b| b } }.should raise_error(IOError)
+  end
+end