match_data_spec.rb in re2-1.0.0

- old
+ new
@@ -1,208 +1,244 @@
 # encoding: utf-8
-
-require "spec_helper"
-
-describe RE2::MatchData do
-
+RSpec.describe RE2::MatchData do
   describe "#to_a" do
     it "is populated with the match and capturing groups" do
       a = RE2::Regexp.new('w(o)(o)').match('woo').to_a
-      a.must_equal(["woo", "o", "o"])
+      expect(a).to eq(["woo", "o", "o"])
     end
 
     it "populates optional capturing groups with nil if they are missing" do
       a = RE2::Regexp.new('(\d?)(a)(b)').match('ab').to_a
-      a.must_equal(["ab", nil, "a", "b"])
+      expect(a).to eq(["ab", nil, "a", "b"])
     end
   end
 
   describe "#[]" do
     it "accesses capturing groups by numerical index" do
       md = RE2::Regexp.new('(\d)(\d{2})').match("123")
-      md[1].must_equal("1")
-      md[2].must_equal("23")
+      expect(md[1]).to eq("1")
+      expect(md[2]).to eq("23")
     end
 
     it "has the whole match as the 0th item" do
       md = RE2::Regexp.new('(\d)(\d{2})').match("123")
-      md[0].must_equal("123")
+      expect(md[0]).to eq("123")
     end
 
     it "supports access by numerical ranges" do
       md = RE2::Regexp.new('(\d+) (\d+) (\d+)').match("123 456 789")
-      md[1..3].must_equal(["123", "456", "789"])
-      md[1...3].must_equal(["123", "456"])
+      expect(md[1..3]).to eq(["123", "456", "789"])
+      expect(md[1...3]).to eq(["123", "456"])
     end
 
     it "supports slicing" do
       md = RE2::Regexp.new('(\d+) (\d+) (\d+)').match("123 456 789")
-      md[1, 3].must_equal(["123", "456", "789"])
-      md[1, 2].must_equal(["123", "456"])
+      expect(md[1, 3]).to eq(["123", "456", "789"])
+      expect(md[1, 2]).to eq(["123", "456"])
     end
 
     it "returns nil if attempting to access non-existent capturing groups by index" do
       md = RE2::Regexp.new('(\d+)').match('bob 123')
-      md[2].must_be_nil
-      md[3].must_be_nil
+      expect(md[2]).to be_nil
+      expect(md[3]).to be_nil
     end
 
     it "allows access by string names when there are named groups" do
       md = RE2::Regexp.new('(?P<numbers>\d+)').match('bob 123')
-      md["numbers"].must_equal("123")
+      expect(md["numbers"]).to eq("123")
     end
 
     it "allows access by symbol names when there are named groups" do
       md = RE2::Regexp.new('(?P<numbers>\d+)').match('bob 123')
-      md[:numbers].must_equal("123")
+      expect(md[:numbers]).to eq("123")
     end
 
     it "allows access by names and indices with mixed groups" do
       md = RE2::Regexp.new('(?P<name>\w+)(\s*)(?P<numbers>\d+)').match("bob 123")
-      md["name"].must_equal("bob")
-      md[:name].must_equal("bob")
-      md[2].must_equal(" ")
-      md["numbers"].must_equal("123")
-      md[:numbers].must_equal("123")
+      expect(md["name"]).to eq("bob")
+      expect(md[:name]).to eq("bob")
+      expect(md[2]).to eq(" ")
+      expect(md["numbers"]).to eq("123")
+      expect(md[:numbers]).to eq("123")
     end
 
     it "returns nil if no such named group exists" do
       md = RE2::Regexp.new('(\d+)').match("bob 123")
-      md["missing"].must_be_nil
-      md[:missing].must_be_nil
+      expect(md["missing"]).to be_nil
+      expect(md[:missing]).to be_nil
     end
 
     it "raises an error if given an inappropriate index" do
       md = RE2::Regexp.new('(\d+)').match("bob 123")
-      lambda { md[nil] }.must_raise(TypeError)
+      expect { md[nil] }.to raise_error(TypeError)
     end
 
     if String.method_defined?(:encoding)
       it "returns UTF-8 encoded strings by default" do
         md = RE2::Regexp.new('(?P<name>\S+)').match("bob")
-        md[0].encoding.name.must_equal("UTF-8")
-        md["name"].encoding.name.must_equal("UTF-8")
-        md[:name].encoding.name.must_equal("UTF-8")
+        expect(md[0].encoding.name).to eq("UTF-8")
+        expect(md["name"].encoding.name).to eq("UTF-8")
+        expect(md[:name].encoding.name).to eq("UTF-8")
       end
 
       it "returns Latin 1 strings encoding when utf-8 is false" do
         md = RE2::Regexp.new('(?P<name>\S+)', :utf8 => false).match('bob')
-        md[0].encoding.name.must_equal("ISO-8859-1")
-        md["name"].encoding.name.must_equal("ISO-8859-1")
-        md[:name].encoding.name.must_equal("ISO-8859-1")
+        expect(md[0].encoding.name).to eq("ISO-8859-1")
+        expect(md["name"].encoding.name).to eq("ISO-8859-1")
+        expect(md[:name].encoding.name).to eq("ISO-8859-1")
       end
     end
   end
 
   describe "#string" do
     it "returns the original string to match against" do
       re = RE2::Regexp.new('(\D+)').match("bob")
-      re.string.must_equal("bob")
+      expect(re.string).to eq("bob")
     end
 
     it "returns a copy, not the actual original" do
       string = "bob"
       re = RE2::Regexp.new('(\D+)').match(string)
-      re.string.wont_be_same_as(string)
+      expect(re.string).to_not equal(string)
     end
 
     it "returns a frozen string" do
       re = RE2::Regexp.new('(\D+)').match("bob")
-      re.string.must_be(:frozen?)
+      expect(re.string).to be_frozen
     end
   end
 
   describe "#size" do
     it "returns the number of capturing groups plus the matching string" do
       md = RE2::Regexp.new('(\d+) (\d+)').match("1234 56")
-      md.size.must_equal(3)
+      expect(md.size).to eq(3)
     end
   end
 
   describe "#length" do
     it "returns the number of capturing groups plus the matching string" do
       md = RE2::Regexp.new('(\d+) (\d+)').match("1234 56")
-      md.length.must_equal(3)
+      expect(md.length).to eq(3)
     end
   end
 
   describe "#regexp" do
     it "returns the original RE2::Regexp used" do
       re = RE2::Regexp.new('(\d+)')
       md = re.match("123")
-      md.regexp.must_be_same_as(re)
+      expect(md.regexp).to equal(re)
     end
   end
 
   describe "#inspect" do
     it "returns a text representation of the object and indices" do
       md = RE2::Regexp.new('(\d+) (\d+)').match("1234 56")
-      md.inspect.must_equal('#<RE2::MatchData "1234 56" 1:"1234" 2:"56">')
+      expect(md.inspect).to eq('#<RE2::MatchData "1234 56" 1:"1234" 2:"56">')
     end
 
     it "represents missing matches as nil" do
       md = RE2::Regexp.new('(\d+) (\d+)?').match("1234 ")
-      md.inspect.must_equal('#<RE2::MatchData "1234 " 1:"1234" 2:nil>')
+      expect(md.inspect).to eq('#<RE2::MatchData "1234 " 1:"1234" 2:nil>')
     end
   end
 
   describe "#to_s" do
     it "returns the matching part of the original string" do
       md = RE2::Regexp.new('(\d{2,5})').match("one two 23456")
-      md.to_s.must_equal("23456")
+      expect(md.to_s).to eq("23456")
     end
   end
 
   describe "#to_ary" do
     it "allows the object to be expanded with an asterisk" do
       md = RE2::Regexp.new('(\d+) (\d+)').match("1234 56")
       m1, m2, m3 = *md
-      m1.must_equal("1234 56")
-      m2.must_equal("1234")
-      m3.must_equal("56")
+      expect(m1).to eq("1234 56")
+      expect(m2).to eq("1234")
+      expect(m3).to eq("56")
     end
   end
 
   describe "#begin" do
     it "returns the offset of the start of a match by index" do
       md = RE2::Regexp.new('(wo{2})').match('a woohoo')
-      md.string[md.begin(0)..-1].must_equal('woohoo')
+      expect(md.string[md.begin(0)..-1]).to eq('woohoo')
     end
 
     it "returns the offset of the start of a match by string name" do
       md = RE2::Regexp.new('(?P<foo>fo{2})').match('a foobar')
-      md.string[md.begin('foo')..-1].must_equal('foobar')
+      expect(md.string[md.begin('foo')..-1]).to eq('foobar')
     end
 
     it "returns the offset of the start of a match by symbol name" do
       md = RE2::Regexp.new('(?P<foo>fo{2})').match('a foobar')
-      md.string[md.begin(:foo)..-1].must_equal('foobar')
+      expect(md.string[md.begin(:foo)..-1]).to eq('foobar')
     end
 
     it "returns the offset despite multibyte characters" do
       md = RE2::Regexp.new('(Ruby)').match('I ♥ Ruby')
-      md.string[md.begin(0)..-1].must_equal('Ruby')
+      expect(md.string[md.begin(0)..-1]).to eq('Ruby')
     end
+
+    it "returns nil for non-existent numerical matches" do
+      md = RE2::Regexp.new('(\d)').match('123')
+      expect(md.begin(10)).to be_nil
+    end
+
+    it "returns nil for negative numerical matches" do
+      md = RE2::Regexp.new('(\d)').match('123')
+      expect(md.begin(-4)).to be_nil
+    end
+
+    it "returns nil for non-existent named matches" do
+      md = RE2::Regexp.new('(\d)').match('123')
+      expect(md.begin('foo')).to be_nil
+    end
+
+    it "returns nil for non-existent symbol named matches" do
+      md = RE2::Regexp.new('(\d)').match('123')
+      expect(md.begin(:foo)).to be_nil
+    end
   end
 
   describe "#end" do
     it "returns the offset of the character following the end of a match" do
       md = RE2::Regexp.new('(wo{2})').match('a woohoo')
-      md.string[0...md.end(0)].must_equal('a woo')
+      expect(md.string[0...md.end(0)]).to eq('a woo')
     end
 
     it "returns the offset of a match by string name" do
       md = RE2::Regexp.new('(?P<foo>fo{2})').match('a foobar')
-      md.string[0...md.end('foo')].must_equal('a foo')
+      expect(md.string[0...md.end('foo')]).to eq('a foo')
     end
 
     it "returns the offset of a match by symbol name" do
       md = RE2::Regexp.new('(?P<foo>fo{2})').match('a foobar')
-      md.string[0...md.end(:foo)].must_equal('a foo')
+      expect(md.string[0...md.end(:foo)]).to eq('a foo')
     end
 
     it "returns the offset despite multibyte characters" do
       md = RE2::Regexp.new('(Ruby)').match('I ♥ Ruby')
-      md.string[0...md.end(0)].must_equal('I ♥ Ruby')
+      expect(md.string[0...md.end(0)]).to eq('I ♥ Ruby')
+    end
+
+    it "returns nil for non-existent numerical matches" do
+      md = RE2::Regexp.new('(\d)').match('123')
+      expect(md.end(10)).to be_nil
+    end
+
+    it "returns nil for negative numerical matches" do
+      md = RE2::Regexp.new('(\d)').match('123')
+      expect(md.end(-4)).to be_nil
+    end
+
+    it "returns nil for non-existent named matches" do
+      md = RE2::Regexp.new('(\d)').match('123')
+      expect(md.end('foo')).to be_nil
+    end
+
+    it "returns nil for non-existent symbol named matches" do
+      md = RE2::Regexp.new('(\d)').match('123')
+      expect(md.end(:foo)).to be_nil
     end
   end
 end