rubysl-strscan 1.0.0

data/spec/must_C_version_spec.rb

@@ -0,0 +1,7 @@
+require 'strscan'
+
+describe "StringScanner.must_C_version" do
+  it "returns self" do
+     StringScanner.must_C_version.should == StringScanner
+  end
+end

data/spec/peek_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path('../shared/peek.rb', __FILE__)
+require 'strscan'
+
+describe "StringScanner#peek" do
+  it_behaves_like(:strscan_peek, :peek)
+end
+

data/spec/peep_spec.rb

@@ -0,0 +1,24 @@
+require File.expand_path('../shared/peek.rb', __FILE__)
+require 'strscan'
+
+describe "StringScanner#peep" do
+  it_behaves_like(:strscan_peek, :peep)
+
+  it "warns in verbose mode that the method is obsolete" do
+    s = StringScanner.new("abc")
+    begin
+      old = $VERBOSE
+      lambda {
+        $VERBOSE = true
+        s.peep(1)
+      }.should complain(/peep.*obsolete.*peek/)
+
+      lambda {
+        $VERBOSE = false
+        s.peep(1)
+      }.should_not complain
+    ensure
+      $VERBOSE = old
+    end
+  end
+end

data/spec/pointer_spec.rb

@@ -0,0 +1,10 @@
+require File.expand_path('../shared/pos.rb', __FILE__)
+require 'strscan'
+
+describe "StringScanner#pointer" do
+  it_behaves_like(:strscan_pos, :pointer)
+end
+
+describe "StringScanner#pointer=" do
+  it_behaves_like(:strscan_pos_set, :pointer=)
+end

data/spec/pos_spec.rb

@@ -0,0 +1,10 @@
+require File.expand_path('../shared/pos.rb', __FILE__)
+require 'strscan'
+
+describe "StringScanner#pos" do
+  it_behaves_like(:strscan_pos, :pos)
+end
+
+describe "StringScanner#pos=" do
+  it_behaves_like(:strscan_pos_set, :pos=)
+end

data/spec/post_match_spec.rb

@@ -0,0 +1,27 @@
+require File.expand_path('../shared/extract_range_matched', __FILE__)
+require 'strscan'
+
+describe "StringScanner#post_match" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the post-match (in the regular expression sense) of the last scan" do
+    @s.post_match.should == nil
+    @s.scan(/\w+\s/)
+    @s.post_match.should == "is a test"
+    @s.getch
+    @s.post_match.should == "s a test"
+    @s.get_byte
+    @s.post_match.should == " a test"
+    @s.get_byte
+    @s.post_match.should == "a test"
+  end
+
+  it "returns nil if there's no match" do
+    @s.scan(/\s+/)
+    @s.post_match.should == nil
+  end
+
+  it_behaves_like :extract_range_matched, :post_match
+end

data/spec/pre_match_spec.rb

@@ -0,0 +1,40 @@
+require File.expand_path('../shared/extract_range_matched', __FILE__)
+require 'strscan'
+
+describe "StringScanner#pre_match" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the pre-match (in the regular expression sense) of the last scan" do
+    @s.pre_match.should == nil
+    @s.scan(/\w+\s/)
+    @s.pre_match.should == ""
+    @s.getch
+    @s.pre_match.should == "This "
+    @s.get_byte
+    @s.pre_match.should == "This i"
+    @s.get_byte
+    @s.pre_match.should == "This is"
+  end
+
+  it "returns nil if there's no match" do
+    @s.scan(/\s+/)
+    @s.pre_match.should == nil
+  end
+
+  it "is more than just the data from the last match" do
+    @s.scan(/\w+/)
+    @s.scan_until(/a te/)
+    @s.pre_match.should == "This is "
+  end
+
+  it "is not changed when the scanner's position changes" do
+    @s.scan_until(/\s+/)
+    @s.pre_match.should == "This"
+    @s.pos -= 1
+    @s.pre_match.should == "This"
+  end
+
+  it_behaves_like :extract_range_matched, :pre_match
+end

data/spec/reset_spec.rb

@@ -0,0 +1,14 @@
+require 'strscan'
+
+describe "StringScanner#reset" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "reset the scan pointer and clear matching data" do
+    @s.scan(/This/)
+    @s.reset
+    @s.pos.should == 0
+    @s.matched.should == nil
+  end
+end

data/spec/rest_size_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../shared/rest_size.rb', __FILE__)
+require 'strscan'
+
+describe "StringScanner#rest_size" do
+  it_behaves_like(:strscan_rest_size, :rest_size)
+end

data/spec/rest_spec.rb

@@ -0,0 +1,47 @@
+require File.expand_path('../shared/extract_range_matched', __FILE__)
+require 'strscan'
+
+describe "StringScanner#rest" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the rest of the string" do
+    @s.scan(/This\s+/)
+    @s.rest.should == "is a test"
+  end
+
+  it "returns self in the reset position" do
+    @s.reset
+    @s.rest.should == @s.string
+  end
+
+  it "returns an empty string in the terminate position" do
+    @s.terminate
+    @s.rest.should == ""
+  end
+
+  it_behaves_like :extract_range_matched, :rest
+
+end
+
+describe "StringScanner#rest?" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns true if there is more data in the string" do
+    @s.rest?.should be_true
+    @s.scan(/This/)
+    @s.rest?.should be_true
+  end
+
+  it "returns false if there is no more data in the string" do
+    @s.terminate
+    @s.rest?.should be_false
+  end
+
+  it "is the opposite of eos?" do
+    @s.rest?.should_not == @s.eos?
+  end
+end

data/spec/restsize_spec.rb

@@ -0,0 +1,24 @@
+require File.expand_path('../shared/rest_size.rb', __FILE__)
+require 'strscan'
+
+describe "StringScanner#restsize" do
+  it_behaves_like(:strscan_rest_size, :restsize)
+
+  it "warns in verbose mode that the method is obsolete" do
+    s = StringScanner.new("abc")
+    begin
+      old = $VERBOSE
+      lambda {
+        $VERBOSE = true
+        s.restsize
+      }.should complain(/restsize.*obsolete.*rest_size/)
+
+      lambda {
+        $VERBOSE = false
+        s.restsize
+      }.should_not complain
+    ensure
+      $VERBOSE = old
+    end
+  end
+end

data/spec/scan_full_spec.rb

@@ -0,0 +1,29 @@
+require 'strscan'
+
+describe "StringScanner#scan_full" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the number of bytes advanced" do
+    orig_pos = @s.pos
+    @s.scan_full(/This/, false, false).should == 4
+    @s.pos.should == orig_pos
+  end
+
+  it "returns the number of bytes advanced and advances the scan pointer if the second argument is true" do
+    @s.scan_full(/This/, true, false).should == 4
+    @s.pos.should == 4
+  end
+
+  it "returns the matched string if the third argument is true" do
+    orig_pos = @s.pos
+    @s.scan_full(/This/, false, true).should == "This"
+    @s.pos.should == orig_pos
+  end
+
+  it "returns the matched string if the third argument is true and advances the scan pointer if the second argument is true" do
+    @s.scan_full(/This/, true, true).should == "This"
+    @s.pos.should == 4
+  end
+end

data/spec/scan_spec.rb

@@ -0,0 +1,81 @@
+# -*- encoding: utf-8 -*-
+
+require File.expand_path('../../../spec_helper', __FILE__)
+require 'strscan'
+
+describe "StringScanner#scan" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+    @kcode = $KCODE
+  end
+
+  after :each do
+    $KCODE = @kcode
+  end
+
+  it "returns the matched string" do
+    @s.scan(/\w+/).should == "This"
+    @s.scan(/.../).should == " is"
+    @s.scan(//).should == ""
+    @s.scan(/\s+/).should == " "
+  end
+
+  ruby_version_is ""..."1.9" do
+    it "returns the first character for a multi byte string with no KCODE" do
+      $KCODE = 'NONE'
+      m = StringScanner.new("Привет!")
+      m.scan(/[А-Яа-я]+/).should == "\320\237\321"
+      m.rest.should == "\200\320\270\320\262\320\265\321\202!"
+    end
+
+    it "returns the matched string for a multi byte string with KCODE" do
+      $KCODE = 'UTF-8'
+      m = StringScanner.new("Привет!")
+      m.scan(/[А-Яа-я]+/).should == "Привет"
+      m.rest.should == "!"
+    end
+
+    it "returns the matched string for a multi byte string with unicode regexp" do
+      $KCODE = 'NONE'
+      m = StringScanner.new("Привет!")
+      m.scan(/[А-Яа-я]+/u).should == "Привет"
+      m.rest.should == "!"
+    end
+  end
+
+  ruby_version_is "1.9" do
+    it "returns the matched string for a multi byte string" do
+      m = StringScanner.new("Привет!")
+      m.scan(/[А-Яа-я]+/).should == "Привет"
+      m.rest.should == "!"
+    end
+  end
+
+  it "treats ^ as matching from the beginning of the current position" do
+    @s.scan(/\w+/).should == "This"
+    @s.scan(/^\d/).should be_nil
+    @s.scan(/^\s/).should == " "
+  end
+
+  it "returns nil if there's no match" do
+    @s.scan(/\d/).should == nil
+  end
+
+  it "returns nil when there is no more to scan" do
+    @s.scan(/[\w\s]+/).should == "This is a test"
+    @s.scan(/\w+/).should be_nil
+  end
+
+  it "returns an empty string when the pattern matches empty" do
+    @s.scan(/.*/).should == "This is a test"
+    @s.scan(/.*/).should == ""
+    @s.scan(/./).should be_nil
+  end
+
+  it "raises a TypeError if pattern isn't a Regexp" do
+    lambda { @s.scan("aoeu")    }.should raise_error(TypeError)
+    lambda { @s.scan(5)         }.should raise_error(TypeError)
+    lambda { @s.scan(:test)     }.should raise_error(TypeError)
+    lambda { @s.scan(mock('x')) }.should raise_error(TypeError)
+  end
+end

data/spec/scan_until_spec.rb

@@ -0,0 +1,22 @@
+require 'strscan'
+
+describe "StringScanner#scan_until" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the substring up to and including the end of the match" do
+   @s.scan_until(/a/).should == "This is a"
+   @s.pre_match.should == "This is "
+   @s.post_match.should == " test"
+  end
+
+  it "returns nil if there's no match" do
+    @s.scan_until(/\d/).should == nil
+  end
+
+  it "can match anchors properly" do
+    @s.scan(/T/)
+    @s.scan_until(/^h/).should == "h"
+  end
+end

data/spec/search_full_spec.rb

@@ -0,0 +1,29 @@
+require 'strscan'
+
+describe "StringScanner#search_full" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the number of bytes advanced" do
+    orig_pos = @s.pos
+    @s.search_full(/This/, false, false).should == 4
+    @s.pos.should == orig_pos
+  end
+
+  it "returns the number of bytes advanced and advances the scan pointer if the second argument is true" do
+    @s.search_full(/This/, true, false).should == 4
+    @s.pos.should == 4
+  end
+
+  it "returns the matched string if the third argument is true" do
+    orig_pos = @s.pos
+    @s.search_full(/This/, false, true).should == "This"
+    @s.pos.should == orig_pos
+  end
+
+  it "returns the matched string if the third argument is true and advances the scan pointer if the second argument is true" do
+    @s.search_full(/This/, true, true).should == "This"
+    @s.pos.should == 4
+  end
+end

data/spec/shared/bol.rb

@@ -0,0 +1,25 @@
+describe :strscan_bol, :shared => true do
+  it "returns true if the scan pointer is at the beginning of the line, false otherwise" do
+    s = StringScanner.new("This is a test")
+    s.send(@method).should be_true
+    s.scan(/This/)
+    s.send(@method).should be_false
+    s.terminate
+    s.send(@method).should be_false
+
+    s = StringScanner.new("hello\nworld")
+    s.bol?.should be_true
+    s.scan(/\w+/)
+    s.bol?.should be_false
+    s.scan(/\n/)
+    s.bol?.should be_true
+    s.unscan
+    s.bol?.should be_false
+  end
+
+  it "returns true if the scan pointer is at the end of the line of an empty string." do
+    s = StringScanner.new('')
+    s.terminate
+    s.send(@method).should be_true
+  end
+end

data/spec/shared/concat.rb

@@ -0,0 +1,30 @@
+describe :strscan_concat, :shared => true do
+  it "concatenates the given argument to self and returns self" do
+    s = StringScanner.new("hello ")
+    s.send(@method, 'world').should == s
+    s.string.should == "hello world"
+    s.eos?.should be_false
+  end
+
+  it "raises a TypeError if the given argument can't be converted to a String" do
+    lambda { a = StringScanner.new('hello').send(@method, :world)    }.should raise_error(TypeError)
+    lambda { a = StringScanner.new('hello').send(@method, mock('x')) }.should raise_error(TypeError)
+  end
+end
+
+describe :strscan_concat_fixnum, :shared => true do
+  it "raises a TypeError" do
+    a = StringScanner.new("hello world")
+    lambda { a.send(@method, 333) }.should raise_error(TypeError)
+    b = StringScanner.new("")
+    lambda { b.send(@method, (256 * 3 + 64)) }.should raise_error(TypeError)
+    lambda { b.send(@method, -200)           }.should raise_error(TypeError)
+  end
+
+  it "doesn't call to_int on the argument" do
+    x = mock('x')
+    x.should_not_receive(:to_int)
+
+    lambda { "".send(@method, x) }.should raise_error(TypeError)
+  end
+end