rangeary 1.0.1 → 2.0

data/rangeary.gemspec

@@ -0,0 +1,51 @@
+# -*- encoding: utf-8 -*-
+
+require 'rake'
+require 'date'
+
+Gem::Specification.new do |s|
+  s.name = %q{rangeary}.sub(/.*/){|c| (c == File.basename(Dir.pwd)) ? c : raise("ERROR: s.name=(#{c}) in gemspec seems wrong!")}
+  s.version = "2.0"
+  # s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  # s.executables << 'hola'
+  # s.bindir = 'bin'
+  s.authors = ["Masa Sakano"]
+  s.date = %q{2022-09-08}.sub(/.*/){|c| (Date.parse(c) == Date.today) ? c : raise("ERROR: s.date=(#{c}) is not today!")}
+  s.summary = %q{Rangeary - class to represent any 1-dimensional multiple-range}
+  s.description = %q{Rangeary is a sub-class of Array and represents any 1-dimensional multiple-range, for example, (x<4 and 7<x<=9) or (x<="c" and "f"<=x), where the infinities can be abstract like nil or be defined by the user. All the standard logical operations, including negation, conjunction and disjunction, are supported and can be used with conventional Ruby-style operators.  Each range is represented as RangeExtd class (Extended Range), which is a sub-class of Range and supports exclude-begin and open-ended (to Infinity) ranges, and is downloadable from https://rubygems.org/gems/range_extd}
+  # s.email = %q{abc@example.com}
+  s.extra_rdoc_files = [
+    # "LICENSE",
+     #"README.en.rdoc",
+     "README.ja.rdoc",
+  ]
+  s.license = 'MIT'
+  s.files = FileList['.gitignore','lib/**/*.rb','[A-Z]*', 'test/**/*.rb'].to_a.delete_if{ |f|
+    ret = false
+    arignore = IO.readlines('.gitignore')
+    arignore.map{|i| i.chomp}.each do |suffix|
+      if File.fnmatch(suffix, File.basename(f))
+        ret = true
+        break
+      end
+    end
+    ret
+  }
+  s.files.reject! { |fn| File.symlink? fn }
+
+  s.add_runtime_dependency 'range_extd', '~> 2'	# Range#equiv? introduced in 0.4.0; beginless Range introduced in 2.0
+  # s.add_runtime_dependency 'library', '~> 2.2', '>= 2.2.1'	# 2.2.1 <= Ver < 2.3.0
+  # s.add_development_dependency "bourne", [">= 0"]
+  s.homepage = %q{https://www.wisebabel.com}
+  s.rdoc_options = ["--charset=UTF-8"]
+
+  # s.require_paths = ["lib"]
+  s.required_ruby_version = '>= 2.7'  # required >= 2.6 for testing.
+  s.test_files = Dir['test/**/*.rb']
+  s.test_files.reject! { |fn| File.symlink? fn }
+  # s.requirements << 'libmagick, v6.0'	# Simply, info to users.
+  # s.rubygems_version = %q{1.3.5}	# This is always set automatically!!
+
+  s.metadata["yard.run"] = "yri" # use "yard" to build full HTML docs.
+end
+

data/test/tee_io.rb

@@ -0,0 +1,111 @@
+
+# Taken from <https://gist.github.com/masasakano/789030a7dc5313bd343b2de967a93200>
+
+require "tempfile"
+
+# TeeIO to "tee" (or splice) an IO
+#
+# Basically this overwrites IO#write .
+#
+# Note this does not capture IO#syswrite
+#
+# The main part but {TeeIO.suppress_io} is taken from
+# {https://stackoverflow.com/a/9439298/3577922}
+#
+# Main use of this class is {TeeIO.suppress_io}
+#
+# @author Masa Sakano
+#
+class TeeIO < IO
+  def initialize io_orig, io_file
+    @orig = io_orig
+    @file = io_file
+  end
+  def write string
+    @file.write string
+    @orig.write string
+  end
+
+  # IO outputs are suppressed in the given block with a copy/alternative provided.
+  #
+  # If +ENV['DISPLAY_STDERR']+ (or the name provided) is set,
+  # the original is output as normal, while it is redirected to IO, too.
+  #
+  # This is especially designed for testing framework.  In testing,
+  # you may deliberately test lots of situations where messages
+  # are printed to the terminal.  You may want to suppress them,
+  # providing the messages are what you expect.  But it is laborious
+  # to write test code to check all the messages, and so you may just
+  # want to suppress all.  However, from time to time you may want to
+  # switch to see the messages to make sure nothing unexpected is happening.
+  #
+  # This method provides the flexibility. You can suppress the message,
+  # while you can still access them if you want, and you can switch off
+  # suppressing by providing an environmental variable.
+  #
+  # @note For the given IO, IO#sync=true should be set beforehand.
+  #
+  # @example suppressing STDOUT
+  #   puts "1: This is displayed."
+  #   suppress_io($stdout, envanme: "DISPLAY_STDOUT"){ |iorw|
+  #     puts "2: This is suppressed."
+  #     iorw.rewind
+  #     $stderr.print "3: Message read from IO: "
+  #     $stderr.puts iorw.read  # => "2: This is suppressed."
+  #   }
+  #   puts "4: This is displayed."
+  #
+  # @see https://gist.github.com/moertel/11091573
+  #
+  # @param ioin [IO] IO to suppress
+  # @param envname [String] Name of the Environmental variable
+  # @yield [IO] the given IO is redirected (or copied)
+  def self.suppress_io(ioin=$stderr, envname: 'DISPLAY_STDERR')
+    display_stderr = (ENV[envname] && !ENV[envname].empty? && ENV[envname] != "0")
+    iorw = Tempfile.new(File.basename(__FILE__))
+    iorw.sync = true
+    original_stderr = $stderr.clone
+  
+    tee = TeeIO.new $stderr, iorw
+    if display_stderr
+      $stderr = tee
+    else
+      #$stderr.reopen File.new('/dev/null', 'w')
+      $stderr.reopen iorw
+    end
+    yield(iorw)
+  ensure
+    if display_stderr
+      $stderr = original_stderr
+    else
+      $stderr.reopen original_stderr
+    end
+    iorw.close if iorw
+  end
+end
+
+
+############### Demonstrations ###############
+
+if $0 == __FILE__
+  $stdout.sync = true
+  $stderr.sync = true  # recommended!
+  $stderr.puts "1: Before suppression."
+  TeeIO.suppress_io{ |iorw|
+    $stderr.puts "2: This is suppressed."
+    print "3: Message read from IO: "
+    iorw.rewind
+    puts iorw.read
+  }
+  $stderr.puts "4: After first suppression."
+
+  ENV['DISPLAY_STDERR'] = "1"
+  TeeIO.suppress_io{ |iorw|
+    $stderr.puts "5: This is not suppressed."
+    print "6: Message read from IO: "
+    iorw.rewind
+    puts iorw.read
+  }
+  $stderr.puts "7: After second suppression."
+  $stderr.puts "Messages 1-7 except 2 should be printed (the order may vary)."
+end