rubysl-strscan 1.0.0

data/spec/shared/eos.rb

@@ -0,0 +1,17 @@
+describe :strscan_eos, :shared => true do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "Returns true if the scan pointer is at the end of the string" do
+    @s.terminate
+    @s.send(@method).should be_true
+
+    s = StringScanner.new('')
+    s.send(@method).should be_true
+  end
+
+  it "Returns false if the scan pointer is not at the end of the string" do
+    @s.send(@method).should be_false
+  end
+end

data/spec/shared/extract_range.rb

@@ -0,0 +1,22 @@
+describe :extract_range, :shared => true do
+  it "returns an instance of String when passed a String subclass" do
+    cls = Class.new(String)
+    sub = cls.new("abc")
+
+    s = StringScanner.new(sub)
+    ch = s.send(@method)
+    ch.should_not be_kind_of(cls)
+    ch.should be_an_instance_of(String)
+  end
+
+  it "taints the returned String if the input was tainted" do
+    str = 'abc'
+    str.taint
+
+    s = StringScanner.new(str)
+
+    s.send(@method).tainted?.should be_true
+    s.send(@method).tainted?.should be_true
+    s.send(@method).tainted?.should be_true
+  end
+end

data/spec/shared/extract_range_matched.rb

@@ -0,0 +1,22 @@
+describe :extract_range_matched, :shared => true do
+  it "returns an instance of String when passed a String subclass" do
+    cls = Class.new(String)
+    sub = cls.new("abc")
+
+    s = StringScanner.new(sub)
+    s.scan(/\w{1}/)
+
+    ch = s.send(@method)
+    ch.should_not be_kind_of(cls)
+    ch.should be_an_instance_of(String)
+  end
+
+  it "taints the returned String if the input was tainted" do
+    str = 'abc'
+    str.taint
+
+    s = StringScanner.new(str)
+    s.scan(/\w{1}/)
+    s.send(@method).tainted?.should be_true
+  end
+end

data/spec/shared/get_byte.rb

@@ -0,0 +1,28 @@
+describe :strscan_get_byte, :shared => true do
+  it "scans one byte and returns it" do
+    s = StringScanner.new('abc5.')
+    s.send(@method).should == 'a'
+    s.send(@method).should == 'b'
+    s.send(@method).should == 'c'
+    s.send(@method).should == '5'
+    s.send(@method).should == '.'
+  end
+
+  it "is not multi-byte character sensitive" do
+    s = StringScanner.new("\244\242")
+    s.send(@method).should == "\244"
+    s.send(@method).should == "\242"
+  end
+
+  it "returns nil at the end of the string" do
+    # empty string case
+    s = StringScanner.new('')
+    s.send(@method).should == nil
+    s.send(@method).should == nil
+
+    # non-empty string case
+    s = StringScanner.new('a')
+    s.send(@method) # skip one
+    s.send(@method).should == nil
+  end
+end

data/spec/shared/matched_size.rb

@@ -0,0 +1,21 @@
+describe :strscan_matched_size, :shared => true do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+ it "returns the size of the most recent match" do
+    @s.check /This/
+    @s.send(@method).should == 4
+    @s.send(@method).should == 4
+    @s.scan //
+    @s.send(@method).should == 0
+  end
+
+  it "returns nil if there was no recent match" do
+    @s.send(@method).should == nil
+    @s.check /\d+/
+    @s.send(@method).should == nil
+    @s.terminate
+    @s.send(@method).should == nil
+  end
+end

data/spec/shared/peek.rb

@@ -0,0 +1,44 @@
+describe :strscan_peek, :shared => true do
+  before :each do
+    @s = StringScanner.new('This is a test')
+  end
+
+  it "returns at most the specified number of characters from the current position" do
+    @s.send(@method, 4).should == "This"
+    @s.pos.should == 0
+    @s.pos = 5
+    @s.send(@method, 2).should == "is"
+    @s.send(@method, 1000).should == "is a test"
+  end
+
+  it "returns an empty string when the passed argument is zero" do
+    @s.send(@method, 0).should == ""
+  end
+
+  it "raises a ArgumentError when the passed argument is negative" do
+    lambda { @s.send(@method, -2) }.should raise_error(ArgumentError)
+  end
+
+  it "raises a RangeError when the passed argument is a Bignum" do
+    lambda { @s.send(@method, bignum_value) }.should raise_error(RangeError)
+  end
+
+  it "returns an instance of String when passed a String subclass" do
+    cls = Class.new(String)
+    sub = cls.new("abc")
+
+    s = StringScanner.new(sub)
+
+    ch = s.send(@method, 1)
+    ch.should_not be_kind_of(cls)
+    ch.should be_an_instance_of(String)
+  end
+
+  it "taints the returned String if the input was tainted" do
+    str = 'abc'
+    str.taint
+
+    s = StringScanner.new(str)
+    s.send(@method, 1).tainted?.should be_true
+  end
+end

data/spec/shared/pos.rb

@@ -0,0 +1,83 @@
+# encoding: utf-8
+
+describe :strscan_pos, :shared => true do
+  before :each do
+    @s = StringScanner.new("This is a test")
+    @m = StringScanner.new("cölorfül")
+  end
+
+  it "returns the position of the scan pointer" do
+    @s.send(@method).should == 0
+    @s.scan_until /This is/
+    @s.send(@method).should == 7
+    @s.get_byte
+    @s.send(@method).should == 8
+    @s.terminate
+    @s.send(@method).should == 14
+  end
+
+  it "returns the position of the scan pointer for multibyte string" do
+    @m.send(@method).should == 0
+    @m.scan_until /cö/
+    @m.send(@method).should == 3
+    @m.get_byte
+    @m.send(@method).should == 4
+    @m.terminate
+    @m.send(@method).should == 10
+  end
+
+  it "returns 0 in the reset position" do
+    @s.reset
+    @s.send(@method).should == 0
+  end
+
+  it "returns the length of the string in the terminate position" do
+    @s.terminate
+    @s.send(@method).should == @s.string.length
+  end
+
+  it "returns the `bytesize` for multibyte string in the terminate position" do
+    @m.terminate
+    @m.send(@method).should == @m.string.bytesize
+    @m.send(@method).should >= @m.string.length
+  end
+end
+
+describe :strscan_pos_set, :shared => true do
+  before :each do
+    @s = StringScanner.new("This is a test")
+    @m = StringScanner.new("cölorfül")
+  end
+
+  it "modify the scan pointer" do
+    @s.send(@method, 5)
+    @s.rest.should == "is a test"
+  end
+
+  it "can poin position that greater than string length for multibyte string" do
+    @m.send(@method, 9)
+    @m.rest.should == "l"
+  end
+
+  it "positions from the end if the argument is negative" do
+    @s.send(@method, -2)
+    @s.rest.should == "st"
+    @s.pos.should == 12
+  end
+
+  it "positions from the end if the argument is negative for multibyte string" do
+    @m.send(@method, -3)
+    @m.rest.should == "ül"
+    @m.pos.should == 7
+  end
+
+  it "raises a RangeError if position too far backward" do
+    lambda {
+      @s.send(@method, -20)
+    }.should raise_error(RangeError)
+  end
+
+  it "raises a RangeError when the passed argument is out of range" do
+    lambda { @s.send(@method, 20) }.should raise_error(RangeError)
+  end
+end

data/spec/shared/rest_size.rb

@@ -0,0 +1,18 @@
+describe :strscan_rest_size, :shared => true do
+  before :each do
+    @s = StringScanner.new('This is a test')
+  end
+
+  it "Returns the length of the rest of the string" do
+    @s.send(@method).should == 14
+    @s.scan(/This/)
+    @s.send(@method).should == 10
+    @s.terminate
+    @s.send(@method).should == 0
+  end
+
+  it "is equivalent to rest.size" do
+    @s.scan(/This/)
+    @s.send(@method).should == @s.rest.size
+  end
+end

data/spec/shared/terminate.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+describe :strscan_terminate, :shared => true do
+  it "set the scan pointer to the end of the string and clear matching data." do
+    s = StringScanner.new('This is a test')
+    s.send(@method)
+    s.bol?.should be_false
+    s.eos?.should be_true
+  end
+
+  it "set the scan pointer to the end of the string and clear matching data for multibyte string." do
+    s = StringScanner.new('cölorfül')
+    s.send(@method)
+    s.bol?.should be_false
+    s.eos?.should be_true
+  end
+end

data/spec/skip_spec.rb

@@ -0,0 +1,17 @@
+require 'strscan'
+
+describe "StringScanner#skip" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns length of the match" do
+    @s.skip(/\w+/).should == 4
+    @s.skip(/\s+\w+/).should == 3
+  end
+
+  it "returns nil if there's no match" do
+    @s.skip(/\s+/).should == nil
+    @s.skip(/\d+/).should == nil
+  end
+end

data/spec/skip_until_spec.rb

@@ -0,0 +1,17 @@
+require 'strscan'
+
+describe "StringScanner#skip_until" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "returns the number of bytes advanced and advances the scan pointer until pattern is matched and consumed" do
+    @s.skip_until(/a/).should == 9
+    @s.pos.should == 9
+    @s.matched.should == "a"
+  end
+
+  it "returns nil if no match was found" do
+    @s.skip_until(/d+/).should == nil
+  end
+end

data/spec/string_spec.rb

@@ -0,0 +1,39 @@
+require 'strscan'
+
+describe "StringScanner#string" do
+  before :each do
+    @string = "This is a test"
+    @s = StringScanner.new(@string)
+  end
+
+  it "returns the string being scanned" do
+    @s.string.should == "This is a test"
+    @s << " case"
+    @s.string.should == "This is a test case"
+  end
+
+  it "returns the identical object passed in" do
+    @s.string.equal?(@string).should be_true
+  end
+end
+
+describe "StringScanner#string=" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "changes the string being scanned to the argument and resets the scanner" do
+    @s.string = "Hello world"
+    @s.string.should == "Hello world"
+  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)
+
+    @s.string = m
+    @s.string.should == s
+  end
+end

data/spec/terminate_spec.rb

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

data/spec/unscan_spec.rb

@@ -0,0 +1,28 @@
+require 'strscan'
+
+describe "StringScanner#unscan" do
+  before :each do
+    @s = StringScanner.new("This is a test")
+  end
+
+  it "set the scan pointer to the previous position" do
+    @s.scan(/This/)
+    @s.unscan
+    @s.matched.should == nil
+    @s.pos.should == 0
+  end
+
+  it "remember only one previous position" do
+    pos1 = @s.pos
+    @s.scan(/This/)
+    pos2 = @s.pos
+    @s.scan(/ is/)
+    @s.unscan
+    @s.pos.should == pos2
+  end
+
+  it "raises a ScanError when the previous match had failed" do
+    lambda { @s.unscan }.should raise_error(ScanError)
+    lambda { @s.scan(/\d/); @s.unscan }.should raise_error(ScanError)
+  end
+end

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification
+name: rubysl-strscan
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Brian Shirai
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: mspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+description: Ruby standard library strscan.
+email:
+- brixen@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/rubysl/strscan.rb
+- lib/rubysl/strscan/strscan.rb
+- lib/rubysl/strscan/version.rb
+- lib/strscan.rb
+- rubysl-strscan.gemspec
+- spec/append_spec.rb
+- spec/beginning_of_line_spec.rb
+- spec/bol_spec.rb
+- spec/check_spec.rb
+- spec/check_until_spec.rb
+- spec/clear_spec.rb
+- spec/concat_spec.rb
+- spec/dup_spec.rb
+- spec/element_reference_spec.rb
+- spec/empty_spec.rb
+- spec/eos_spec.rb
+- spec/exist_spec.rb
+- spec/get_byte_spec.rb
+- spec/getbyte_spec.rb
+- spec/getch_spec.rb
+- spec/initialize_spec.rb
+- spec/inspect_spec.rb
+- spec/match_spec.rb
+- spec/matched_size_spec.rb
+- spec/matched_spec.rb
+- spec/matchedsize_spec.rb
+- spec/must_C_version_spec.rb
+- spec/peek_spec.rb
+- spec/peep_spec.rb
+- spec/pointer_spec.rb
+- spec/pos_spec.rb
+- spec/post_match_spec.rb
+- spec/pre_match_spec.rb
+- spec/reset_spec.rb
+- spec/rest_size_spec.rb
+- spec/rest_spec.rb
+- spec/restsize_spec.rb
+- spec/scan_full_spec.rb
+- spec/scan_spec.rb
+- spec/scan_until_spec.rb
+- spec/search_full_spec.rb
+- spec/shared/bol.rb
+- spec/shared/concat.rb
+- spec/shared/eos.rb
+- spec/shared/extract_range.rb
+- spec/shared/extract_range_matched.rb
+- spec/shared/get_byte.rb
+- spec/shared/matched_size.rb
+- spec/shared/peek.rb
+- spec/shared/pos.rb
+- spec/shared/rest_size.rb
+- spec/shared/terminate.rb
+- spec/skip_spec.rb
+- spec/skip_until_spec.rb
+- spec/string_spec.rb
+- spec/terminate_spec.rb
+- spec/unscan_spec.rb
+homepage: https://github.com/rubysl/rubysl-strscan
+licenses:
+- BSD
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.7
+signing_key: 
+specification_version: 4
+summary: Ruby standard library strscan.
+test_files:
+- spec/append_spec.rb
+- spec/beginning_of_line_spec.rb
+- spec/bol_spec.rb
+- spec/check_spec.rb
+- spec/check_until_spec.rb
+- spec/clear_spec.rb
+- spec/concat_spec.rb
+- spec/dup_spec.rb
+- spec/element_reference_spec.rb
+- spec/empty_spec.rb
+- spec/eos_spec.rb
+- spec/exist_spec.rb
+- spec/get_byte_spec.rb
+- spec/getbyte_spec.rb
+- spec/getch_spec.rb
+- spec/initialize_spec.rb
+- spec/inspect_spec.rb
+- spec/match_spec.rb
+- spec/matched_size_spec.rb
+- spec/matched_spec.rb
+- spec/matchedsize_spec.rb
+- spec/must_C_version_spec.rb
+- spec/peek_spec.rb
+- spec/peep_spec.rb
+- spec/pointer_spec.rb
+- spec/pos_spec.rb
+- spec/post_match_spec.rb
+- spec/pre_match_spec.rb
+- spec/reset_spec.rb
+- spec/rest_size_spec.rb
+- spec/rest_spec.rb
+- spec/restsize_spec.rb
+- spec/scan_full_spec.rb
+- spec/scan_spec.rb
+- spec/scan_until_spec.rb
+- spec/search_full_spec.rb
+- spec/shared/bol.rb
+- spec/shared/concat.rb
+- spec/shared/eos.rb
+- spec/shared/extract_range.rb
+- spec/shared/extract_range_matched.rb
+- spec/shared/get_byte.rb
+- spec/shared/matched_size.rb
+- spec/shared/peek.rb
+- spec/shared/pos.rb
+- spec/shared/rest_size.rb
+- spec/shared/terminate.rb
+- spec/skip_spec.rb
+- spec/skip_until_spec.rb
+- spec/string_spec.rb
+- spec/terminate_spec.rb
+- spec/unscan_spec.rb