rubysl-strscan 1.0.0

data/spec/bol_spec.rb

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

data/spec/check_spec.rb

@@ -0,0 +1,15 @@
+require 'strscan'
+
+describe "StringScanner#check" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the value that scan would return, without advancing the scan pointer" do
+    @s.check(/This/).should == "This"
+    @s.matched.should == "This"
+    @s.pos.should == 0
+    @s.check(/is/).should == nil
+    @s.matched.should == nil
+  end
+end

data/spec/check_until_spec.rb

@@ -0,0 +1,14 @@
+require 'strscan'
+
+describe "StringScanner#check_until" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the same value of scan_until, but don't advances the scan pointer" do
+    @s.check_until(/a/).should == "This is a"
+    @s.pos.should == 0
+    @s.matched.should == "a"
+    @s.check_until(/test/).should == "This is a test"
+  end
+end

data/spec/clear_spec.rb

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

data/spec/concat_spec.rb

@@ -0,0 +1,10 @@
+require File.expand_path('../shared/concat.rb', __FILE__)
+require 'strscan'
+
+describe "StringScanner#concat" do
+  it_behaves_like(:strscan_concat, :concat)
+end
+
+describe "StringScanner#concat when passed a Fixnum" do
+  it_behaves_like(:strscan_concat_fixnum, :concat)
+end

data/spec/dup_spec.rb

@@ -0,0 +1,38 @@
+require 'strscan'
+
+describe "StringScanner#dup" do
+  before(:each) do
+    @string = "this is a test"
+    @orig_s = StringScanner.new(@string)
+  end
+
+  it "copies the passed StringScanner's content to self" do
+    s = @orig_s.dup
+    s.string.should == @string
+  end
+
+  it "copies the passed StringSCanner's position to self" do
+    @orig_s.pos = 5
+    s = @orig_s.dup
+    s.pos.should eql(5)
+  end
+
+  it "copies previous match state" do
+    @orig_s.scan(/\w+/)
+    @orig_s.scan(/\s/)
+
+    @orig_s.pre_match.should == "this"
+
+    s = @orig_s.dup
+    s.pre_match.should == "this"
+
+    s.unscan
+    s.scan(/\s/).should == " "
+  end
+
+  it "copies the passed StringScanner scan pointer to self" do
+    @orig_s.terminate
+    s = @orig_s.dup
+    s.eos?.should be_true
+  end
+end

data/spec/element_reference_spec.rb

@@ -0,0 +1,48 @@
+require 'strscan'
+
+describe "StringScanner#[]" do
+  before :each do
+    @s = StringScanner.new("Fri Jun 13 2008 22:43")
+  end
+
+  it "returns nil if there is no current match" do
+    @s[0].should be_nil
+  end
+
+  it "returns the n-th subgroup in the most recent match" do
+    @s.scan(/(\w+) (\w+) (\d+) /)
+    @s[0].should == "Fri Jun 13 "
+    @s[1].should == "Fri"
+    @s[2].should == "Jun"
+    @s[3].should == "13"
+    @s[-3].should == "Fri"
+    @s[-2].should == "Jun"
+    @s[-1].should == "13"
+  end
+
+  it "returns nil if index is outside of self" do
+    @s.scan(/(\w+) (\w+) (\d+) /)
+    @s[5].should == nil
+    @s[-5].should == nil
+  end
+
+  it "calls to_int on the given index" do
+    @s.scan(/(\w+) (\w+) (\d+) /)
+    @s[0.5].should == "Fri Jun 13 "
+  end
+
+  it "raises a TypeError if the given index is nil" do
+    @s.scan(/(\w+) (\w+) (\d+) /)
+    lambda { @s[nil]}.should raise_error(TypeError)
+  end
+
+  it "raises a TypeError when a String is as argument" do
+    @s.scan(/(\w+) (\w+) (\d+) /)
+    lambda { @s["Fri"]}.should raise_error(TypeError)
+  end
+
+  it "raises a TypeError when a Range is as argument" do
+    @s.scan(/(\w+) (\w+) (\d+) /)
+    lambda { @s[0..2]}.should raise_error(TypeError)
+  end
+end

data/spec/empty_spec.rb

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

data/spec/eos_spec.rb

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

data/spec/exist_spec.rb

@@ -0,0 +1,23 @@
+require 'strscan'
+
+describe "StringScanner#exist?" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the index of the first occurrence of the given pattern" do
+    @s.exist?(/s/).should == 4
+    @s.scan(/This is/)
+    @s.exist?(/s/).should == 6
+  end
+
+  it "returns 0 if the pattern is empty" do
+    @s.exist?(//).should == 0
+  end
+
+  it "returns nil if the pattern isn't found in the string" do
+    @s.exist?(/S/).should == nil
+    @s.scan(/This is/)
+    @s.exist?(/i/).should == nil
+  end
+end

data/spec/get_byte_spec.rb

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

data/spec/getbyte_spec.rb

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

data/spec/getch_spec.rb

@@ -0,0 +1,43 @@
+require File.expand_path('../shared/extract_range', __FILE__)
+require 'strscan'
+
+describe "StringScanner#getch" do
+  before :each do
+    @kcode = $KCODE
+  end
+
+  after :each do
+    $KCODE = @kcode
+  end
+
+  it "scans one character and returns it" do
+    s = StringScanner.new('abc')
+    s.getch.should == "a"
+    s.getch.should == "b"
+    s.getch.should == "c"
+  end
+
+  it "is multi-byte character sensitive" do
+    $KCODE = 'EUC'
+
+    # Japanese hiragana "A" in EUC-JP
+    src = encode("\244\242", "euc-jp")
+
+    s = StringScanner.new(src)
+    s.getch.should == src
+  end
+
+  it "returns nil at the end of the string" do
+    # empty string case
+    s = StringScanner.new('')
+    s.getch.should == nil
+    s.getch.should == nil
+
+    # non-empty string case
+    s = StringScanner.new('a')
+    s.getch # skip one
+    s.getch.should == nil
+  end
+
+  it_behaves_like :extract_range, :getch
+end

data/spec/initialize_spec.rb

@@ -0,0 +1,27 @@
+require 'strscan'
+
+describe "StringScanner#initialize" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "is a private method" do
+    StringScanner.should have_private_instance_method(:initialize)
+  end
+
+  it "returns an instance of StringScanner" do
+    @s.should be_kind_of(StringScanner)
+    @s.tainted?.should be_false
+    @s.eos?.should be_false
+  end
+
+  it "converts the argument into a string using #to_str" do
+    m = mock(:str)
+
+    s = "test"
+    m.should_receive(:to_str).and_return(s)
+
+    scan = StringScanner.new(m)
+    scan.string.should == s
+  end
+end

data/spec/inspect_spec.rb

@@ -0,0 +1,19 @@
+require 'strscan'
+
+describe "StringScanner#inspect" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns a String object" do
+    @s.inspect.should be_kind_of(String)
+  end
+
+  it "returns a string that represents the StringScanner object" do
+    @s.inspect.should == "#<StringScanner 0/14 @ \"This ...\">"
+    @s.scan_until /is/
+    @s.inspect.should == "#<StringScanner 4/14 \"This\" @ \" is a...\">"
+    @s.terminate
+    @s.inspect.should == "#<StringScanner fin>"
+  end
+end

data/spec/match_spec.rb

@@ -0,0 +1,27 @@
+require 'strscan'
+
+describe "StringScanner#match?" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the length of the match and the scan pointer is not advanced" do
+    @s.match?(/\w+/).should == 4
+    @s.match?(/\w+/).should == 4
+    @s.pos.should == 0
+  end
+
+  it "returns nil if there's no match" do
+    @s.match?(/\d+/).should == nil
+    @s.match?(/\s+/).should == nil
+  end
+
+  it "effects pre_match" do
+    @s.scan(/\w+/)
+    @s.scan(/\s/)
+
+    @s.pre_match.should == "This"
+    @s.match?(/\w+/)
+    @s.pre_match.should == "This "
+  end
+end

data/spec/matched_size_spec.rb

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

data/spec/matched_spec.rb

@@ -0,0 +1,40 @@
+require File.expand_path('../shared/extract_range_matched', __FILE__)
+require 'strscan'
+
+describe "StringScanner#matched" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the last matched string" do
+    @s.match?(/\w+/)
+    @s.matched.should == "This"
+    @s.getch
+    @s.matched.should == "T"
+    @s.get_byte
+    @s.matched.should == "h"
+  end
+
+  it "returns nil if there's no match" do
+    @s.match?(/\d+/)
+    @s.matched.should == nil
+  end
+
+  it_behaves_like :extract_range_matched, :matched
+end
+
+describe "StringScanner#matched?" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns true if the last match was successful" do
+    @s.match?(/\w+/)
+    @s.matched?.should be_true
+  end
+
+  it "returns false if there's no match" do
+    @s.match?(/\d+/)
+    @s.matched?.should be_false
+  end
+end

data/spec/matchedsize_spec.rb

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