rubysl-stringio 1.0.0

data/spec/size_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../fixtures/classes', __FILE__)
+require File.expand_path('../shared/length', __FILE__)
+
+describe "StringIO#size" do
+  it_behaves_like :stringio_length, :size
+end

data/spec/string_spec.rb

@@ -0,0 +1,49 @@
+require File.expand_path('../fixtures/classes', __FILE__)
+
+describe "StringIO#string" do
+  it "returns the underlying string" do
+    io = StringIO.new(str = "hello")
+    io.string.should equal(str)
+  end
+end
+
+describe "StringIO#string=" do
+  before(:each) do
+    @io = StringIO.new("example\nstring")
+  end
+
+  it "returns the passed String" do
+    str = "test"
+    (@io.string = str).should equal(str)
+  end
+
+  it "changes the underlying string" do
+    str = "hello"
+    @io.string = str
+    @io.string.should equal(str)
+  end
+
+  it "resets the position" do
+    @io.pos = 1
+    @io.string = "other"
+    @io.pos.should eql(0)
+  end
+
+  it "resets the line number" do
+    @io.lineno = 1
+    @io.string = "other"
+    @io.lineno.should eql(0)
+  end
+
+  it "tries to convert the passed Object to a String using #to_str" do
+    obj = mock("to_str")
+    obj.should_receive(:to_str).and_return("to_str")
+
+    @io.string = obj
+    @io.string.should == "to_str"
+  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

data/spec/stringio_spec.rb

@@ -0,0 +1,8 @@
+require "stringio"
+
+describe "StringIO" do
+  it "includes the Enumerable module" do
+    StringIO.should include(Enumerable)
+  end
+end
+

data/spec/sync_spec.rb

@@ -0,0 +1,18 @@
+require File.expand_path('../fixtures/classes', __FILE__)
+
+describe "StringIO#sync" do
+  it "returns true" do
+    StringIO.new('').sync.should be_true
+  end
+end
+
+describe "StringIO#sync=" do
+  before(:each) do
+    @io = StringIO.new('')
+  end
+
+  it "does not change 'sync' status" do
+    @io.sync = false
+    @io.sync.should be_true
+  end
+end

data/spec/sysread_spec.rb

@@ -0,0 +1,27 @@
+require "stringio"
+require File.expand_path('../shared/read', __FILE__)
+require File.expand_path('../shared/sysread', __FILE__)
+
+describe "StringIO#sysread when passed length, buffer" do
+  it_behaves_like :stringio_read, :sysread
+end
+
+describe "StringIO#sysread when passed length" do
+  it_behaves_like :stringio_read_length, :sysread
+end
+
+describe "StringIO#sysread when passed no arguments" do
+  it_behaves_like :stringio_read_no_arguments, :sysread
+end
+
+describe "StringIO#sysread when self is not readable" do
+  it_behaves_like :stringio_read_not_readable, :sysread
+end
+
+describe "StringIO#sysread when passed nil" do
+  it_behaves_like :stringio_read_nil, :sysread
+end
+
+describe "StringIO#sysread when passed length" do
+  it_behaves_like :stringio_sysread_length, :sysread
+end

data/spec/syswrite_spec.rb

@@ -0,0 +1,18 @@
+require File.expand_path('../fixtures/classes', __FILE__)
+require File.expand_path('../shared/write', __FILE__)
+
+describe "StringIO#syswrite when passed [Object]" do
+  it_behaves_like :stringio_write, :syswrite
+end
+
+describe "StringIO#syswrite when passed [String]" do
+  it_behaves_like :stringio_write_string, :syswrite
+end
+
+describe "StringIO#syswrite when self is not writable" do
+  it_behaves_like :stringio_write_not_writable, :syswrite
+end
+
+describe "StringIO#syswrite when in append mode" do
+  it_behaves_like :stringio_write_append, :syswrite
+end

data/spec/tell_spec.rb

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

data/spec/truncate_spec.rb

@@ -0,0 +1,69 @@
+require "stringio"
+
+describe "StringIO#truncate when passed [length]" do
+  before(:each) do
+    @io = StringIO.new('123456789')
+  end
+
+  # TODO: Report to Ruby-Core: The RDoc says it always returns 0
+  it "returns the passed length" do
+    @io.truncate(4).should eql(4)
+    @io.truncate(10).should eql(10)
+  end
+
+  it "truncated the underlying string down to the passed length" do
+    @io.truncate(4)
+    @io.string.should == "1234"
+  end
+
+  it "does not create a copy of the underlying string" do
+    io = StringIO.new(str = "123456789")
+    io.truncate(4)
+    io.string.should equal(str)
+  end
+
+  it "does not change the position" do
+    @io.pos = 7
+    @io.truncate(4)
+    @io.pos.should eql(7)
+  end
+
+  it "can grow a string to a larger size, padding it with \\000" do
+    @io.truncate(12)
+    @io.string.should == "123456789\000\000\000"
+  end
+
+  it "raises an Errno::EINVAL when the passed length is negative" do
+    lambda { @io.truncate(-1) }.should raise_error(Errno::EINVAL)
+    lambda { @io.truncate(-10) }.should raise_error(Errno::EINVAL)
+  end
+
+  it "tries to convert the passed length to an Integer using #to_int" do
+    obj = mock("to_int")
+    obj.should_receive(:to_int).and_return(4)
+
+    @io.truncate(obj)
+    @io.string.should == "1234"
+  end
+
+  it "returns the passed length Object, NOT the result of #to_int" do
+    obj = mock("to_int")
+    obj.should_receive(:to_int).and_return(4)
+    @io.truncate(obj).should equal(obj)
+  end
+
+  it "raises a TypeError when the passed length can't be converted to an Integer" do
+    lambda { @io.truncate(Object.new) }.should raise_error(TypeError)
+  end
+end
+
+describe "StringIO#truncate when self is not writable" do
+  it "raises an IOError" do
+    io = StringIO.new("test", "r")
+    lambda { io.truncate(2) }.should raise_error(IOError)
+
+    io = StringIO.new("test")
+    io.close_write
+    lambda { io.truncate(2) }.should raise_error(IOError)
+  end
+end

data/spec/tty_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../fixtures/classes', __FILE__)
+require File.expand_path('../shared/isatty', __FILE__)
+
+describe "StringIO#tty?" do
+  it_behaves_like :stringio_isatty, :tty?
+end

data/spec/ungetbyte_spec.rb

@@ -0,0 +1,88 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../../../spec_helper', __FILE__)
+require File.expand_path('../fixtures/classes', __FILE__)
+
+ruby_version_is "1.9" do
+  describe "StringIO#ungetbyte" do
+    before :each do
+      @io = StringIO.new("abcdef")
+    end
+
+    it "returns nil" do
+      @io.ungetbyte(65).should be_nil
+    end
+
+    it "returns nil and does not modify data if passed nil" do
+      @io.read(2).should == "ab"
+      @io.ungetbyte(nil).should be_nil
+      @io.rewind
+      @io.read.should == "abcdef"
+    end
+
+    it "prepends the byte to the data before data is read" do
+      @io.ungetbyte(65)
+      @io.read(2).should == "Aa"
+    end
+
+    it "preserves the prepended bytes when #rewind is called" do
+      @io.ungetbyte(65)
+      @io.ungetbyte(66)
+      @io.rewind
+      @io.read.should == "BAabcdef"
+    end
+
+    it "prepends byte to the data at the current position" do
+      @io.read(3).should == "abc"
+      @io.ungetbyte(65)
+      @io.read(2).should == "Ad"
+    end
+
+    it "overwrites bytes in the data" do
+      @io.read(3).should == "abc"
+      @io.ungetbyte(66)
+      @io.ungetbyte(65)
+      @io.rewind
+      @io.read.should == "aABdef"
+    end
+
+    it "prepends a string to data before data is read" do
+      @io.ungetbyte("ghi")
+      @io.read.should == "ghiabcdef"
+    end
+
+    it "prepends a string at the current position" do
+      @io.read(2).should == "ab"
+      @io.ungetbyte("dceb")
+      @io.read.should == "dcebcdef"
+    end
+
+    it "calls #to_str to convert an object to a String" do
+      bytes = mock("stringio ungetbyte")
+      bytes.should_receive(:to_str).and_return("xyz")
+
+      @io.read(3).should == "abc"
+      @io.ungetbyte(bytes).should be_nil
+      @io.rewind
+      @io.read.should == "xyzdef"
+    end
+
+    it "raises an IOError when the mode is not readable" do
+      lambda { StringIO.new("", "w").ungetbyte(42) }.should raise_error(IOError)
+    end
+
+    it "raises an IOError when read is closed" do
+      @io.read
+      @io.close_read
+      lambda { @io.ungetbyte(42) }.should raise_error(IOError)
+    end
+
+    with_feature :encoding do
+      it "does not change the encoding of the data" do
+        @io.ungetbyte(0xff)
+        result = @io.read
+        result.should == "\xffabcdef"
+        result.encoding.should == Encoding::UTF_8
+      end
+    end
+  end
+end

data/spec/ungetc_spec.rb

@@ -0,0 +1,98 @@
+require File.expand_path('../fixtures/classes', __FILE__)
+
+describe "StringIO#ungetc when passed [char]" do
+  before(:each) do
+    @io = StringIO.new('1234')
+  end
+
+  it "writes the passed char before the current position" do
+    @io.pos = 1
+    @io.ungetc(?A)
+    @io.string.should == 'A234'
+  end
+
+  it "returns nil" do
+    @io.pos = 1
+    @io.ungetc(?A).should be_nil
+  end
+
+  it "decreases the current position by one" do
+    @io.pos = 2
+    @io.ungetc(?A)
+    @io.pos.should eql(1)
+  end
+
+  it "pads with \\000 when the current position is after the end" do
+    @io.pos = 15
+    @io.ungetc(?A)
+    @io.string.should == "1234\000\000\000\000\000\000\000\000\000\000A"
+  end
+
+  ruby_version_is "1.8.6" .. "1.8.6.367" do
+    it "does nothing when at the beginning of self" do
+      @io.ungetc(65)
+      @io.string.should == '1234'
+    end
+  end
+
+  ruby_version_is "" ... "1.9" do
+    it "tries to convert the passed length to an Integer using #to_int" do
+      obj = mock("to_int")
+      obj.should_receive(:to_int).and_return(?A)
+
+      @io.pos = 1
+      @io.ungetc(obj)
+      @io.string.should == "A234"
+    end
+
+    it "raises a TypeError when the passed length can't be converted to an Integer" do
+      lambda { @io.ungetc(Object.new) }.should raise_error(TypeError)
+      lambda { @io.ungetc("A") }.should raise_error(TypeError)
+    end
+  end
+
+  ruby_version_is "1.9" do
+    it "tries to convert the passed argument to an String using #to_str" do
+      obj = mock("to_str")
+      obj.should_receive(:to_str).and_return(?A)
+
+      @io.pos = 1
+      @io.ungetc(obj)
+      @io.string.should == "A234"
+    end
+
+    it "raises a TypeError when the passed length can't be converted to an Integer or String" do
+      lambda { @io.ungetc(Object.new) }.should raise_error(TypeError)
+    end
+  end
+end
+
+describe "StringIO#ungetc when self is not readable" do
+  it "raises an IOError" do
+    io = StringIO.new("test", "w")
+    io.pos = 1
+    lambda { io.ungetc(?A) }.should raise_error(IOError)
+
+    io = StringIO.new("test")
+    io.pos = 1
+    io.close_read
+    lambda { io.ungetc(?A) }.should raise_error(IOError)
+  end
+end
+
+# Note: This is incorrect.
+#
+# describe "StringIO#ungetc when self is not writable" do
+#   ruby_bug "#", "1.8.7.17" do
+#     it "raises an IOError" do
+#       io = StringIO.new("test", "r")
+#       io.pos = 1
+#       lambda { io.ungetc(?A) }.should raise_error(IOError)
+#
+#       io = StringIO.new("test")
+#       io.pos = 1
+#       io.close_write
+#       lambda { io.ungetc(?A) }.should raise_error(IOError)
+#     end
+#   end
+# end

data/spec/write_nonblock_spec.rb

@@ -0,0 +1,20 @@
+require File.expand_path('../fixtures/classes', __FILE__)
+require File.expand_path('../shared/write', __FILE__)
+
+ruby_version_is "1.9" do
+  describe "StringIO#write_nonblock when passed [Object]" do
+    it_behaves_like :stringio_write, :write_nonblock
+  end
+
+  describe "StringIO#write_nonblock when passed [String]" do
+    it_behaves_like :stringio_write_string, :write_nonblock
+  end
+
+  describe "StringIO#write_nonblock when self is not writable" do
+    it_behaves_like :stringio_write_not_writable, :write_nonblock
+  end
+
+  describe "StringIO#write_nonblock when in append mode" do
+    it_behaves_like :stringio_write_append, :write_nonblock
+  end
+end

data/spec/write_spec.rb

@@ -0,0 +1,18 @@
+require File.expand_path('../fixtures/classes', __FILE__)
+require File.expand_path('../shared/write', __FILE__)
+
+describe "StringIO#write when passed [Object]" do
+  it_behaves_like :stringio_write, :write
+end
+
+describe "StringIO#write when passed [String]" do
+  it_behaves_like :stringio_write_string, :write
+end
+
+describe "StringIO#write when self is not writable" do
+  it_behaves_like :stringio_write_not_writable, :write
+end
+
+describe "StringIO#write when in append mode" do
+  it_behaves_like :stringio_write_append, :write
+end