y_support 2.1.18 → 2.4.4

data/test/typing_test.rb

@@ -103,7 +103,7 @@ describe "y_support/typing" do
       assert_equal( {}, {}.aT_blank )
     end
     
-    it "should have #aT_present enforcer" do
+    it "should have #aT_present validator" do
       -> { nil.aT_present }.must_raise TypeError
       assert 0.aT_present
       assert_equal( "hello", "hello".aT_present )
@@ -116,29 +116,29 @@ describe "y_support/typing" do
       assert [1, 2, 4].aT_all { |e| e < 5 }
     end
 
-    it "should have #aT_all_kind_of enforcer" do
+    it "should have #aT_all_kind_of validator" do
       -> { [1.0, 2.0, :a].aT_all_kind_of Numeric }.must_raise TypeError
       assert [1.0, 2.0, 3].aT_all_kind_of Numeric
     end
 
-    it "should have #aT_all_comply class compliance enforcer" do
+    it "should have #aT_all_comply class compliance validator" do
       -> { [1.0, 2.0, :a].aT_all_comply Numeric }.must_raise TypeError
       assert [1.0, 2.0, 3].aT_all_comply Numeric
     end
 
-    it "should have #aT_all_numeric enforcer" do
+    it "should have #aT_all_numeric validator" do
       -> { [:a].aT_all_numeric }.must_raise TypeError
       assert [1, 2.0].aT_all_numeric
     end
     
-    it "should have #aT_subset_of enforcer" do
+    it "should have #aT_subset_of validator" do
       -> { [6].aT_subset_of [*0..5] }.must_raise TypeError
       assert [1,2].aT_subset_of [*0..5]
     end
   end # describe "Enumerable"
 
   describe "Array" do
-    it "should have #aT_includes (alias #aT_include) enforcer" do
+    it "should have #aT_includes (alias #aT_include) validator" do
       -> { [1, 2, 4].aT_include 3 }.must_raise TypeError
       assert [1, 2, 4].aT_include( 4 )
       assert_equal [6, 7], [6, 7].aT_include( 6 )
@@ -185,7 +185,7 @@ describe "y_support/typing" do
       assert_equal( { a: 'a', c: 'b', k: 'k' }, a )
     end
     
-    it "should have #aT_has synonymizing enforcer" do
+    it "should have #aT_has synonymizing validator" do
       a = { infile: 'a', csv_out_file: 'b', k: 'k', o: 'k', t: 'k' }
       assert_respond_to a, :aT_has
       old = a.dup

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: y_support
 version: !ruby/object:Gem::Version
-  version: 2.1.18
+  version: 2.4.4
 platform: ruby
 authors:
 - boris
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-09 00:00:00.000000000 Z
+date: 2016-06-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -80,7 +80,6 @@ files:
 - README.md
 - Rakefile
 - lib/y_support.rb
-- lib/y_support/abstract_algebra.rb
 - lib/y_support/all.rb
 - lib/y_support/core_ext.rb
 - lib/y_support/core_ext/array.rb
@@ -102,21 +101,25 @@ files:
 - lib/y_support/core_ext/string/misc.rb
 - lib/y_support/core_ext/symbol.rb
 - lib/y_support/core_ext/symbol/misc.rb
+- lib/y_support/flex_coerce.rb
+- lib/y_support/flex_coerce/class_methods.rb
+- lib/y_support/flex_coerce/flex_proxy.rb
+- lib/y_support/flex_coerce/module_methods.rb
 - lib/y_support/inert_recorder.rb
 - lib/y_support/kde.rb
+- lib/y_support/literate.rb
 - lib/y_support/local_object.rb
 - lib/y_support/misc.rb
 - lib/y_support/name_magic.rb
-- lib/y_support/name_magic/array.rb
+- lib/y_support/name_magic/array_methods.rb
 - lib/y_support/name_magic/class_methods.rb
-- lib/y_support/name_magic/hash.rb
-- lib/y_support/name_magic/namespace_methods.rb
+- lib/y_support/name_magic/hash_methods.rb
+- lib/y_support/name_magic/namespace.rb
 - lib/y_support/null_object.rb
 - lib/y_support/respond_to.rb
 - lib/y_support/stdlib_ext.rb
 - lib/y_support/stdlib_ext/matrix.rb
 - lib/y_support/stdlib_ext/matrix/misc.rb
-- lib/y_support/try.rb
 - lib/y_support/typing.rb
 - lib/y_support/typing/array.rb
 - lib/y_support/typing/array/typing.rb
@@ -131,17 +134,16 @@ files:
 - lib/y_support/unicode.rb
 - lib/y_support/version.rb
 - lib/y_support/x.rb
-- test/abstract_algebra_test.rb
+- test/flex_coerce_test.rb
 - test/inert_recorder_test.rb
 - test/kde_test.rb
+- test/literate_test.rb
 - test/local_object_test.rb
 - test/misc_test.rb
 - test/misc_test/test_module/fixture_class.rb
 - test/name_magic_test.rb
 - test/null_object_test.rb
-- test/performance_test_example.rb
 - test/respond_to_test.rb
-- test/try_test.rb
 - test/typing_test.rb
 - test/unicode_test.rb
 - test/x_test.rb
@@ -171,17 +173,16 @@ signing_key:
 specification_version: 4
 summary: Support library used by Y gems.
 test_files:
-- test/abstract_algebra_test.rb
+- test/flex_coerce_test.rb
 - test/inert_recorder_test.rb
 - test/kde_test.rb
+- test/literate_test.rb
 - test/local_object_test.rb
 - test/misc_test.rb
 - test/misc_test/test_module/fixture_class.rb
 - test/name_magic_test.rb
 - test/null_object_test.rb
-- test/performance_test_example.rb
 - test/respond_to_test.rb
-- test/try_test.rb
 - test/typing_test.rb
 - test/unicode_test.rb
 - test/x_test.rb

data/lib/y_support/abstract_algebra.rb

@@ -1,234 +0,0 @@
-#encoding: utf-8
-
-require 'y_support'
-require 'y_support/null_object'
-
-# Rudiments of abstract algebra in Ruby.
-#
-# Some objects (users, mixins...) might ask from other classes to have things
-# defined such as operators #+, #*, or to have a specific instance that behaves
-# additive identity element (ie. zero), or multiplicative identity element (ie.
-# one). The essence of some of these requirements is captured by the abstract
-# algebraic notions of magma, monoid, ring, field...
-#
-# At the moment being, y_support/abstract_algebra does not aim as high as to
-# comprehensively support monoids, rings, fields and the plethora of abstract
-# algebraic stuff. Support is provided to such degree, as to make some practical
-# problems tractable. (Our original concern was with Matrix instances filled
-# with non-numeric objects, whose #+ operator was not coercible to work with
-# numerics.)
-# 
-
-# Adds abstract algebra concepts to Ruby.
-#
-module Algebra
-  # A Monoid requires:
-  #
-  # Closed and associative addition: #add method
-  # Additive identity element: #additive_identity
-  # 
-  module Monoid
-    def self.included receiver
-      receiver.extend self::ClassMethods
-    end
-
-    def + summand; add summand end
-
-    module ClassMethods
-      def zero; additive_identity end
-    end
-  end
-
-  # A group is a monoid with additive inverse.
-  #
-  # additive inversion: #additive_inverse
-  # 
-  module Group
-    include Monoid
-    def -@; additive_inverse end
-    def - subtrahend; add subtrahend.additive_inverse end
-  end
-
-  # A group that fulfills the condition of commutativity
-  #
-  # ( a.add b == b.add a ).
-  # 
-  module AbelianGroup
-    include Group
-  end
-
-  # A ring is a commutative group with multiplication.
-  # 
-  # multiplication: #multiply (associative, distributive)
-  # multiplicative identity element: #multiplicative_identity
-  # 
-  module Ring
-    include AbelianGroup
-    def * multiplicand; multiply multiplicand end
-    def one; multiplicative_identity end
-  end
-
-  # A field is a ring that can do division.
-  # 
-  module Field
-    include Ring
-    def inverse; multiplicative_inverse end
-    def / divisor; multiply divisor.multiplicative_inverse end
-  end
-end
-
-
-# Patching Integer with Algebra::Ring compliance methods.
-# 
-class << Integer
-  def additive_identity; 0 end
-  alias zero additive_identity
-  def add( other ); self + other end
-  def additive_inverse; -self end
-  def multiply( other ); self * other end
-  def multiplicative_identity; 1 end
-  alias one multiplicative_identity
-end
-
-# Patching Float with Algebra::Field compliance methods.
-# 
-class << Float
-  def additive_identity; 0.0 end
-  alias zero additive_identity
-  def add( other ); self + other end
-  def additive_inverse; -self end
-  def multiply( other ); self * other end
-  def multiplicative_identity; 1.0 end
-  alias one multiplicative_identity
-  def multiplicative_inverse; 1.0 / self end
-end
-
-# Patching Rational with Algebra::Field compliance methods.
-# 
-class << Rational
-  def additive_identity; Rational 0, 1 end
-  alias zero additive_identity
-  def add( other ); self + other end
-  def additive_inverse; -self end
-  def multiply( other ); self * other end
-  def multiplicative_identity; Rational 1, 1 end
-  alias one multiplicative_identity
-  def multiplicative_inverse; Rational( 1, 1 ) / self end
-end
-
-# Patching Complex with #zero method.
-# 
-class << Complex
-  def additive_identity; Complex 0.0, 0.0 end
-  alias zero additive_identity
-  def add( other ); self + other end
-  def additive_inverse; -self end
-  def multiply( other ); self * other end
-  def multiplicative_identity; Complex 1, 0 end
-  alias one multiplicative_identity
-  def multiplicative_inverse; Complex( 1, 0 ) / self end
-end
-
-
-
-# Wildcard zero, stronger than ordinary numeric literal 0.
-# 
-( WILDCARD_ZERO = NullObject.new ).instance_exec {
-  ɪ = self
-  singleton_class.class_exec { define_method :zero do ɪ end }
-  def * other; other.class.zero end
-  def / other
-    self unless other.zero?
-    fail ZeroDivisionError, "The divisor is zero! (#{other})"
-  end
-  def + other; other end
-  def - other; -other end
-  def coerce other; return other, other.class.zero end
-  def zero?; true end
-  def to_s; "∅" end
-  def inspect; to_s end
-  def to_f; 0.0 end
-  def to_i; 0 end
-  def == other
-    z = begin
-          other.class.zero
-        rescue NoMethodError
-          return false
-        end
-    other == z
-  end
-}
-
-
-# As a matter of fact, current version of the Matrix class (by Marc-Andre
-# Lafortune) does not work with physical magnitudes. It is a feature of the
-# physical magnitudes, that they do not allow themselves summed with plain
-# numbers or incompatible magnitudes. But current version of Matrix class,
-# upon matrix multiplication, performs needless addition of the matrix elements
-# to literal numeric 0.
-#
-# The obvious solution is to patch Matrix class so that the needless addition
-# to literal 0 is no longer performed.
-#
-# More systematically, abstract algebra is to be added to Ruby, and Matrix is
-# to require that its elements comply with monoid, group, ring, field, depending
-# on the operation one wants to do with such matrices.
-#
-class Matrix
-  attr_writer :zero
-  
-  def zero
-    if empty? then @zero else self[0, 0] * 0 end
-  end
-
-  # Matrix multiplication.
-  #
-  def * arg # arg is matrix or vector or number
-    case arg
-    when Numeric
-      rows = @rows.map { |row| row.map { |e| e * arg } }
-      return new_matrix rows, column_size
-    when Vector
-      arg = Matrix.column_vector arg
-      result = self * arg
-      return result.column 0
-    when Matrix
-      Matrix.Raise ErrDimensionMismatch if column_size != arg.row_size
-      if empty? then # if empty?, then reduce uses WILDCARD_ZERO
-        rows = Array.new row_size do |i|
-          Array.new arg.column_size do |j|
-            ( 0...column_size ).reduce WILDCARD_ZERO do |sum, c|
-              sum + arg[c, j] * self[i, c]
-            end
-          end
-        end
-      else             # if non-empty, reduce proceeds without WILDCARD_ZERO
-        rows = Array.new row_size do |i|
-          Array.new arg.column_size do |j|
-            ( 0...column_size ).map { |c| arg[c, j] * self[i, c] }.reduce :+
-          end
-        end
-      end
-      return new_matrix( rows, arg.column_size )
-    when ( SY::Magnitude rescue :SY_Magnitude_absent ) # newly added - multiplication by a magnitude
-      # I am not happy with this explicit switch on SY::Magnitude type here.
-      # Perhaps coerce should handle this?
-      rows = Array.new row_size do |i|
-        Array.new column_size do |j|
-          self[i, j] * arg
-        end
-      end
-      return self.class[ *rows ]
-    else
-      compat_1, compat_2 = arg.coerce self
-      return compat_1 * compat_2
-    end
-  end
-
-  # Creates a matrix of prescribed dimensions filled with wildcard zeros.
-  # 
-  def Matrix.wildcard_zero r_count, c_count=r_count
-    build r_count, c_count do |r, c| WILDCARD_ZERO end
-  end
-end
-

data/lib/y_support/name_magic/array.rb

@@ -1,38 +0,0 @@
-# encoding: utf-8
-
-class Array
-  # Maps an array of some objects into an array of their names, obtained by
-  # applying +#full_name+ method to them. Takes one optional argument, which
-  # regulates its behavior regarding unnamed objects. If set to _nil_ (default),
-  # unnamed
-  # objects will be mapped to _nil_ (default behavior of the +#name+ method).
-  # If set to _true_, unnamed objects will be mapped to themselves. If set to
-  # _false_, unnamed objects will not be mapped at all -- the returned array will
-  # contain only the names of the named objects.
-  # 
-  def names option=nil
-    return map &:name if option.nil?                 # unnamed --> nil
-    return map { |e| e.name || e } if option == true # unnamed --> instance
-    return map( &:name ).compact if option == false  # unnamed squeezed out
-    fail ArgumentError, "Unknown option: #{option}"
-  end
-  # FIXME: The remaining thing to do to achieve compatibility with Ruby's #name
-  # is to put "full_name" in the body, and "name" in the alias...
-  alias full_names names
-
-  # Maps an array to an array of the element names, obtained by applying
-  # +#_name_+ method to them. Takes one optional argument, which regulates its
-  # behavior regarding unnamed objects. If set to _nil_ (default) unnamed
-  # objects will be mapped to _nil_ (default behavior of +#_name_+ method). If
-  # set to _true_, unnamed objects will be mapped to themselves. If set to
-  # _false_, unnamed objects will not be mapped at all -- the returned array
-  # will contain only the names of the named objects.
-  # 
-  def _names_ option=nil
-    return map &:_name_ if option.nil?                 # unnamed --> nil
-    return map { |e| e.name || e } if option == true   # unnamed --> instance
-    return map( &:_name_ ).compact if option == false  # unnamed squeezed out
-    fail ArgumentError, "Unknown option: #{option}"
-  end
-  alias ɴs _names_
-end

data/lib/y_support/name_magic/hash.rb

@@ -1,31 +0,0 @@
-# encoding: utf-8
-
-class Hash
-  # Maps the hash into one whose keys have been replaced with full names of
-  # the keys (which are assumed to be objects responding to +#full_name+ method).
-  # 
-  def keys_to_names                        # FIXME: Change to keys_to_full_names
-    with_keys do |key| key.name || key end # FIXME: Change name to full_name
-  end
-
-  # Modifies a hash in place so that the keys are replaced with key names (key
-  # objects are assumed to respond to +#name+ method).
-  # 
-  def keys_to_names!                        # FIXME: Change to keys_to_full_names!
-    with_keys! do |key| key.name || key end # FIXME: Change name to full_name
-  end
-
-  # Maps a hash into a hash, whose keys have been replaced with names of the
-  # key objects (which are assumed to respond to +#name+ method).
-  # 
-  def keys_to_ɴs
-    with_keys do |key| key._name_ || key end
-  end
-
-  # Modifies a hash in place so that the keys are replaced with key names (key
-  # objects are assumed to respond to +#name+ method).
-  # 
-  def keys_to_ɴs!
-    with_keys! do |key| key._name_ || key end
-  end
-end