plain_text 0.7 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21f798fe1e22424b48114466382f56a8c27a065ee63d6e9c68c98f5c7e505f14
-  data.tar.gz: 0dde006503a336e1e96960dedd7e04c09ea88723495df93ca11bfa177d0f390e
+  metadata.gz: 45fae90fbac6ba53a5f7c21d6a21b3f858d3db734d770eec82fdbb9838755b11
+  data.tar.gz: 2817d7be2e4e7a3029d00922177c881ae4cdad2c940bb764f8f49cd6c1b08e00
 SHA512:
-  metadata.gz: 30a1f8819371a6b2204df7e47b671c95b227fe14d8b134373c3d0768e35e89bd0c3386707cebbc499aab026631aa0b6fb3838112f198a46ae35328e19ab66eec
-  data.tar.gz: baca6464f9e66e01154fe72c7fee869ae8218f4a65f46679b2d9f934780eeef0f893f7d01c3a417a9beb007c390ce0b6c7f3aa40b9c49130ca4dcc5a40c2ba4e
+  metadata.gz: 5443ef391054d08a06f3cef5a67316b0f13ddbf2f60f7689eb51f027aa73804e09418d0e021446cc32f90111047f36a862278a62b92017000055658756fb4759
+  data.tar.gz: 0b158d573ba75b957a0c063aace1bad6c378a23e3e8cd97afe2af6cbd71e79bf26cdd32cce748c0fefd24f61cd6d9053380178889c3c30673219d1bcb13b8809

data/ChangeLog

@@ -1,3 +1,8 @@
+-----
+(Version: 0.7.1)
+2022-09-09  Masa Sakano
+  * Skips some tests that break in Ruby 3.
+
 -----
 (Version: 0.7)
 2022-08-25  Masa Sakano

data/lib/plain_text.rb

@@ -139,7 +139,7 @@ module PlainText
   # @param delete_asian_space [Boolean] Any spaces between, before, after Asian characters (but punctuation) are deleted, if true (Default).
   # @param linehead_style [Symbol] One of +(:truncate|:delete|:none)+ (Def: :none). Determine how to handle consecutive white spaces at the beggining of each line.
   # @param linetail_style [Symbol] One of +(:truncate|:delete|:markdown|:none)+ (Def: :delete). Determine how to handle consecutive white spaces at the end of each line.  If +:markdown, 1 space is always deleted, and two or more spaces are truncated into two ASCII whitespaces *if* the last two spaces are ASCII whitespaces, or else untouched.
-  # @param firstlbs_style [Symbol, String] One of +(:truncate|:delete|:none)+ or String (Def: :default). If +:truncate+, any linebreaks at the very beginning of self (and whitespaces in between), if exist, are truncated to a single linebreak.  If String, they are, even if not exists, replaced with the specified String (such as a linebreak).  If +:delete+, they are deleted.  Note This option has nothing to do with the whitespaces at the beginning of the first significant line (hence the name of the option).  Note if a (random) Part is given, this option only considers the first significant element of it.
+  # @param firstlbs_style [Symbol, String] One of +(:truncate|:delete|:none)+ or String (Def: :delete). If +:truncate+, any linebreaks at the very beginning of self (and whitespaces in between), if exist, are truncated to a single linebreak.  If String, they are, even if not exists, replaced with the specified String (such as a linebreak).  If +:delete+, they are deleted.  Note This option has nothing to do with the whitespaces at the beginning of the first significant line (hence the name of the option).  Note if a (random) Part is given, this option only considers the first significant element of it.
   # @param lastsps_style [Symbol, String] One of +(:truncate|:delete|:none|:linebreak)+ or String (Def: :truncate). If +:truncate+, any of linebreaks *AND* white spaces at the tail of self, if exist, are truncated to a single linebreak.  If +:delete+, they are deleted.  If String, they are, even if not exists, replaced with the specified String (such as a linebreak, in which case +lb_out+ is used as String, i.e., it guarantees only 1 linebreak to exist at the end of the String).  Note if a (random) Part is given, this option only considers the last significant element of it.
   # @param lb [String] Linebreak character like +\n+ etc (Default: $/). If this is one of the standard line-breaks, irregular line-breaks (for example, existence of CR when only LF should be there) are corrected.
   # @param lb_out [String] Linebreak used for output (Default: +lb+)

data/plain_text.gemspec

@@ -5,7 +5,7 @@ require 'date'
 
 Gem::Specification.new do |s|
   s.name = %q{plain_text}.sub(/.*/){|c| (c == File.basename(Dir.pwd)) ? c : raise("ERROR: s.name=(#{c}) in gemspec seems wrong!")}
-  s.version = "0.7".sub(/.*/){|c| fs = Dir.glob('changelog{,.*}', File::FNM_CASEFOLD); raise('More than one ChangeLog exist!') if fs.size > 1; warn("WARNING: Version(s.version=#{c}) already exists in #{fs[0]} - ok?") if fs.size == 1 && !IO.readlines(fs[0]).grep(/^\(Version: #{Regexp.quote c}\)$/).empty? ; c }  # n.b., In macOS, changelog and ChangeLog are identical in default.
+  s.version = "0.7.1".sub(/.*/){|c| fs = Dir.glob('changelog{,.*}', File::FNM_CASEFOLD); raise('More than one ChangeLog exist!') if fs.size > 1; warn("WARNING: Version(s.version=#{c}) already exists in #{fs[0]} - ok?") if fs.size == 1 && !IO.readlines(fs[0]).grep(/^\(Version: #{Regexp.quote c}\)$/).empty? ; c }  # n.b., In macOS, changelog and ChangeLog are identical in default.
   # s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.bindir = 'bin'
   %w(countchar textclean head.rb tail.rb yard2md_afterclean).each do |f|
@@ -13,7 +13,7 @@ Gem::Specification.new do |s|
     File.executable?(path) ? s.executables << f : raise("ERROR: Executable (#{path}) is not executable!")
   end
   s.authors = ["Masa Sakano"]
-  s.date = %q{2022-08-25}.sub(/.*/){|c| (Date.parse(c) == Date.today) ? c : raise("ERROR: s.date=(#{c}) is not today!")}
+  s.date = %q{2022-09-09}.sub(/.*/){|c| (Date.parse(c) == Date.today) ? c : raise("ERROR: s.date=(#{c}) is not today!")}
   s.summary = %q{Module to handle Plain-Text}
   s.description = %q{This module provides utility functions and methods to handle plain text, classes Part/Paragraph/Boundary to represent the logical structure of a document and ParseRule to describe the rules to parse plain text to produce a Part-type Ruby instance. A few handy Ruby executable scripts to make use of them are included.}
   # s.email = %q{abc@example.com}
@@ -41,7 +41,7 @@ Gem::Specification.new do |s|
   s.rdoc_options = ["--charset=UTF-8"]
 
   # s.require_paths = ["lib"]	# Default "lib"
-  s.required_ruby_version = '>= 2.0'
+  s.required_ruby_version = '>= 2.0', '< 3.2'
   s.test_files = Dir['test/**/*.rb']
   s.test_files.reject! { |fn| File.symlink? fn }
   # s.requirements << 'libmagick, v6.0' # Simply, info to users.

data/test/test_plain_text.rb

@@ -301,12 +301,22 @@ class TestUnitPlainText < MiniTest::Test
     assert_equal "", PT.tail_inverse("", 3)
 
     # Child class of String
+    # NOTE: In Ruby 3, a subclass of String is not respected in the methods of String:
+    #  @see https://rubyreferences.github.io/rubychanges/3.0.html#string-always-returning-string
+    # NOTE: In Ruby 3, "".class.name is frozen?==true
     chs = ChString.new ""
-    nam = chs.class.name
+    require 'rubygems' if !defined? Gem  # for Ruby 1
+    is_ver_2 = (Gem::Version.new(RUBY_VERSION) < Gem::Version.new('3'))
+    nam = (is_ver_2 ? chs.class : String).name
+
     assert_equal "", chs
     assert_equal chs, PT.tail(chs)
     assert_equal nam, PT.tail(chs).class.name, nam+" <=> \n"+PT.tail(chs).class.name.inspect
-    assert_equal nam, PT.tail(chs.class.name)
+    if is_ver_2
+      assert_equal nam, PT.tail(chs.class.name)
+    else
+      assert_raises(FrozenError){ PT.tail(chs.class.name) }
+    end
     assert_equal nam, PT.tail(chs, -100).class.name
   end
 

data/test/test_plain_text_part.rb

@@ -18,6 +18,12 @@ gem "minitest"
 require 'minitest/autorun'
 # MiniTest::Unit.autorun
 
+# NOTE: In Ruby 3, a subclass of Array is not respected in the methods of Array:
+#  @see https://rubyreferences.github.io/rubychanges/3.0.html#array-always-returning-array
+# NOTE: In Ruby 3, "".class.name is frozen?==true
+require 'rubygems' if !defined? Gem  # for Ruby 1
+IS_VER_2 = (Gem::Version.new(RUBY_VERSION) < Gem::Version.new('3'))
+
 class TestUnitPlainTextPart < MiniTest::Test
   T = true
   F = false
@@ -143,7 +149,7 @@ class TestUnitPlainTextPart < MiniTest::Test
     assert_equal a1+["d", ""], pt3.to_a
     assert_equal pt1.class,    pt3.class
     assert_equal Pt.new(a3),   pt3    # Boundary("") is appended.
-    assert_equal Pt::Boundary, pt3.to_a[-1].class
+    assert_equal Pt::Boundary, pt3.to_a[-1].class  if IS_VER_2  # Not in Ruby 3 (see note at the top)
     assert_equal pt3, pt1 + ["d", ""]
 
     assert_equal a3.class, ([]+pt3).class  # The latter, too, is an Array (NOT PlainText::Part)
@@ -154,6 +160,9 @@ class TestUnitPlainTextPart < MiniTest::Test
   end
 
   # Tests of [prm], [prm1, prm2], [prm1..prm2] and "equal" operator
+  # NOTE: In Ruby 3, a subclass of Array is not respected in the methods of Array:
+  #  @see https://rubyreferences.github.io/rubychanges/3.0.html#array-always-returning-array
+  # NOTE: In Ruby 3, "".class.name is frozen?==true
   def test_bracket01
     a1  = ["a", "\n\n\n", "b", "\n\n\n", "c", "\n\n"]
     pt1 = Pt.new(a1)
@@ -167,17 +176,18 @@ class TestUnitPlainTextPart < MiniTest::Test
     assert_nil   pt1[-99]
     assert_nil   pt1[98]
 
-    assert_equal pt1.class, pt1[0, 6].class
+    assert_equal pt1.class, pt1[0, 6].class  if IS_VER_2  # Not in Ruby 3 (see note at the top)
     assert_equal a1,        pt1[0, 6].to_a
     assert_equal a1[0, 6],  pt1[0, 6].to_a
-    assert_operator pt1[0, 6], :!=, a1
-    assert_operator a1,        :!=, pt1[0, 6]
+    oper = (IS_VER_2 ? :!= : :==)  # Because PlainText::Part#== is redefined and pt1 is Part in Ruby 2, the following is unequal, whereas pt1 is Array in Ruby 3!
+    assert_operator pt1[0, 6], oper, a1
+    assert_operator a1,        oper, pt1[0, 6]
 
     assert_equal a1[0, 2],  pt1[0, 2].to_a
     assert_equal a1,        pt1[0, 98].to_a
     assert_equal a1[0, 99], pt1[0, 98].to_a
 
-    assert_equal pt1.class, pt1[0..1].class
+    assert_equal pt1.class, pt1[0..1].class  if IS_VER_2  # Not in Ruby 3 (see note at the top)
     assert_equal a1[0..1],  pt1[0..1].to_a
     assert_equal a1[0, 2],  pt1[0..1].to_a
     assert_equal a1[0..5],  pt1[0..5].to_a
@@ -192,12 +202,14 @@ class TestUnitPlainTextPart < MiniTest::Test
 
     assert_equal pt1[0..-1], pt1[0..99]
     assert_equal pt1[0, 6],  pt1[0..-1]
-    assert_equal pt1,        pt1[0..99]
+    assert_equal pt1,        pt1[0..99]  if IS_VER_2  # Not in Ruby 3 (see note at the top)
 
-    pt2 = pt1[0, 4]
-    assert_equal pt1.class,            pt2.class
-    assert_equal pt1.paras[0, 2],      pt2.paras
-    assert_equal pt1.boundaries[0, 2], pt2.boundaries
+    if IS_VER_2  # Not in Ruby 3 (see note at the top)
+      pt2 = pt1[0, 4]
+      assert_equal pt1.class,            pt2.class
+      assert_equal pt1.paras[0, 2],      pt2.paras
+      assert_equal pt1.boundaries[0, 2], pt2.boundaries
+    end
 
     # negative or too-big out-of-bound begin
     assert_nil   a1[-99..2]
@@ -206,7 +218,7 @@ class TestUnitPlainTextPart < MiniTest::Test
     assert_nil   pt1[98..99]
 
     # other out-of-bounds: Empty
-    assert_equal Pt.new([]),  pt1[2..1]
+    assert_equal Pt.new([]),  pt1[2..1]  if IS_VER_2  # Not in Ruby 3 (see note at the top)
     assert_equal a1[-2..2],   pt1[-2..2].to_a
     assert_equal a1[-2...3],  pt1[-2...3].to_a
 
@@ -223,10 +235,12 @@ class TestUnitPlainTextPart < MiniTest::Test
     assert_nil   pt1[pt1.size]
     assert_nil   pt1[pt1.size, -2]
     assert_raises(TypeError){ pt1[pt1.size, ?a] }
-    assert_equal Pt.new([]), pt1[pt1.size, 2]
-    assert_equal Pt.new([]), pt1[pt1.size, 98]
-    assert_equal Pt.new([]), pt1[pt1.size..99]
-    assert_equal Pt.new([]), pt1[pt1.size..1]
+    if IS_VER_2  # Not in Ruby 3 (see note at the top)
+      assert_equal Pt.new([]), pt1[pt1.size, 2]
+      assert_equal Pt.new([]), pt1[pt1.size, 98]
+      assert_equal Pt.new([]), pt1[pt1.size..99]
+      assert_equal Pt.new([]), pt1[pt1.size..1]
+    end
   end
 
   # Tests of slice! to delete
@@ -247,12 +261,12 @@ class TestUnitPlainTextPart < MiniTest::Test
 
     assert_equal a11[4, 2],  a1.slice!(4, 2)
     ptp =                   pt1.slice!(4, 2)
-    assert_equal    pt1.class, ptp.class  # PlainText::Part
+    assert_equal    pt1.class, ptp.class  if IS_VER_2  # Not in Ruby 3 (see note at the top)  # PlainText::Part
     assert_equal    a11[4, 2], ptp.to_a
-    assert_operator a11[4, 2], :!=, ptp   # PlainText::Part != Array
+    assert_operator a11[4, 2], :!=, ptp  if IS_VER_2   # PlainText::Part != Array
     assert_equal a11[0..3],  a1
     assert_equal a11[0..3], pt1.to_a
-    assert_equal pt2[0..3], pt1
+    assert_equal pt2[0..3], pt1  if IS_VER_2  # Not in Ruby 3 (see note at the top)
 
     # Negative size (Index, Size)
     a1  = a11.clone
@@ -268,9 +282,9 @@ class TestUnitPlainTextPart < MiniTest::Test
     pt1 = Pt.new(a11.clone)
     assert_equal a11[4, 6],  a1.slice!(4, 6)
     ptp =                   pt1.slice!(4, 6)
-    assert_equal    pt1.class, ptp.class  # PlainText::Part
+    assert_equal    pt1.class, ptp.class  if IS_VER_2  # Not in Ruby 3 (see note at the top)  # PlainText::Part
     assert_equal    a11[4, 2], ptp.to_a
-    assert_operator a11[4, 2], :!=, ptp   # PlainText::Part != Array
+    assert_operator a11[4, 2], :!=, ptp  if IS_VER_2  # Not in Ruby 3 (see note at the top)   # PlainText::Part != Array
     assert_equal a11[0..3],  a1
 
     # Range exceeding (Range)
@@ -278,10 +292,10 @@ class TestUnitPlainTextPart < MiniTest::Test
     pt1 = Pt.new(a11.clone)
     assert_equal a11[4..9],  a1.slice!(4..9)
     ptp =                   pt1.slice!(4..9)
-    assert_equal    pt1.class, ptp.class  # PlainText::Part
+    assert_equal    pt1.class, ptp.class  if IS_VER_2  # Not in Ruby 3 (see note at the top)  # PlainText::Part
     assert_equal    a11[4..-1],ptp.to_a
     assert_equal    a11[4..9], ptp.to_a
-    assert_operator a11[4..9], :!=, ptp   # PlainText::Part != Array
+    assert_operator a11[4..9], :!=, ptp  if IS_VER_2  # Not in Ruby 3 (see note at the top)   # PlainText::Part != Array
     assert_equal a11[0..3],  a1
     assert_equal a11[0..3], pt1.to_a
 
@@ -301,9 +315,9 @@ class TestUnitPlainTextPart < MiniTest::Test
     pt1 = Pt.new(a11.clone)
     assert_equal a11[-6, 2],  a1.slice!(-6, 2)
     ptp =                    pt1.slice!(-6, 2)
-    assert_equal    pt1.class, ptp.class  # PlainText::Part
+    assert_equal    pt1.class, ptp.class  if IS_VER_2  # Not in Ruby 3 (see note at the top)  # PlainText::Part
     assert_equal    a11[0..1], ptp.to_a
-    assert_operator a11[0..1], :!=, ptp   # PlainText::Part != Array
+    assert_operator a11[0..1], :!=, ptp  if IS_VER_2  # Not in Ruby 3 (see note at the top)   # PlainText::Part != Array
     assert_equal a11[2..-1],  a1
     assert_equal a11[2..-1], pt1.to_a
 
@@ -312,9 +326,9 @@ class TestUnitPlainTextPart < MiniTest::Test
     pt1 = Pt.new(a11.clone)
     assert_equal a11[-6..-5],  a1.slice!(-6..-5)
     ptp =                     pt1.slice!(-6..-5)
-    assert_equal    pt1.class, ptp.class  # PlainText::Part
+    assert_equal    pt1.class, ptp.class  if IS_VER_2  # Not in Ruby 3 (see note at the top)  # PlainText::Part
     assert_equal    a11[0..1], ptp.to_a
-    assert_operator a11[0..1], :!=, ptp   # PlainText::Part != Array
+    assert_operator a11[0..1], :!=, ptp  if IS_VER_2  # Not in Ruby 3 (see note at the top)   # PlainText::Part != Array
     assert_equal a11[2..-1],  a1
     assert_equal a11[2..-1], pt1.to_a
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: plain_text
 version: !ruby/object:Gem::Version
-  version: '0.7'
+  version: 0.7.1
 platform: ruby
 authors:
 - Masa Sakano
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-25 00:00:00.000000000 Z
+date: 2022-09-09 00:00:00.000000000 Z
 dependencies: []
 description: This module provides utility functions and methods to handle plain text,
   classes Part/Paragraph/Boundary to represent the logical structure of a document
@@ -69,6 +69,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ">="
     - !ruby/object:Gem::Version
       version: '2.0'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="