rubysl-stringio 1.0.0

data/spec/printf_spec.rb

@@ -0,0 +1,60 @@
+require File.expand_path('../fixtures/classes', __FILE__)
+
+describe "StringIO#printf" do
+  before(:each) do
+    @io = StringIO.new('example')
+  end
+
+  it "returns nil" do
+    @io.printf("%d %04x", 123, 123).should be_nil
+  end
+
+  it "pads self with \\000 when the current position is after the end" do
+    @io.pos = 10
+    @io.printf("%d", 123)
+    @io.string.should == "example\000\000\000123"
+  end
+
+  it "performs format conversion" do
+    @io.printf("%d %04x", 123, 123)
+    @io.string.should == "123 007b"
+  end
+
+  it "updates the current position" do
+    @io.printf("%d %04x", 123, 123)
+    @io.pos.should eql(8)
+
+    @io.printf("%d %04x", 123, 123)
+    @io.pos.should eql(16)
+   end
+end
+
+describe "StringIO#printf when in append mode" do
+  before(:each) do
+    @io = StringIO.new("example", "a")
+  end
+
+  it "appends the passed argument to the end of self" do
+    @io.printf("%d %04x", 123, 123)
+    @io.string.should == "example123 007b"
+
+    @io.printf("%d %04x", 123, 123)
+    @io.string.should == "example123 007b123 007b"
+  end
+
+  it "correctly updates self's position" do
+    @io.printf("%d %04x", 123, 123)
+    @io.pos.should eql(15)
+  end
+end
+
+describe "StringIO#printf when self is not writable" do
+  it "raises an IOError" do
+    io = StringIO.new("test", "r")
+    lambda { io.printf("test") }.should raise_error(IOError)
+
+    io = StringIO.new("test")
+    io.close_write
+    lambda { io.printf("test") }.should raise_error(IOError)
+  end
+end

data/spec/putc_spec.rb

@@ -0,0 +1,105 @@
+# -*- encoding: utf-8 -*-
+
+require File.expand_path('../../../spec_helper', __FILE__)
+require File.expand_path('../fixtures/classes', __FILE__)
+
+describe "StringIO#putc when passed [String]" do
+  before(:each) do
+    @io = StringIO.new('example')
+  end
+
+  it "overwrites the character at the current position" do
+    @io.putc("t")
+    @io.string.should == "txample"
+
+    @io.pos = 3
+    @io.putc("t")
+    @io.string.should == "txatple"
+  end
+
+  it "only writes the first character from the passed String" do
+    @io.putc("test")
+    @io.string.should == "txample"
+  end
+
+  it "returns the passed String" do
+    str = "test"
+    @io.putc(str).should equal(str)
+  end
+
+  it "correctly updates the current position" do
+    @io.putc("t")
+    @io.pos.should == 1
+
+    @io.putc("test")
+    @io.pos.should == 2
+
+    @io.putc("t")
+    @io.pos.should == 3
+  end
+
+
+  with_feature :encoding do
+
+    before :each do
+      @enc_io = StringIO.new("ëllø")
+    end
+
+    it "writes a byte into the io" do
+      @enc_io.putc("t")
+      @enc_io.string.should == "t\xABllø"
+    end
+
+  end
+
+end
+
+describe "StringIO#putc when passed [Object]" do
+  before(:each) do
+    @io = StringIO.new('example')
+  end
+
+  it "it writes the passed Integer % 256 to self" do
+    @io.putc(333) # 333 % 256 == ?M
+    @io.string.should == "Mxample"
+
+    @io.putc(-450) # -450 % 256 == ?>
+    @io.string.should == "M>ample"
+  end
+
+  it "pads self with \\000 when the current position is after the end" do
+    @io.pos = 10
+    @io.putc(?A)
+    @io.string.should == "example\000\000\000A"
+  end
+
+  it "tries to convert the passed argument to an Integer using #to_int" do
+    obj = mock('to_int')
+    obj.should_receive(:to_int).and_return(116)
+    @io.putc(obj)
+    @io.string.should == "txample"
+  end
+
+  it "raises a TypeError when the passed argument can't be coerced to Integer" do
+    lambda { @io.putc(Object.new) }.should raise_error(TypeError)
+  end
+end
+
+describe "StringIO#putc when in append mode" do
+  it "appends to the end of self" do
+    io = StringIO.new("test", "a")
+    io.putc(?t)
+    io.string.should == "testt"
+  end
+end
+
+describe "StringIO#putc when self is not writable" do
+  it "raises an IOError" do
+    io = StringIO.new("test", "r")
+    lambda { io.putc(?a) }.should raise_error(IOError)
+
+    io = StringIO.new("test")
+    io.close_write
+    lambda { io.putc("t") }.should raise_error(IOError)
+  end
+end

data/spec/puts_spec.rb

@@ -0,0 +1,173 @@
+# -*- encoding: utf-8 -*-
+
+require File.expand_path('../../../spec_helper', __FILE__)
+require File.expand_path('../fixtures/classes', __FILE__)
+
+describe "StringIO#puts when passed an Array" do
+  before(:each) do
+    @io = StringIO.new
+  end
+
+  it "writes each element of the passed Array to self, separated by a newline" do
+    @io.puts([1, 2, 3, 4])
+    @io.string.should == "1\n2\n3\n4\n"
+
+    @io.puts([1, 2], [3, 4])
+    @io.string.should == "1\n2\n3\n4\n1\n2\n3\n4\n"
+  end
+
+  it "flattens nested Arrays" do
+    @io.puts([1, [2, [3, [4]]]])
+    @io.string.should == "1\n2\n3\n4\n"
+  end
+
+  it "handles self-recursive arrays correctly" do
+    (ary = [5])
+    ary << ary
+    @io.puts(ary)
+    @io.string.should == "5\n[...]\n"
+  end
+
+  it "does not honor the global output record separator $\\" do
+    begin
+      old_rs, $\ = $\, "test"
+      @io.puts([1, 2, 3, 4])
+      @io.string.should == "1\n2\n3\n4\n"
+    ensure
+      $\ = old_rs
+    end
+  end
+
+  it "first tries to convert each Array element to an Array using #to_ary" do
+    obj = mock("Object")
+    obj.should_receive(:to_ary).and_return(["to_ary"])
+    @io.puts([obj])
+    @io.string.should == "to_ary\n"
+  end
+
+  it "then tries to convert each Array element to a String using #to_s" do
+    obj = mock("Object")
+    obj.should_receive(:to_s).and_return("to_s")
+    @io.puts([obj])
+    @io.string.should == "to_s\n"
+  end
+end
+
+describe "StringIO#puts when passed 1 or more objects" do
+  before(:each) do
+    @io = StringIO.new
+  end
+
+  it "does not honor the global output record separator $\\" do
+    begin
+      old_rs, $\ = $\, "test"
+      @io.puts(1, 2, 3, 4)
+      @io.string.should == "1\n2\n3\n4\n"
+    ensure
+      $\ = old_rs
+    end
+  end
+
+  it "does not put a \\n after each Objects that end in a newline" do
+    @io.puts("1\n", "2\n", "3\n")
+    @io.string.should == "1\n2\n3\n"
+  end
+
+  it "first tries to convert each Object to an Array using #to_ary" do
+    obj = mock("Object")
+    obj.should_receive(:to_ary).and_return(["to_ary"])
+    @io.puts(obj)
+    @io.string.should == "to_ary\n"
+  end
+
+  it "then tries to convert each Object to a String using #to_s" do
+    obj = mock("Object")
+    obj.should_receive(:to_s).and_return("to_s")
+    @io.puts(obj)
+    @io.string.should == "to_s\n"
+  end
+
+  it "prints a newline when passed an empty string" do
+    @io.puts ''
+    @io.string.should == "\n"
+  end
+
+  ruby_version_is ""..."1.9" do
+    it "prints a newline when passed nil" do
+      @io.puts nil
+      @io.string.should == "nil\n"
+    end
+  end
+
+  ruby_version_is "1.9" do
+    it "prints a newline when passed nil" do
+      @io.puts nil
+      @io.string.should == "\n"
+    end
+  end
+end
+
+describe "StringIO#puts when passed no arguments" do
+  before(:each) do
+    @io = StringIO.new
+  end
+
+  it "returns nil" do
+    @io.puts.should be_nil
+  end
+
+  it "prints a newline" do
+    @io.puts
+    @io.string.should == "\n"
+  end
+
+  it "does not honor the global output record separator $\\" do
+    begin
+      old_rs, $\ = $\, "test"
+      @io.puts
+      @io.string.should == "\n"
+    ensure
+      $\ = old_rs
+    end
+  end
+end
+
+describe "StringIO#puts when in append mode" do
+  before(:each) do
+    @io = StringIO.new("example", "a")
+  end
+
+  it "appends the passed argument to the end of self" do
+    @io.puts(", just testing")
+    @io.string.should == "example, just testing\n"
+
+    @io.puts(" and more testing")
+    @io.string.should == "example, just testing\n and more testing\n"
+  end
+
+  it "correctly updates self's position" do
+    @io.puts(", testing")
+    @io.pos.should eql(17)
+  end
+end
+
+describe "StringIO#puts when self is not writable" do
+  it "raises an IOError" do
+    io = StringIO.new("test", "r")
+    lambda { io.puts }.should raise_error(IOError)
+
+    io = StringIO.new("test")
+    io.close_write
+    lambda { io.puts }.should raise_error(IOError)
+  end
+end
+
+describe "StringIO#puts when passed an encoded string" do
+  it "stores the bytes unmodified" do
+    io = StringIO.new("")
+    io.puts "\x00\x01\x02"
+    io.puts "æåø"
+
+    io.string.should == "\x00\x01\x02\næåø\n"
+  end
+end

data/spec/read_nonblock_spec.rb

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

data/spec/read_spec.rb

@@ -0,0 +1,62 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../../../spec_helper', __FILE__)
+require "stringio"
+require File.expand_path('../shared/read', __FILE__)
+
+describe "StringIO#read when passed length, buffer" do
+  it_behaves_like :stringio_read, :read
+end
+
+describe "StringIO#read when passed length" do
+  it_behaves_like :stringio_read_length, :read
+
+  it "returns nil when passed length > 0 and no data remains" do
+    @io.send(@method, 8).should == "example"
+    @io.send(@method, 2).should be_nil
+  end
+
+  # This was filed as a bug in redmine#156 but since MRI refused to change the
+  # 1.8 behavior, it's now considered a version difference by RubySpec since
+  # it could have a significant impact on user code.
+  ruby_version_is ""..."1.9" do
+    it "returns nil when passed 0 and no data remains" do
+      @io.send(@method, 8).should == "example"
+      @io.send(@method, 0).should be_nil
+    end
+  end
+
+  ruby_version_is "1.9" do
+    it "returns an empty String when passed 0 and no data remains" do
+      @io.send(@method, 8).should == "example"
+      @io.send(@method, 0).should == ""
+    end
+
+    it "truncates the buffer when limit > 0 and no data remains" do
+      @io.send(@method)
+      @io.send(@method, 2, buffer = "abc").should be_nil
+      buffer.should == ""
+    end
+  end
+end
+
+describe "StringIO#read when passed no arguments" do
+  it_behaves_like :stringio_read_no_arguments, :read
+
+  it "returns an empty string if at EOF" do
+    @io.read.should == "example"
+    @io.read.should == ""
+  end
+end
+
+describe "StringIO#read when passed nil" do
+  it_behaves_like :stringio_read_nil, :read
+
+  it "returns an empty string if at EOF" do
+    @io.read(nil).should == "example"
+    @io.read(nil).should == ""
+  end
+end
+
+describe "StringIO#read when self is not readable" do
+  it_behaves_like :stringio_read_not_readable, :read
+end

data/spec/readbyte_spec.rb

@@ -0,0 +1,21 @@
+require 'stringio'
+require File.expand_path('../shared/readchar', __FILE__)
+
+ruby_version_is "1.8.7" do
+  describe "StringIO#readbyte" do
+    it_behaves_like :stringio_readchar, :readbyte
+
+    it "reads the next 8-bit byte from self's current position" do
+      io = StringIO.new("example")
+
+      io.send(@method).should == 101
+
+      io.pos = 4
+      io.send(@method).should == 112
+    end
+  end
+
+  describe "StringIO#readbyte when self is not readable" do
+    it_behaves_like :stringio_readchar_not_readable, :readbyte
+  end
+end