unicode_scanner 1.0.0 → 1.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3c4af50f958a0f776c150b29d75d8be14cae63083027c97700d568962f3ff020
+  data.tar.gz: 387b7ad90309e4200a4bbc13d0f62a54ddfbf8a0c58f24f8633a1b92bf927338
+SHA512:
+  metadata.gz: c83dca6ef92d2c0c8feafa4e879ae819dea0526b9c705e62145c18a66e8a0df02011451ef955462e7a5729754cefd716b1d7ecc08726b673b658084a6f227d8b
+  data.tar.gz: 45b3d8e86261a69c2ba48d1e7b866a67a2ccbe933f6c591a70ef834854cc162026018546ffc2d53be335c026437f2aef51fb4552723ca1c9997204aabb8a78fe

data/.rspec

@@ -1 +1,2 @@
 --color
+--format=documentation

data/.ruby-gemset

@@ -0,0 +1 @@
+scanner

data/.ruby-version

@@ -0,0 +1 @@
+3.2.0

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+rvm:
+- "3.0"
+- "2.7"
+- "2.6"
+- "2.5"
+before_install:
+- gem update --system
+- gem install bundler

data/Gemfile

@@ -1,11 +1,13 @@
-source :rubygems
+# frozen_string_literal: true
+
+source "https://rubygems.org"
 
 group :development do
-  gem 'rspec'
+  gem "rspec"
 
-  gem 'redcarpet'
-  gem 'yard'
+  gem "redcarpet"
+  gem "yard"
 
-  gem 'bundler'
-  gem 'jeweler'
+  gem "bundler"
+  gem "jeweler"
 end

data/Gemfile.lock

@@ -1,30 +1,82 @@
 GEM
-  remote: http://rubygems.org/
+  remote: https://rubygems.org/
   specs:
-    diff-lcs (1.1.3)
-    git (1.2.5)
-    jeweler (1.8.4)
-      bundler (~> 1.0)
+    addressable (2.4.0)
+    builder (3.2.4)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.5.0)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    git (1.11.0)
+      rchardet (~> 1.8)
+    github_api (0.16.0)
+      addressable (~> 2.4.0)
+      descendants_tracker (~> 0.0.4)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 3.4)
+      mime-types (>= 1.16, < 3.0)
+      oauth2 (~> 1.0)
+    hashie (5.0.0)
+    highline (2.0.3)
+    jeweler (2.3.9)
+      builder
+      bundler
       git (>= 1.2.5)
+      github_api (~> 0.16.0)
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      psych
       rake
       rdoc
-    json (1.7.3)
-    rake (0.9.2.2)
-    rdoc (3.12)
-      json (~> 1.4)
-    redcarpet (2.1.1)
-    rspec (2.11.0)
-      rspec-core (~> 2.11.0)
-      rspec-expectations (~> 2.11.0)
-      rspec-mocks (~> 2.11.0)
-    rspec-core (2.11.0)
-    rspec-expectations (2.11.1)
-      diff-lcs (~> 1.1.3)
-    rspec-mocks (2.11.1)
-    yard (0.8.2.1)
+      semver2
+    jwt (2.6.0)
+    mime-types (2.99.3)
+    mini_portile2 (2.8.1)
+    multi_json (1.15.0)
+    multi_xml (0.6.0)
+    multipart-post (2.2.3)
+    nokogiri (1.13.10)
+      mini_portile2 (~> 2.8.0)
+      racc (~> 1.4)
+    oauth2 (1.4.8)
+      faraday (>= 0.8, < 3.0)
+      jwt (>= 1.0, < 3.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    psych (5.0.1)
+      stringio
+    racc (1.6.2)
+    rack (2.2.5)
+    rake (13.0.6)
+    rchardet (1.8.0)
+    rdoc (6.5.0)
+      psych (>= 4.0.0)
+    redcarpet (3.5.1)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.0)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
+    semver2 (3.4.2)
+    stringio (3.0.4)
+    thread_safe (0.3.6)
+    webrick (1.7.0)
+    yard (0.9.28)
+      webrick (~> 1.7.0)
 
 PLATFORMS
-  ruby
+  arm64-darwin-22
+  x86_64-linux
 
 DEPENDENCIES
   bundler
@@ -32,3 +84,6 @@ DEPENDENCIES
   redcarpet
   rspec
   yard
+
+BUNDLED WITH
+   2.4.1

data/README.md

@@ -1,3 +1,9 @@
+## ⚠️ DEPRECATED
+
+**This gem is no longer actively maintained.** It is stable. Modern Ruby (3.x+) has improved Unicode-aware `StringScanner` behavior; consider the standard library [`StringScanner`](https://docs.ruby-lang.org/en/3.3/StringScanner.html) for new code.
+
+---
+
 Unicode String Scanner
 ======================
 

data/Rakefile

@@ -1,39 +1,39 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
-require 'rubygems'
-require 'bundler'
+require "rubygems"
+require "bundler"
 begin
   Bundler.setup(:default, :development)
 rescue Bundler::BundlerError => e
-  $stderr.puts e.message
-  $stderr.puts "Run `bundle install` to install missing gems"
+  warn e.message
+  warn "Run `bundle install` to install missing gems"
   exit e.status_code
 end
-require 'rake'
+require "rake"
 
-require 'jeweler'
+require "jeweler"
 Jeweler::Tasks.new do |gem|
   # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
   gem.name        = "unicode_scanner"
   gem.homepage    = "http://github.com/RISCfuture/unicode_scanner"
   gem.license     = "MIT"
-  gem.summary     = %Q{Unicode-aware implementation of StringScanner}
-  gem.description = %Q{An implementation of StringScanner that doesn't split multibyte characters.}
+  gem.summary     = %(Unicode-aware implementation of StringScanner)
+  gem.description = %(An implementation of StringScanner that doesn't split multibyte characters.)
   gem.email       = "git@timothymorgan.info"
   gem.authors     = ["Tim Morgan"]
   # dependencies defined in Gemfile
 end
 Jeweler::RubygemsDotOrgTasks.new
 
-require 'rspec/core'
-require 'rspec/core/rake_task'
+require "rspec/core"
+require "rspec/core/rake_task"
 RSpec::Core::RakeTask.new(:spec) do |spec|
-  spec.pattern = FileList['spec/**/*_spec.rb']
+  spec.pattern = FileList["spec/**/*_spec.rb"]
 end
 
 task default: :spec
 
-require 'yard'
+require "yard"
 
 # bring sexy back (sexy == tables)
 module YARD::Templates::Helpers::HtmlHelper
@@ -42,12 +42,12 @@ module YARD::Templates::Helpers::HtmlHelper
   end
 end
 
-YARD::Rake::YardocTask.new('doc') do |doc|
-  doc.options << '-m' << 'markdown' << '-M' << 'redcarpet'
-  doc.options << '--protected' << '--no-private'
-  doc.options << '-r' << 'README.md'
-  doc.options << '-o' << 'doc'
-  doc.options << '--title' << 'Unicode String Scanner Documentation'
+YARD::Rake::YardocTask.new("doc") do |doc|
+  doc.options << "-m" << "markdown" << "-M" << "redcarpet"
+  doc.options << "--protected" << "--no-private"
+  doc.options << "-r" << "README.md"
+  doc.options << "-o" << "doc"
+  doc.options << "--title" << "Unicode String Scanner Documentation"
 
-  doc.files = %w( lib/**/* README.md )
+  doc.files = %w[lib/**/* README.md]
 end

data/VERSION

@@ -1 +1 @@
-1.0.0
+1.0.2

data/lib/unicode_scanner.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # UnicodeScanner provides for Unicode-aware lexical scanning operations on a
 # `String`.  Here is an example of its usage:
 #
@@ -165,8 +167,9 @@ class UnicodeScanner
   #   s.bol?           # => true
 
   def beginning_of_line?
-    return nil if @current > @string.length
-    return true if @current == 0
+    return nil if @current > @string.size
+    return true if @current.zero?
+
     return @string[@current - 1] == "\n"
   end
 
@@ -259,7 +262,8 @@ class UnicodeScanner
 
   def getch
     return nil if eos?
-    do_scan /./u, true, true, true
+
+    do_scan(/./u, true, true, true)
   end
 
   # Returns a string that represents the UnicodeScanner object, showing:
@@ -277,14 +281,23 @@ class UnicodeScanner
   #   s.inspect # -> '#<UnicodeScanner 10/21 "...ec 12" @ " 1975...">'
 
   def inspect
-    return "#<#{self.class.to_s} (uninitialized)>" if @string.nil?
-    return "#<#{self.class.to_s} fin>" if eos?
-
-    if @current == 0
-      return "#<%s %d/%d @ %s>" % [self.class.to_s, @current, @string.length, inspect_after.inspect]
+    return "#<#{self.class} (uninitialized)>" if @string.nil?
+    return "#<#{self.class} fin>" if eos?
+
+    if @current.zero?
+      return format("#<%{class} %<cur>d/%<len>d @ %{after}>",
+                    class: self.class.to_s,
+                    cur:   @current,
+                    len:   @string.length,
+                    after: inspect_after.inspect)
     end
 
-    "#<%s %d/%d %s @ %s>" % [self.class.to_s, @current, @string.length, inspect_before.inspect, inspect_after.inspect]
+    format("#<%{class} %<cur>d/%<len>d %{before} @ %{after}>",
+           class:  self.class.to_s,
+           cur:    @current,
+           len:    @string.length,
+           before: inspect_before.inspect,
+           after:  inspect_after.inspect)
   end
 
   # Tests whether the given `pattern` is matched from the current scan pointer.
@@ -311,6 +324,7 @@ class UnicodeScanner
 
   def matched
     return nil unless @matched
+
     @matches[0]
   end
 
@@ -335,6 +349,7 @@ class UnicodeScanner
 
   def matched_size
     return nil unless @matched
+
     @matches.end(0) - @matches.begin(0)
   end
 
@@ -350,7 +365,8 @@ class UnicodeScanner
   #   s.peek(7)          # => "test st"
 
   def peek(len)
-    return '' if eos?
+    return "" if eos?
+
     @string[@current, len]
   end
 
@@ -384,9 +400,10 @@ class UnicodeScanner
   #   s.rest               # -> "ring"
 
   def pos=(n)
-    n += @string.length if n < 0
-    raise RangeError, "index out of range" if n < 0
+    n += @string.length if n.negative?
+    raise RangeError, "index out of range" if n.negative?
     raise RangeError, "index out of range" if n > @string.length
+
     @current = n
   end
 
@@ -401,6 +418,7 @@ class UnicodeScanner
 
   def post_match
     return nil unless @matched
+
     @string[@previous + @matches.end(0), @string.length]
   end
 
@@ -415,6 +433,7 @@ class UnicodeScanner
 
   def pre_match
     return nil unless @matched
+
     @string[0, @previous + @matches.begin(0)]
   end
 
@@ -429,7 +448,8 @@ class UnicodeScanner
   #   pointer). If there is no more data (`eos? = true`), it returns `""`.
 
   def rest
-    return '' if eos?
+    return "" if eos?
+
     return @string[@current, @string.length]
   end
 
@@ -437,6 +457,7 @@ class UnicodeScanner
 
   def rest_size
     return 0 if eos?
+
     @string.length - @current
   end
 
@@ -550,7 +571,7 @@ class UnicodeScanner
 
   # @return [String] The string being scanned.
 
-  def string() @string end
+  attr_reader :string
 
   # Changes the string being scanned to `str` and resets the scanner.
   #
@@ -561,7 +582,6 @@ class UnicodeScanner
     @string  = str
     @matched = false
     @current = 0
-    str
   end
 
   # Set the scan pointer to the end of the string and clear matching data.
@@ -586,6 +606,7 @@ class UnicodeScanner
 
   def unscan
     raise ScanError, "unscan failed: previous match record not exist" unless @matched
+
     @current = @previous
     @matched = false
     self
@@ -602,7 +623,7 @@ class UnicodeScanner
     @matches = regex.match(@string[@current, @string.length])
     return nil unless @matches
 
-    if head_only && @matches.begin(0) > 0
+    if head_only && @matches.begin(0).positive?
       @matches = nil
       return nil
     end
@@ -611,21 +632,20 @@ class UnicodeScanner
 
     @previous = @current
     @current += @matches.end(0) if advance_pointer
-    if return_string
-      return @string[@previous, @matches.end(0)]
-    else
-      return @matches.end(0)
-    end
+
+    return @string[@previous, @matches.end(0)] if return_string
+
+    return @matches.end(0)
   end
 
-  def inspect_before # inspect1
-    return '' if @current == 0
+  def inspect_before
+    return "" if @current.zero?
 
-    str = String.new
+    str = +""
     len = 0
 
     if @current > INSPECT_LENGTH
-      str << '...'
+      str << "..."
       len = INSPECT_LENGTH
     else
       len = @current
@@ -635,15 +655,15 @@ class UnicodeScanner
     return str
   end
 
-  def inspect_after # inspect2
-    return '' if eos?
+  def inspect_after
+    return "" if eos?
 
-    str = String.new
+    str = +""
     len = @string.length - @current
     if len > INSPECT_LENGTH
       len = INSPECT_LENGTH
       str << @string[@current, len]
-      str << '...'
+      str << "..."
     else
       str << @string[@current, len]
     end

data/spec/spec_helper.rb

@@ -1,12 +1,100 @@
-$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
-$LOAD_PATH.unshift(File.dirname(__FILE__))
-require 'rspec'
-require 'unicode_scanner'
-
-# Requires supporting files with custom matchers and macros, etc,
-# in ./support/ and its subdirectories.
-Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+# frozen_string_literal: true
 
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
 RSpec.configure do |config|
-  
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will
+  # have no way to turn it off -- the option exists only for backwards
+  # compatibility in RSpec 3). It causes shared context metadata to be
+  # inherited by the metadata hash of host groups and examples, rather than
+  # triggering implicit auto-inclusion in groups with matching metadata.
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+  # This allows you to limit a spec run to individual examples or groups
+  # you care about by tagging them with `:focus` metadata. When nothing
+  # is tagged with `:focus`, all examples get run. RSpec also provides
+  # aliases for `it`, `describe`, and `context` that include `:focus`
+  # metadata: `fit`, `fdescribe` and `fcontext`, respectively.
+  config.filter_run_when_matching :focus
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = "doc"
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
 end
+
+require "unicode_scanner"

data/spec/unicode_scanner_spec.rb

@@ -1,206 +1,206 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
-require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require File.expand_path("#{File.dirname(__FILE__)}/spec_helper")
 
-describe UnicodeScanner do
-  it "should pass all the class-level examples" do
-    s = UnicodeScanner.new('This is an example string')
-    s.eos?.should == false
+RSpec.describe UnicodeScanner do
+  it "passes all the class-level examples" do
+    s = described_class.new("This is an example string")
+    expect(s.eos?).to be(false)
 
-    s.scan(/\w+/).should == "This"
-    s.scan(/\w+/).should == nil
-    s.scan(/\s+/).should == " "
-    s.scan(/\s+/).should == nil
-    s.scan(/\w+/).should == "is"
-    s.eos?.should == false
+    expect(s.scan(/\w+/)).to eq("This")
+    expect(s.scan(/\w+/)).to be_nil
+    expect(s.scan(/\s+/)).to eq(" ")
+    expect(s.scan(/\s+/)).to be_nil
+    expect(s.scan(/\w+/)).to eq("is")
+    expect(s.eos?).to be(false)
 
-    s.scan(/\s+/).should == " "
-    s.scan(/\w+/).should == "an"
-    s.scan(/\s+/).should == " "
-    s.scan(/\w+/).should == "example"
-    s.scan(/\s+/).should == " "
-    s.scan(/\w+/).should == "string"
-    s.eos?.should == true
+    expect(s.scan(/\s+/)).to eq(" ")
+    expect(s.scan(/\w+/)).to eq("an")
+    expect(s.scan(/\s+/)).to eq(" ")
+    expect(s.scan(/\w+/)).to eq("example")
+    expect(s.scan(/\s+/)).to eq(" ")
+    expect(s.scan(/\w+/)).to eq("string")
+    expect(s.eos?).to be(true)
 
-    s.scan(/\s+/).should == nil
-    s.scan(/\w+/).should == nil
+    expect(s.scan(/\s+/)).to be_nil
+    expect(s.scan(/\w+/)).to be_nil
   end
 
-  it "should pass the #concat example" do
-    s = UnicodeScanner.new("Fri Dec 12 1975 14:39")
+  it "passes the #concat example" do
+    s = described_class.new(+"Fri Dec 12 1975 14:39")
     s.scan(/Fri /)
     s << " +1000 GMT"
-    s.string.should == "Fri Dec 12 1975 14:39 +1000 GMT"
-    s.scan(/Dec/).should == "Dec"
+    expect(s.string).to eq("Fri Dec 12 1975 14:39 +1000 GMT")
+    expect(s.scan(/Dec/)).to eq("Dec")
   end
 
-  it "should pass the #[] example" do
-    s = UnicodeScanner.new("Fri Dec 12 1975 14:39")
-    s.scan(/(\w+) (\w+) (\d+) /).should == "Fri Dec 12 "
-    s[0].should == "Fri Dec 12 "
-    s[1].should == "Fri"
-    s[2].should == "Dec"
-    s[3].should == "12"
-    s.post_match.should == "1975 14:39"
-    s.pre_match.should == ""
+  it "passes the #[] example" do
+    s = described_class.new("Fri Dec 12 1975 14:39")
+    expect(s.scan(/(\w+) (\w+) (\d+) /)).to eq("Fri Dec 12 ")
+    expect(s[0]).to eq("Fri Dec 12 ")
+    expect(s[1]).to eq("Fri")
+    expect(s[2]).to eq("Dec")
+    expect(s[3]).to eq("12")
+    expect(s.post_match).to eq("1975 14:39")
+    expect(s.pre_match).to eq("")
   end
 
-  it "should pass the #beginning_of_line? example" do
-    s = UnicodeScanner.new("test\ntest\n")
-    s.bol?.should == true
+  it "passes the #beginning_of_line? example" do
+    s = described_class.new("test\ntest\n")
+    expect(s.bol?).to be(true)
     s.scan(/te/)
-    s.bol?.should == false
+    expect(s.bol?).to be(false)
     s.scan(/st\n/)
-    s.bol?.should == true
+    expect(s.bol?).to be(true)
     s.terminate
-    s.bol?.should == true
+    expect(s.bol?).to be(true)
   end
 
-  it "should pass the #check example" do
-    s = UnicodeScanner.new("Fri Dec 12 1975 14:39")
-    s.check(/Fri/).should == "Fri"
-    s.pos.should == 0
-    s.matched.should == "Fri"
-    s.check(/12/).should == nil
-    s.matched.should == nil
+  it "passes the #check example" do
+    s = described_class.new("Fri Dec 12 1975 14:39")
+    expect(s.check(/Fri/)).to eq("Fri")
+    expect(s.pos).to eq(0)
+    expect(s.matched).to eq("Fri")
+    expect(s.check(/12/)).to be_nil
+    expect(s.matched).to be_nil
   end
 
-  it "should pass the #check_until example" do
-    s = UnicodeScanner.new("Fri Dec 12 1975 14:39")
-    s.check_until(/12/).should == "Fri Dec 12"
-    s.pos.should == 0
-    s.matched.should == "12"
+  it "passes the #check_until example" do
+    s = described_class.new("Fri Dec 12 1975 14:39")
+    expect(s.check_until(/12/)).to eq("Fri Dec 12")
+    expect(s.pos).to eq(0)
+    expect(s.matched).to eq("12")
   end
 
-  it "should pass the #eos? example" do
-    s = UnicodeScanner.new('test string')
-    s.eos?.should == false
+  it "passes the #eos? example" do
+    s = described_class.new("test string")
+    expect(s.eos?).to be(false)
     s.scan(/test/)
-    s.eos?.should == false
+    expect(s.eos?).to be(false)
     s.terminate
-    s.eos?.should == true
+    expect(s.eos?).to be(true)
   end
 
-  it "should pass the #exist? example" do
-    s = UnicodeScanner.new('test string')
-    s.exist?(/s/).should == 3
-    s.scan(/test/).should == "test"
-    s.exist?(/s/).should == 2
-    s.exist?(/e/).should == nil
+  it "passes the #exist? example" do
+    s = described_class.new("test string")
+    expect(s.exist?(/s/)).to eq(3)
+    expect(s.scan(/test/)).to eq("test")
+    expect(s.exist?(/s/)).to eq(2)
+    expect(s.exist?(/e/)).to be_nil
   end
 
-  it "should pass a tweaked version of the #getch example" do
-    s = UnicodeScanner.new("ab")
-    s.getch.should == "a"
-    s.getch.should == "b"
-    s.getch.should == nil
+  it "passes a tweaked version of the #getch example" do
+    s = described_class.new("ab")
+    expect(s.getch).to eq("a")
+    expect(s.getch).to eq("b")
+    expect(s.getch).to be_nil
 
-    s = UnicodeScanner.new("ぁ")
-    s.getch.should == "ぁ" # Japanese hira-kana "A" in EUC-JP
-    s.getch.should == nil
+    s = described_class.new("ぁ")
+    expect(s.getch).to eq("ぁ") # Japanese hira-kana "A" in EUC-JP
+    expect(s.getch).to be_nil
   end
 
-  it "should pass the #inspect example" do
-    s = UnicodeScanner.new("Fri Dec 12 1975 14:39")
-    s.inspect.should == '#<UnicodeScanner 0/21 @ "Fri D...">'
-    s.scan_until(/12/).should == "Fri Dec 12"
-    s.inspect.should == '#<UnicodeScanner 10/21 "...ec 12" @ " 1975...">'
+  it "passes the #inspect example" do
+    s = described_class.new("Fri Dec 12 1975 14:39")
+    expect(s.inspect).to eq('#<UnicodeScanner 0/21 @ "Fri D...">')
+    expect(s.scan_until(/12/)).to eq("Fri Dec 12")
+    expect(s.inspect).to eq('#<UnicodeScanner 10/21 "...ec 12" @ " 1975...">')
   end
 
-  it "should pass the #match? example" do
-    s = UnicodeScanner.new('test string')
-    s.match?(/\w+/).should == 4
-    s.match?(/\w+/).should == 4
-    s.match?(/\s+/).should == nil
+  it "passes the #match? example" do
+    s = described_class.new("test string")
+    expect(s.match?(/\w+/)).to eq(4)
+    expect(s.match?(/\w+/)).to eq(4)
+    expect(s.match?(/\s+/)).to be_nil
   end
 
-  it "should pass the #matched example" do
-    s = UnicodeScanner.new('test string')
-    s.match?(/\w+/).should == 4
-    s.matched.should == "test"
+  it "passes the #matched example" do
+    s = described_class.new("test string")
+    expect(s.match?(/\w+/)).to eq(4)
+    expect(s.matched).to eq("test")
   end
 
-  it "should pass the #matched? example" do
-    s = UnicodeScanner.new('test string')
-    s.match?(/\w+/).should == 4
-    s.matched?.should == true
-    s.match?(/\d+/).should == nil
-    s.matched?.should == false
+  it "passes the #matched? example" do
+    s = described_class.new("test string")
+    expect(s.match?(/\w+/)).to eq(4)
+    expect(s.matched?).to be(true)
+    expect(s.match?(/\d+/)).to be_nil
+    expect(s.matched?).to be(false)
   end
 
-  it "should pass the #matched_size example" do
-    s = UnicodeScanner.new('test string')
-    s.check(/\w+/).should == "test"
-    s.matched_size.should == 4
-    s.check(/\d+/).should == nil
-    s.matched_size.should == nil
+  it "passes the #matched_size example" do
+    s = described_class.new("test string")
+    expect(s.check(/\w+/)).to eq("test")
+    expect(s.matched_size).to eq(4)
+    expect(s.check(/\d+/)).to be_nil
+    expect(s.matched_size).to be_nil
   end
 
-  it "should pass the #peek example" do
-    s = UnicodeScanner.new('test string')
-    s.peek(7).should == "test st"
-    s.peek(7).should == "test st"
+  it "passes the #peek example" do
+    s = described_class.new("test string")
+    expect(s.peek(7)).to eq("test st")
+    expect(s.peek(7)).to eq("test st")
   end
 
-  it "should pass the #pos example" do
-    s = UnicodeScanner.new('test string')
-    s.pos.should == 0
-    s.scan_until(/str/).should == "test str"
-    s.pos.should == 8
-    s.terminate.inspect.should == "#<UnicodeScanner fin>"
-    s.pos.should == 11
+  it "passes the #pos example" do
+    s = described_class.new("test string")
+    expect(s.pos).to eq(0)
+    expect(s.scan_until(/str/)).to eq("test str")
+    expect(s.pos).to eq(8)
+    expect(s.terminate.inspect).to eq("#<UnicodeScanner fin>")
+    expect(s.pos).to eq(11)
   end
 
-  it "should pass the #pos= example" do
-    s = UnicodeScanner.new('test string')
-    (s.pos = 7).should == 7
-    s.rest.should == "ring"
+  it "passes the #pos= example" do
+    s = described_class.new("test string")
+    expect(s.pos = 7).to eq(7)
+    expect(s.rest).to eq("ring")
   end
 
-  it "should pass the #post_match/#pre_match example" do
-    s = UnicodeScanner.new('test string')
-    s.scan(/\w+/).should == "test"
-    s.scan(/\s+/).should == " "
-    s.pre_match.should == "test"
-    s.post_match.should == "string"
+  it "passes the #post_match/#pre_match example" do
+    s = described_class.new("test string")
+    expect(s.scan(/\w+/)).to eq("test")
+    expect(s.scan(/\s+/)).to eq(" ")
+    expect(s.pre_match).to eq("test")
+    expect(s.post_match).to eq("string")
   end
 
-  it "should pass the #scan example" do
-    s = UnicodeScanner.new('test string')
-    s.scan(/\w+/).should == "test"
-    s.scan(/\w+/).should == nil
-    s.scan(/\s+/).should == " "
-    s.scan(/\w+/).should == "string"
-    s.scan(/./).should == nil
+  it "passes the #scan example" do
+    s = described_class.new("test string")
+    expect(s.scan(/\w+/)).to eq("test")
+    expect(s.scan(/\w+/)).to be_nil
+    expect(s.scan(/\s+/)).to eq(" ")
+    expect(s.scan(/\w+/)).to eq("string")
+    expect(s.scan(/./)).to be_nil
   end
 
-  it "should pass the #scan_until example" do
-    s = UnicodeScanner.new("Fri Dec 12 1975 14:39")
-    s.scan_until(/1/).should == "Fri Dec 1"
-    s.pre_match.should == "Fri Dec "
-    s.scan_until(/XYZ/).should == nil
+  it "passes the #scan_until example" do
+    s = described_class.new("Fri Dec 12 1975 14:39")
+    expect(s.scan_until(/1/)).to eq("Fri Dec 1")
+    expect(s.pre_match).to eq("Fri Dec ")
+    expect(s.scan_until(/XYZ/)).to be_nil
   end
 
-  it "should pass the #skip example" do
-    s = UnicodeScanner.new('test string')
-    s.skip(/\w+/).should == 4
-    s.skip(/\w+/).should == nil
-    s.skip(/\s+/).should == 1
-    s.skip(/\w+/).should == 6
-    s.skip(/./).should == nil
+  it "passes the #skip example" do
+    s = described_class.new("test string")
+    expect(s.skip(/\w+/)).to eq(4)
+    expect(s.skip(/\w+/)).to be_nil
+    expect(s.skip(/\s+/)).to eq(1)
+    expect(s.skip(/\w+/)).to eq(6)
+    expect(s.skip(/./)).to be_nil
   end
 
-  it "should pass the half-finished #skip_until example" do
-    s = UnicodeScanner.new("Fri Dec 12 1975 14:39")
-    s.skip_until(/12/).should == 10
+  it "passes the half-finished #skip_until example" do
+    s = described_class.new("Fri Dec 12 1975 14:39")
+    expect(s.skip_until(/12/)).to eq(10)
   end
 
-  it "should pass the #unscan example" do
-    s = UnicodeScanner.new('test string')
-    s.scan(/\w+/).should == "test"
+  it "passes the #unscan example" do
+    s = described_class.new("test string")
+    expect(s.scan(/\w+/)).to eq("test")
     s.unscan
-    s.scan(/../).should == "te"
-    s.scan(/\d/).should == nil
-    -> { s.unscan }.should raise_error(ScanError, 'unscan failed: previous match record not exist')
+    expect(s.scan(/../)).to eq("te")
+    expect(s.scan(/\d/)).to be_nil
+    expect { s.unscan }.to raise_error(ScanError, "unscan failed: previous match record not exist")
   end
 end

data/unicode_scanner.gemspec

@@ -3,62 +3,68 @@
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
 
+# stub: unicode_scanner 1.0.1 ruby lib
+
 Gem::Specification.new do |s|
-  s.name = "unicode_scanner"
-  s.version = "1.0.0"
+  s.name = "unicode_scanner".freeze
+  s.version = "1.0.2"
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Tim Morgan"]
-  s.date = "2012-07-12"
-  s.description = "An implementation of StringScanner that doesn't split multibyte characters."
-  s.email = "git@timothymorgan.info"
+  s.required_ruby_version = '>= 2.5'
+  s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib".freeze]
+  s.authors = ["Tim Morgan".freeze]
+  s.description = "An implementation of StringScanner that doesn't split multibyte characters.".freeze
+  s.email = "git@timothymorgan.info".freeze
   s.extra_rdoc_files = [
-    "LICENSE.txt",
-    "README.md"
+      "LICENSE.txt",
+      "README.md"
   ]
   s.files = [
-    ".document",
-    ".rspec",
-    ".rvmrc",
-    "Gemfile",
-    "Gemfile.lock",
-    "LICENSE.txt",
-    "README.md",
-    "Rakefile",
-    "VERSION",
-    "lib/unicode_scanner.rb",
-    "spec/spec_helper.rb",
-    "spec/unicode_scanner_spec.rb",
-    "unicode_scanner.gemspec"
+      ".document",
+      ".rspec",
+      ".ruby-gemset",
+      ".ruby-version",
+      ".travis.yml",
+      "Gemfile",
+      "Gemfile.lock",
+      "LICENSE.txt",
+      "README.md",
+      "Rakefile",
+      "VERSION",
+      "lib/unicode_scanner.rb",
+      "spec/spec_helper.rb",
+      "spec/unicode_scanner_spec.rb",
+      "unicode_scanner.gemspec"
   ]
-  s.homepage = "http://github.com/RISCfuture/unicode_scanner"
-  s.licenses = ["MIT"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.24"
-  s.summary = "Unicode-aware implementation of StringScanner"
+  s.homepage = "http://github.com/RISCfuture/unicode_scanner".freeze
+  s.licenses = ["MIT".freeze]
+  s.rubygems_version = "3.1.2".freeze
+  s.summary = "[DEPRECATED] Unicode-aware implementation of StringScanner".freeze
+  s.post_install_message = <<~MSG
+
+    ⚠️  DEPRECATED: unicode_scanner is no longer actively maintained.
+
+    Stable. Modern Ruby (3.x+) has improved Unicode-aware StringScanner behavior; consider the standard library `StringScanner` for new code.
+
+    This is the final release. No further updates are planned.
 
-  if s.respond_to? :specification_version then
-    s.specification_version = 3
+  MSG
 
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<rspec>, [">= 0"])
-      s.add_development_dependency(%q<redcarpet>, [">= 0"])
-      s.add_development_dependency(%q<yard>, [">= 0"])
-      s.add_development_dependency(%q<bundler>, [">= 0"])
-      s.add_development_dependency(%q<jeweler>, [">= 0"])
-    else
-      s.add_dependency(%q<rspec>, [">= 0"])
-      s.add_dependency(%q<redcarpet>, [">= 0"])
-      s.add_dependency(%q<yard>, [">= 0"])
-      s.add_dependency(%q<bundler>, [">= 0"])
-      s.add_dependency(%q<jeweler>, [">= 0"])
-    end
+  if s.respond_to? :specification_version
+    s.specification_version = 4
+  end
+
+  if s.respond_to? :add_runtime_dependency
+    s.add_development_dependency('rspec'.freeze, [">= 0"])
+    s.add_development_dependency('redcarpet'.freeze, [">= 0"])
+    s.add_development_dependency('yard'.freeze, [">= 0"])
+    s.add_development_dependency('bundler'.freeze, [">= 0"])
+    s.add_development_dependency('jeweler'.freeze, [">= 0"])
   else
-    s.add_dependency(%q<rspec>, [">= 0"])
-    s.add_dependency(%q<redcarpet>, [">= 0"])
-    s.add_dependency(%q<yard>, [">= 0"])
-    s.add_dependency(%q<bundler>, [">= 0"])
-    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency('rspec'.freeze, [">= 0"])
+    s.add_dependency('redcarpet'.freeze, [">= 0"])
+    s.add_dependency('yard'.freeze, [">= 0"])
+    s.add_dependency('bundler'.freeze, [">= 0"])
+    s.add_dependency('jeweler'.freeze, [">= 0"])
   end
 end
-

metadata

@@ -1,94 +1,82 @@
 --- !ruby/object:Gem::Specification
 name: unicode_scanner
 version: !ruby/object:Gem::Version
-  version: 1.0.0
-  prerelease: 
+  version: 1.0.2
 platform: ruby
 authors:
 - Tim Morgan
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-12 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: jeweler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: An implementation of StringScanner that doesn't split multibyte characters.
@@ -99,9 +87,11 @@ extra_rdoc_files:
 - LICENSE.txt
 - README.md
 files:
-- .document
-- .rspec
-- .rvmrc
+- ".document"
+- ".rspec"
+- ".ruby-gemset"
+- ".ruby-version"
+- ".travis.yml"
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -115,29 +105,31 @@ files:
 homepage: http://github.com/RISCfuture/unicode_scanner
 licenses:
 - MIT
-post_install_message: 
+metadata: {}
+post_install_message: |2+
+
+  ⚠️  DEPRECATED: unicode_scanner is no longer actively maintained.
+
+  Stable. Modern Ruby (3.x+) has improved Unicode-aware StringScanner behavior; consider the standard library `StringScanner` for new code.
+
+  This is the final release. No further updates are planned.
+
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
-      segments:
-      - 0
-      hash: -3935821298050612576
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.8.24
-signing_key: 
-specification_version: 3
-summary: Unicode-aware implementation of StringScanner
+rubygems_version: 4.0.11
+specification_version: 4
+summary: "[DEPRECATED] Unicode-aware implementation of StringScanner"
 test_files: []
+...

data/.rvmrc

@@ -1 +0,0 @@
-rvm 1.9.3@scanner --create