y_support 2.4.6 → 2.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: eb3706957a1022fffe6b271c1585bf23dc27a922
-  data.tar.gz: 9a632cf5c99aef509bc144adf2f179e3d51331ff
+  metadata.gz: a2e9ed33873ba6f65cec12b20001eb56cb3e217c
+  data.tar.gz: ea33118ef8cebea1b7a1cf8ceeeb6327a611628e
 SHA512:
-  metadata.gz: 811f88237a88ec79297ba24a517d4f8923333e5cf49a97759e95eca881a124975b2d754addcd288fa414780ea93e18cb47d3f2c46c89e6526f9319b314e6407b
-  data.tar.gz: c8d6ed7aa7cac621d6e576fa1ddf939c359e561a3de2f4846e34802ec4ac7d18cad42eb26d0e532915c560d88ec0cf5425a5965e90ce7b75ab6031091f204705
+  metadata.gz: 4e4cfcf183d1d8d24611d3b923e1da4b7f02c29f1b3e1d10ad9b8db9c933cb99f9f712c266dbec3f259b19853f69f5ec09c1f9a59deb3d747a3965692471b6f2
+  data.tar.gz: ab06499e3ac0deea21a0817215fe0c45748794b67dc5876dfd6f198aea5586e349a7df5ccce2d568369a0e6c8d52fa94e73acc1934b0b3adea0846274a3aabf1

data/lib/y_support/all.rb

@@ -3,12 +3,6 @@
 require 'y_support'
 require 'y_support/flex_coerce'
 require 'y_support/name_magic'
-require 'y_support/typing'
 require 'y_support/unicode'
-require 'y_support/respond_to'
-require 'y_support/null_object'
-require 'y_support/inert_recorder'
-require 'y_support/local_object'
-require 'y_support/literate'
-require 'y_support/kde'
 require 'y_support/misc'
+require 'y_support/typing'

data/lib/y_support/{inert_recorder.rb → misc/inert_recorder.rb}

@@ -1,6 +1,6 @@
 # encoding: utf-8
 
-require_relative '../y_support'
+require_relative '../../y_support'
 
 # Inert recorder is similar to a null object in the sense, that in response to
 # almost all messages it returns self. But in addition, it records received

data/lib/y_support/{local_object.rb → misc/local_object.rb}

@@ -1,6 +1,6 @@
 # encoding: utf-8
 
-require_relative '../y_support'
+require_relative '../../y_support'
 
 # Object, whose business is to stay local to methods. Optional signature
 # provides additional level of safety in ensuring object locality. (Signature

data/lib/y_support/{null_object.rb → misc/null_object.rb}

@@ -1,6 +1,6 @@
 # encoding: utf-8
 
-require_relative '../y_support'
+require_relative '../../y_support'
 
 # Null object pattern implementation in +YSupport+. apart from the expected null
 # object behavior (such as returning self in response to almost all messages),

data/lib/y_support/{respond_to.rb → misc/respond_to.rb}

@@ -1,4 +1,4 @@
-require_relative '../y_support'
+require_relative '../../y_support'
 
 # RespondTo class for easy use of respond_to? in case statements.
 # 

data/lib/y_support/misc.rb

@@ -1,27 +1,6 @@
-require 'y_support'
+require_relative '../y_support'
 
-# Typing library.
-#
-# Apart from usual <em>typing by class and ancestry</em>, supported by built-in
-# #kind_of?, alias #is_a? inquirerers, this typing library provides support for
-# provides support for <em>typing by declaration</em> and <em>duck typing</em>.
-# 
-# 1. Using method <b>declare_compliance</b>, a module can explicitly declare that
-# it provides the interface compliant with another module. Corresponding inquirer
-# methods are <b>declared_compliance</b> (returning a list of modules with which
-# the receiver declares compliance or implicitly complies) and
-# <b>declares_compliance?( other_module )</b>, which anwers whether the receiver
-# complies with other_module. An object always implicitly complies with its class
-# and class ancestry.
-# 
-# 2. Duck type enforcement for method parameters is supported by a collection of
-# enforcer methods (aka. run-time assertions). These methods look very much like
-# assertions, but they start with <b>tE_...</b>, meaning "enforce by raising
-# TypeError".
-
-[ :core_ext, :stdlib_ext ].each do |ext|
-  Dir["#{File.dirname( __FILE__ )}/#{ext}/*/misc.rb"].sort.each { |path|
-    dir = File.dirname( path ).match( "y_support/#{ext}" ).post_match
-    require "y_support/#{ext}#{dir}/misc"
-  }
-end
+require_relative 'misc/respond_to'
+require_relative 'misc/null_object'
+require_relative 'misc/inert_recorder'
+require_relative 'misc/local_object'

data/lib/y_support/name_magic/namespace.rb

@@ -360,22 +360,11 @@ module NameMagic::Namespace
   # Checks whether a name is acceptable as a constant name.
   # 
   def validate_name name
-    # Note that the #try method (provided by 'y_support/literate')
-    # allows us to call the methods of name without mentioning
-    # it explicitly as the receiver, and it also allows us to
-    # raise errors without explicitly constructing the error
-    # messages. Thus, chars.first actually means name.chars.first.
-    # Error message (when error occurs) is constructed from
-    # the #try description and the #note strings, which act at
-    # the same time as code comments. End of advertisement for
-    # 'y_support/literate'.
-    # 
-    name.to_s.try "to validate the suggested instance name" do
-      note "rejecting non-capitalized names"
-      fail NameError unless ( ?A..?Z ) === chars.first
-      note "rejecting names with spaces"
-      fail NameError if chars.include? ' '
-    end
+    n = name.to_s
+    # rejecting non-capitalized names
+    fail NameError unless ( ?A..?Z ) === n.chars.first
+    # rejecting names with spaces
+    fail NameError if n.chars.include? ' '
     # Return value is the validated name.
     return name
   end

data/lib/y_support/name_magic.rb

@@ -2,7 +2,6 @@
 
 require_relative '../y_support'
 require_relative 'core_ext/hash/misc'
-require_relative 'literate'
 
 # Module NameMagic imitates Ruby constant magic and automates the
 # named argument :name, alias :ɴ (Character "ɴ", Unicode small

data/lib/y_support/version.rb

@@ -1,4 +1,4 @@
 module YSupport
-  VERSION = "2.4.6"
+  VERSION = "2.5.1"
   DEBUG = false
 end

data/test/{inert_recorder_test.rb → misc/inert_recorder_test.rb}

@@ -3,11 +3,9 @@
 
 require 'minitest/autorun'
 
-describe "InertRecorder"  do
-  before do
-    require './../lib/y_support/inert_recorder'
-  end
+require_relative '../../lib/y_support/misc/inert_recorder'
 
+describe "InertRecorder"  do
   describe "Object" do
     it "should have #InertRecorder() constructor" do
       assert_equal InertRecorder, InertRecorder( :bull ).class

data/test/{local_object_test.rb → misc/local_object_test.rb}

@@ -3,11 +3,9 @@
 
 require 'minitest/autorun'
 
-describe "LocalObject" do
-  before do
-    require './../lib/y_support/local_object'
-  end
+require_relative '../../lib/y_support/misc/local_object'
 
+describe "LocalObject" do
   describe "Object" do
     it "should have constructor #LocalObject, alias #L!" do
       assert_equal LocalObject, LocalObject().class

data/test/{null_object_test.rb → misc/null_object_test.rb}

@@ -3,11 +3,9 @@
 
 require 'minitest/autorun'
 
-describe "y_support/null_object" do
-  before do
-    require './../lib/y_support/null_object'
-  end
+require_relative '../../lib/y_support/misc/null_object'
 
+describe "y_support/null_object" do
   describe Object do
     it "should have #null_object? (alias #null?)" do
       assert ( class Koko < NullObject; self end ).new.null_object?

data/test/{respond_to_test.rb → misc/respond_to_test.rb}

@@ -3,9 +3,9 @@
 
 require 'minitest/autorun'
 
-describe "y_support/typing" do
+describe "respond_to" do
   before do
-    require './../lib/y_support/respond_to'
+    require './../lib/y_support/misc/respond_to'
   end
 
   describe Object do

data/test/misc_test.rb

@@ -3,389 +3,7 @@
 
 require 'minitest/autorun'
 
-describe Object do
-  before do
-    require './../lib/y_support/core_ext/object'
-  end
-
-  it "should have #param_class" do
-    o = Object.new
-    m = Module.new
-    o.param_class( { Array: Array, foo: Hash, bar: m }, with: { mother: o } )
-    assert o.Array < Array
-    o.Array.mother.must_equal( o )
-    o.foo.mother.must_equal( o )
-    o.bar.ancestors[1].must_equal( m )
-    o.bar.mother.must_equal( o )
-  end
-
-  it "should have #param_class!" do
-    o = Object.new
-    m = Module.new
-    o.param_class!( { Array: Array, foo: Hash, bar: m }, with: { mother: o } )
-    assert o.Array < Array
-    o.Array.mother.must_equal( o )
-    o.foo.mother.must_equal( o )
-    o.bar.ancestors[1].must_equal( m )
-    o.bar.mother.must_equal( o )
-  end
-
-  it "should have #insp method to facilitate inspection" do
-    module Quux; class Foo; def to_s; "bar" end end end
-    Quux::Foo.new.y_inspect.must_equal "Quux::Foo:bar"
-    Quux::Foo.new.y_inspect( :full ).must_equal "#<Quux::Foo:bar>"
-    Quux::Foo.new.y_inspect( :short ).must_equal "Foo:bar"
-  end
-end
-
-
-describe Module do
-  before do
-    require './../lib/y_support/core_ext/module'
-  end
-
-  it "has #const_set_if_not_defined and #const_reset!" do
-    m = Module.new
-    hm = m.heir_module( p1: 1, p2: 2 )
-    hm.ancestors[1].must_equal m
-    hm.p1.must_equal 1
-    hm.p2.must_equal 2
-    hc = m.heir_class( Array, q1: 1, q2: 2 )
-    hc.new.class.ancestors[1].must_equal m
-    hc.q1.must_equal 1
-    hc.q2.must_equal 2
-    m.const_set_if_not_defined :Foo, 42
-    m::Foo.must_equal 42
-    m.const_reset! :Foo, 43
-    m::Foo.must_equal 43
-    m.module_exec do
-      selector :a
-      def initialize; @a = 42 end
-      chain b: :a, &:to_s
-    end
-    Class.new do include m end.new.b.must_equal "42"
-  end
-end
-
-
-describe Class do
-  before do
-    require './../lib/y_support/core_ext/class'
-  end
-
-  it "has #selector alias for #attr_reader method" do
-    o = Class.new do
-      selector :a
-      def initialize a; @a = a end
-    end.new( 42 )
-    o.a.must_equal( 42 )
-  end
-
-  it "has #parametrize method" do
-    a = Class.new
-    -> { a.foo }.must_raise NoMethodError
-    b = a.parametrize foo: 42
-    b.foo.must_equal 42
-  end
-end
-
-
-describe Enumerable do
-  before do
-    require './../lib/y_support/core_ext/enumerable'
-  end
-
-  it "should introduce #all_kind_of? collection qualifier" do
-    assert_equal true, [ 1, 1.0 ].all_kind_of?( Numeric )
-    assert_equal false, [ 1, [1.0] ].all_kind_of?( Numeric )
-  end
-    
-  it "should introduce #all_numeric? collection qualifier" do
-    assert_equal true, [1, 1.0].all_numeric?
-    assert_equal false, [:a, 1].all_numeric?
-  end
-
-  it "should have #subset_of? collection qualifier" do
-    assert_equal( true, [1,2].subset_of?( [1,2,3,4] ) )
-    assert_equal( false, [1,2].subset_of?( [2,3] ) )
-    assert_equal( true, [1,2].subset_of?( [1,2] ) )
-    assert_equal( true, [1, 1.0].subset_of?( [1.0, 2.0] ) )
-  end
-end
-
-
-describe Array do
-  before do
-    require './../lib/y_support/core_ext/array'
-  end
-
-  it "has #arrays_to_hash" do
-    [ [ :a, 1 ], [ :b, 2 ] ].arrays_to_hash
-      .must_equal( { a: 1, b: 2 } )
-    [ [ :a, 1, 2 ], [ :b, 2, 3 ] ].arrays_to_hash
-      .must_equal( { a: [ 1, 2 ], b: [ 2, 3 ] } )
-  end
-
-  it "has #zip_to_hash" do
-    assert_equal( {a: 1, b: 2}, [:a, :b].zip_to_hash( [1, 2] ) )
-    assert_equal( {a: "a"}, [:a].zip_to_hash( &:to_s ) )
-  end
-
-  it "has #>>" do
-    assert_equal( {a: 1, b: 2}, [:a, :b] >> [1, 2] )
-  end
-
-  it "has #ascending_floor" do
-    a = 1, 2, 3
-    a.ascending_floor( 0.5 ).must_equal nil
-    a.ascending_floor( 1 ).must_equal 1
-    a.ascending_floor( 1.5 ).must_equal 1
-    a.ascending_floor( 3.5 ).must_equal 3
-    a.ascending_floor( 1, false ).must_equal nil
-    a.ascending_floor( 3, false ).must_equal 2
-  end
-
-  it "has #ascending_ceiling" do
-    a = 1, 2, 3
-    a.ascending_ceiling( 0.5 ).must_equal 1
-    a.ascending_ceiling( 1.5 ).must_equal 2
-    a.ascending_ceiling( 3 ).must_equal 3
-    a.ascending_ceiling( 3.1 ).must_equal nil
-    a.ascending_ceiling( 3, false ).must_equal nil
-    a.ascending_ceiling( 2, false ).must_equal 3
-  end
-
-  it "has #to_proc in style &[function, *args]" do
-    assert_equal [2, 3], [1, 2].map( &[:+, 1] )
-  end
-
-  it "has #push/pop_ordered/named" do
-    a = [1, 2, foo: 3]
-    a.pop_named( :foo ).must_equal 3
-    a.pop_named( :bar ).must_equal nil
-    a.pop_ordered.must_equal 2
-    a.push_ordered( 2 ).must_equal [1, 2]
-    a.push_named( foo: 3 ).must_equal [1, 2, foo: 3]
-    a.push_named( bar: 4 ).must_equal [1, 2, foo: 3, bar: 4]
-    a.pop_named( :foo ).must_equal 3
-    a.push_ordered( 42 ).must_equal [1, 2, 42, bar: 4] 
-  end
-
-  it "has #to_column_vector" do
-    [1, 2, 3].to_column_vector.must_equal Matrix[[1], [2], [3]]
-  end
-end
-
-describe Hash do
-  before do
-    require './../lib/y_support/core_ext/hash'
-  end
-
-  it "should have #default! custom defaulter" do
-    defaults = { a: 1, b: nil }
-    test = {}
-    result = test.default!( defaults )
-    assert_equal defaults, result
-    assert_equal result.object_id, test.object_id
-    test = { a: 11, b: 22 }
-    assert_equal( { a: 11, b: 22 }, test.default!( defaults ) )
-    test = { a: 11, c: 22 }
-    { a: 11, b: nil, c: 22 }.must_equal test.default! defaults
-  end
-
-  it "should have #with_keys and #with_keys!" do
-    test = { "a" => :b, "c" => :d }
-    test.with_keys( &:to_sym ).must_equal( { a: :b, c: :d } )
-    test.must_equal( { "a" => :b, "c" => :d } )
-    test.with_keys! &:to_sym
-    test.must_equal( { a: :b, c: :d } )
-  end
-
-  it "should have #change_keys" do
-    test = { a: 1, c: 2 }
-    test.change_keys { |k, v| k.to_s + v.to_s }
-      .must_equal( { "a1" => 1, "c2" => 2 } )
-  end
-
-  it "should have #with_values and #with_values!" do
-    test = { a: :b, c: :d }
-    test.with_values( &:to_s ).must_equal( { a: "b", c: "d" } )
-    test.must_equal( { a: :b, c: :d } )
-    test.with_values!( &:to_s )
-    test.must_equal( { a: "b", c: "d" } )
-  end
-
-  it "should have #change_values and #change_values!" do
-    test = { a: :b, c: :d }
-    test.modify_values do |k, v| k.to_s + v.to_s end
-      .must_equal( {a: "ab", c: "cd"} )
-    test.must_equal( { a: :b, c: :d } )
-    test.modify_values! { |k, v| k.to_s + v.to_s }
-    test.must_equal( {a: "ab", c: "cd"} )
-  end
-
-  it "should have #modify" do
-    assert_equal( { ab: "ba", cd: "dc" },
-                  { a: :b, c: :d }
-                    .modify { |k, v| ["#{k}#{v}".to_sym, "#{v}#{k}"] } )
-  end
-
-  it "should have #slice" do
-    { a: 1, b: 2, c: 3 }.slice( [:a, :b] ).must_equal( { a: 1, b: 2 } )
-    { 1 => :a, 2 => :b, 3 => :c, 4 => :d }.slice( 2..3.5 )
-      .must_equal( { 2 => :b, 3 => :c } )
-    { 0.0 => :a, 1.1 => :b }.slice( 1..2 ).must_equal( { 1.1 => :b } )
-  end
-
-  it "should have #dot! meta patcher for dotted access to keys" do
-    h = Hash.new.merge!(aaa: 1, taint: 2)
-    -> { h.dot! }.must_raise ArgumentError
-    h.dot!( overwrite_methods: true ) # instead of #assert_nothing_raised
-    assert_equal( {aaa: 1}, {aaa: 1}.dot! )
-  end
-
-  it "should be safeguarded against redefining #slice" do
-    m = Hash.instance_method :slice
-    class Hash; def slice( *args ); fail "This should not happen!" end end
-    {}.slice( :a )
-  end
-end
-
-
-describe "Matrix" do
-  before do
-    require 'matrix'
-    require './../lib/y_support/stdlib_ext/matrix'
-  end
-
-  it "should have #pp method" do
-    assert_respond_to Matrix[[1, 2], [3, 4]], :pretty_print
-    assert_respond_to Matrix[[1, 2], [3, 4]], :pp
-  end
-
-  it "should have #correspondence_matrix method" do
-    assert_respond_to Matrix, :correspondence_matrix
-    assert_equal Matrix[[1, 0, 0], [0, 1, 0]],
-    Matrix.correspondence_matrix( [:a, :b, :c], [:a, :b] )
-    assert_equal Matrix.column_vector( [1, 2] ),
-    Matrix.correspondence_matrix( [:a, :b, :c], [:a, :b] ) *
-      Matrix.column_vector( [1, 2, 3] )
-    assert_equal 2, Matrix.correspondence_matrix( [1, 2], [1] ).column_size
-  end
-
-  it "should have #column_to_a & #row_to_a" do
-    assert_equal [1, 2, 3], Matrix[[1], [2], [3]].column_to_a
-    assert_equal [2, 3, 4], Matrix[[1, 2], [2, 3], [3, 4]].column_to_a( 1 )
-    assert_equal nil, Matrix.empty( 5, 0 ).column_to_a
-    assert_equal [1], Matrix[[1], [2], [3]].row_to_a
-    assert_equal [3], Matrix[[1], [2], [3]].row_to_a( 2 )
-  end
-
-  it "should have aliased #row_vector, #column_vector methods" do
-    assert_equal Matrix.column_vector( [1, 2, 3] ),
-    Matrix.cv( [1, 2, 3] )
-    assert_equal Matrix.row_vector( [1, 2, 3] ),
-    Matrix.rv( [1, 2, 3] )
-  end
-
-  it "should have #join_bottom and #join_right" do
-    assert_equal Matrix[[1, 2], [3, 4]],
-    Matrix[[1, 2]].join_bottom( Matrix[[3, 4]] )
-    assert_equal Matrix[[1, 2, 3, 4]],
-    Matrix[[1, 2]].join_right( Matrix[[3, 4]] )
-  end
-
-  it "should have aliased #row_size, #column_size methods" do
-    assert_equal 3, Matrix.zero(3, 2).height
-    assert_equal 3, Matrix.zero(3, 2).number_of_rows
-    assert_equal 2, Matrix.zero(3, 2).width
-    assert_equal 2, Matrix.zero(3, 2).number_of_columns
-  end
-end
-
-describe String do
-  before do
-    require './../lib/y_support/core_ext/string'
-  end
-
-  it "should have #can_be_integer? returning the integer or false if not convertible" do
-    assert_equal 33, "  33".to_Integer
-    assert_equal 8, " 010 ".to_Integer
-    assert_equal false, "garbage".to_Integer
-  end
-
-  it "should have #can_be_float? returning the float or false if not convertible" do
-    assert_equal 22.2, ' 2.22e1'.to_Float
-    assert_equal 10, " 010 ".to_Float
-    assert_equal false, "garbage".to_Float
-  end
-
-  it "should have #default! defaulter" do
-    assert_equal "default", "".default!("default")
-    assert_equal "default", " ".default!(:default)
-    assert_equal "default", " \n ".default!("default")
-    assert_equal "kokot", "kokot".default!("default")
-    a = ""
-    assert_equal a.object_id, a.default!("tata").object_id
-  end
-
-  it "should have #stripn upgrade of #strip, which also strips newlines" do
-    assert_equal "test test", " \n test test \n\n  \n ".stripn
-  end
-
-  it "should have #compact for joining indented lines (esp. heredocs)" do
-    assert_equal "test test test",
-    "test\n test\n\n   \n   test\n  ".wring_heredoc
-    funny_string = <<-FUNNY_STRING.wring_heredoc
-                        This
-                          is
-                            a funny string.
-                        FUNNY_STRING
-    assert_equal( 'This is a funny string.', funny_string )
-  end
-
-  it "should be able #underscore_spaces" do
-    assert_equal "te_st_test", "te st test".underscore_spaces
-  end
-
-  it "should have #symbolize stripping, removing capitalization and diacritics " \
-  'as if to make a suitable symbol material' do
-    assert_equal "Yes_sir!", " \nYes, sir!.; \n \n".standardize
-  end
-
-  it "should have #to_standardized_sym chaining #standardize and #to_sym" do
-    assert_equal :Yes,  " \nYes,.; \n \n".to_standardized_sym
-  end
-end
-
-
-describe Symbol do
-  before do
-    require_relative '../lib/y_support/core_ext/symbol'
-  end
-
-  it "should have #default! defaulter going through String#default!" do
-    assert_equal :default, "".to_sym.default!(:default)
-    assert_equal :default, "".to_sym.default!("default")
-    assert_equal :default, " ".to_sym.default!("default")
-    assert_equal :default, " \n ".to_sym.default!("default")
-    assert_equal :kokot, :kokot.default!("default")
-  end
-
-  it "should have #to_standardized_sym" do
-    assert_equal :Yes, (:" \nYes, \n").to_standardized_sym
-  end
-end
-
-
-describe Numeric do
-  before do
-    require './../lib/y_support/core_ext/numeric'
-  end
-
-  it "should have #zero public class methods" do
-    assert_equal 0, Integer.zero
-    assert_equal 0.0, Float.zero
-    assert_equal Complex(0, 0), Complex.zero
-  end
-end
+require_relative 'misc/inert_recorder_test'
+require_relative 'misc/local_object_test'
+require_relative 'misc/null_object_test'
+require_relative 'misc/respond_to_test'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: y_support
 version: !ruby/object:Gem::Version
-  version: 2.4.6
+  version: 2.5.1
 platform: ruby
 authors:
 - boris
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-06-22 00:00:00.000000000 Z
+date: 2016-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -91,18 +91,16 @@ files:
 - 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/misc/inert_recorder.rb
+- lib/y_support/misc/local_object.rb
+- lib/y_support/misc/null_object.rb
+- lib/y_support/misc/respond_to.rb
 - lib/y_support/name_magic.rb
 - lib/y_support/name_magic/array_methods.rb
 - lib/y_support/name_magic/class_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
@@ -119,21 +117,16 @@ files:
 - lib/y_support/typing/object/typing.rb
 - lib/y_support/unicode.rb
 - lib/y_support/version.rb
-- lib/y_support/x.rb
 - test/core_ext_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/inert_recorder_test.rb
+- test/misc/local_object_test.rb
+- test/misc/null_object_test.rb
+- test/misc/respond_to_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/respond_to_test.rb
 - test/typing_test.rb
 - test/unicode_test.rb
-- test/x_test.rb
 - y_support.gemspec
 homepage: ''
 licenses:
@@ -162,15 +155,11 @@ summary: Support library used by Y gems.
 test_files:
 - test/core_ext_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/inert_recorder_test.rb
+- test/misc/local_object_test.rb
+- test/misc/null_object_test.rb
+- test/misc/respond_to_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/respond_to_test.rb
 - test/typing_test.rb
 - test/unicode_test.rb
-- test/x_test.rb

data/lib/y_support/kde.rb

@@ -1,14 +0,0 @@
-# encoding: utf-8
-
-require_relative '../y_support'
-
-module YSupport::KDE
-  class << self
-    # Open a file with kioclient (using KDE file-viewer associations).
-    # 
-    def show_file_with_kioclient( fɴ_with_path )
-      system "sleep 0.2; kioclient exec 'file:%s'" % fɴ_with_path
-    end
-  end
-end # module YSupport::KDE
-

data/lib/y_support/literate.rb

@@ -1,253 +0,0 @@
-# encoding: utf-8
-
-require_relative '../y_support'
-require_relative '../y_support/core_ext/array/misc'
-
-# Did you ever get in the situation that your code does not work
-# and you don't know what the problem is? In Ruby, error messages
-# are supposed to help you, but how often have you seen error
-# messages telling you completely unhelpful things, such as that
-# some method is not defined for nil:NilClass? Anyone who
-# programmed in Ruby for some time knows that raising good error
-# messages is a pain and the code that raises them tends to make
-# all your methods look ugly. YSupport's answer to this is Literate
-# (loaded by require 'y_support/literate'). Literate offers +#try+
-# block, inside which you can construct verbose error messages with
-# k +#note+ statements. Note that this +#try+ method has nothing to
-# do with the infamous error-swallowing +#try+ method seen and
-# denounced elsewhere. Literate's +#try+ method does not swallow
-# errors – on the contrary, it helps to raise them. Comments you
-# make via +#note+ method (or its alias #») inside +#try+ blocks
-# will be used to construct more informative error messages. Good
-# error messages ultimately lead to better code and more scalable
-# development. Simple example:
-#
-#   "lorem ipsum dolor sit amet".try "to split it into words" do
-#     note is: "a natural language sentence"
-#     note has: "#{size} characters"
-#     words = split ' '
-#   end
-#
-# This is not really such a good example, because #try method is
-# intended for risky operation, and splitting a string into words
-# is not risky at all. But it clearly shows how Literate works.
-# Since the era of programs written on punch cards, programmers
-# already understood that writing code comments is a good
-# practice. The keystrokes you waste by literate coding will pay
-# off as soon as you start doing any serious programming. With
-# Literate, you can take literate coding to the next level by
-# writing self-documenting code, in which comments introduced by
-# #note method are read by the interpeter and used to construct
-# error messages. All you need to learn is how to use +#try+ and
-# +#note+ methods.
-#
-# Literate relies on +Literate::Attempt+ class, which stays hidden
-# behind the scene, but defines all the error-raising capabilities
-# of +#try+ blocks.
-#
-module Literate
-  # Represents a commented attempt to perform a risky operation,
-  # which may result in errors. The operation code is supplied as
-  # a block. Method #comment defined by this class helps to
-  # increase the informative value of error messages.
-  # 
-  class Attempt < BasicObject
-    # String construction closures are defined below.
-    CONSTRUCT = -> string, prefix: '', postfix: '' do
-      s = string.to_s
-      if s.empty? then '' else prefix + s + postfix end
-    end
-
-    # Hash of transitive verb forms.
-    TRANSITIVE = ::Hash.new do |_, key| "#{key}ing %s" end
-      .update( is: "being %s", has: "having %s" )
-
-    # Hash for construction of statements (error message parts).
-    STATE = ::Hash.new do |ꜧ, key| "#{key} %s" end
-      .update( is: "%s", has: "has %s" )
-
-    # An Attempt instance has 4 properties.
-    attr_reader :__subject__ # Grammatical subject of the attempt.
-    attr_reader :__block__   # Block that performs the attempt.
-    attr_reader :__text__    # NL description of the attempt.
-    attr_reader :__knowledge_base__
-
-    # Attempt constructor expects two parameters (:subject and
-    # :text) and one block. Argument of the :subject parameter is
-    # the main subject of the risky operation attempted inside the
-    # block. Argument of the :text parameter is the natural
-    # language textual description of the risky opration.
-    # 
-    def initialize( subject: nil, text: nil, &block )
-      @__subject__ = subject
-      @__text__ = text
-      @__block__ = block
-      # Knowledge base is a list of subjects and facts known
-      # about them.
-      @__knowledge_base__ = ::Hash.new do |hash, missing_key|
-        hash[ missing_key ] = [ {} ]
-      end
-    end
-
-    # Method #note is available inside the #try block
-    # 
-    #   note "Concatenation of Foo and Bar",
-    #        is: "FooBar",
-    #        has: "6 letters"
-    #
-    def note *subjects, **statements, &block
-      if statements.empty? then
-        # No statements were supplied to #note.
-        subjects.each { |subject|
-          # Fill in the knowledge base ...
-          # FIXME: I wonder how the code here works.
-          __knowledge_base__[ subject ].push_ordered subject
-        }
-        # FIXME: I wonder whether returning this is OK.
-        return subjects
-      end
-      # Here, we know that variable statements is not empty.
-      # If subjects variable is empty, assume main subject.
-      subjects << __subject__ if subjects.empty?
-      # Fill the knowledge base ...
-      # FIXME: I wonder how the code here works.
-      subjects.each { |subject|
-        statements.each do |verb, object|
-          __knowledge_base__[ subject ].push_named verb => object
-        end
-      }
-      # Return the second element of the first statement.
-      return statements.first[ 1 ]
-    end
-
-    # Alias of #note method that allows comments such as this:
-    #
-    # a = []
-    # a.try "to insert number one in it" do
-    #   » is: "an empty array"
-    #   push 1
-    # end
-    # 
-    alias » note
-
-    # Runs the attempt.
-    # 
-    def __run__ *args
-      begin
-        instance_exec *args, &__block__
-      rescue ::StandardError => error
-        # Error has occured. Show time for Literate::Attempt.
-        raise error, __error_message__( error )
-      end
-    end
-
-    # Facilitating error messages is the main purpose of Literate.
-    # This method is invoked when an error occurs inside the block
-    # run by Literate::Attempt instance and it constructs a verbose
-    # error message using the facts the Attempt instance knows.
-    # 
-    def __error_message__ error
-      # Write the first part of the error message.
-      part1 = "When trying #{__text__}"
-      # Get the description of the main subject.
-      subject, statements = __describe__( __subject__ )
-      # Write the 2nd part of the error message.
-      part2 = CONSTRUCT.( subject, prefix: ' ' )
-      # Construct the descriptive string of the main subject.
-      subject_description = statements.map { |verb, object|
-        # Generate the statement string.
-        STATE[ verb ] % object
-      }.join ', ' # join the statement strings with commas
-      # Write the third part of the error message.
-      part3 = CONSTRUCT.( subject_description,
-                         prefix: ' (', postfix: ')' )
-      # Write the fourth part of the error message.
-      part4 = CONSTRUCT.( __circumstances__, prefix: ', ' )
-      # Write the fifth part of the error message.
-      part5 = ": #{error}"
-      part6 = ['.', '!', '?'].include?( part5[-1] ) ? '' : '!'
-      return [ part1, part2, part3, part4, part5, part6 ].join
-    end
-
-    # Inside the block, +#try method is delegated to the subject
-    # of the attempt.
-    # 
-    def try *args, &block
-      __subject__.try *args, &block
-    end
-
-    # Method missing delegates all methods not recognized by
-    # Literate::Attempt class (which is a subclass of BasicObject)
-    # to the subject of the attempt.
-    # 
-    def method_missing symbol, *args
-      __subject__.send symbol, *args
-    end
-
-    # Produces a description of the subject supplied to the method.
-    # 
-    def __describe__ subject
-      # Start with the facts known about the subject.
-      facts = __knowledge_base__[ subject ].dup
-      # FIXME: I wonder what this method is *really* doing.
-      # It seems that I wrote this library too quickly and didn't
-      # bother with properly defining its list of facts.
-      # I did not define what is a "fact", what is a "statement"
-      # etc., I just go around using the words and hoping I will
-      # understand it after myself later. I found it's quite hard.
-      statements = if facts.last.is_a? ::Hash then
-                     facts.pop
-                   else {} end
-      fs = facts.join ', '
-      if statements.empty? then
-        return fs, statements
-      else
-        return facts.empty? ? subject.to_s : fs, statements
-      end
-    end
-
-    # Produces description of the circumstances, that is,
-    # concatenated descriptions of all facts known to the Attempt
-    # instance except those about the main subject of the attempt.
-    # 
-    def __circumstances__
-      # Start with all facts known to the Attempt instance.
-      base = __knowledge_base__
-      # Ignore the facts about the main subject.
-      circumstances = base.reject { |s, _| s == __subject__ } 
-      # Construct descriptive strings of the remaining facts.
-      fact_strings = circumstances.map { |subject, _|
-        subject, statements = __describe__( subject )
-        statements = statements.map { |verb, object|
-          TRANSITIVE[ verb ] % object
-        }.join( ', ' )
-        # Create the fact string.
-        subject + CONSTRUCT.( statements, prefix: ' ' )
-      }
-      # Concatenate the fact strings and return the result.
-      return fact_strings.join( ', ' )
-    end
-  end
-end
-
-class Object
-  # Try method takes two textual arguments and one block. The first
-  # (optional) argument is a natural language description of the
-  # method's receiver (with #to_s of the receiver used by
-  # default). The second argument is a natural language description
-  # of the supplied block's _contract_ -- in other words, what the
-  # supplied block tries to do. Finally, the block contains the
-  # code to perform the described risky action. Inside the block,
-  # +#note+ method is available, which builds up the context
-  # information for a good error message, should the risky action
-  # raise one.
-  # 
-  def try attempt_description, &block
-    # Construct a new Attempt instance.
-    attempt = Literate::Attempt.new subject: self,
-                                    text: attempt_description,
-                                    &block
-    # Run the block.
-    attempt.__run__
-  end
-end

data/lib/y_support/x.rb

@@ -1,86 +0,0 @@
-require_relative '../y_support'
-require 'gtk2'
-
-# Assets related to X windows control.
-# 
-module YSupport::X
-  # ==================================================================
-  # 
-  # Notice: Assets related to X windows control do not really belong
-  # to YSupport. I should keep them somewhere else. I will keep this
-  # file in YSupport 2.x for historical reasons. Module YSupport::X
-  # will be removed in YSupport 3.0, which will no longer cover tools
-  # for X windows control.
-  # 
-  warn "YSupport::X is obsolete!"
-  # 
-  # ==================================================================
-
-  # Echo a string to the primary X clip; `xsel -b -i`.
-  #
-  def echo_primary_clipboard string
-    s = 'echo -n ' + string.inspect + ' | xsel -b -i'
-    system s
-  end
-
-  # Echo a string to the secondary X clip; `xsel -b -i`.
-  # 
-  def echo_secondary_clipboard string
-    s = 'echo -n ' + string.inspect + ' | xsel -s -i'
-    system s
-  end
-
-  # Dialog box querying for a string.
-  # 
-  def query_box( dialog_text, prompt: '> ', title_bar: 'User input required', &block )
-    title_bar_text = title_bar
-    prompt_label_text = prompt
-    
-    w = Gtk::Window.new( Gtk::Window::TOPLEVEL )
-    w.set_title( title_bar_text )
-    w.border_width = 10
-    w.signal_connect 'delete_event' do Gtk.main_quit end               # cc
-    
-    tlabel_widget = Gtk::Label.new( dialog_text )
-    plabel_widget = Gtk::Label.new( prompt_label_text )
-    ebox_widget = Gtk::Entry.new
-    ebox_widget.visibility = true                                      # cc
-    
-    hbox = Gtk::HBox.new(false, 5)                                     # cc
-    hbox.pack_start_defaults( plabel_widget )                          # cc
-    hbox.pack_start_defaults( ebox_widget )
-    vbox = Gtk::VBox.new(false, 5)
-    vbox.pack_start_defaults( tlabel_widget )
-    vbox.pack_start_defaults( hbox )
-    w.add(vbox)
-    
-    memo = ""
-    memo_closure = -> txt { memo << txt }
-    
-    ebox_widget.signal_connect "key-release-event" do |sender, event| # cc
-      kn = Gdk::Keyval.to_name( event.keyval )
-      if kn == "Return"
-        memo_closure.( sender.text )
-        block.( sender.text ) if block
-        Gtk.main_quit
-      end
-    end
-    
-    memo.tap { w.show_all; Gtk.main }
-  end
-
-  # Message box.
-  # 
-  def message_box( message="Press any key to close this window!" )
-    w = Gtk::Window.new
-    w.add_events Gdk::Event::KEY_PRESS
-    w.add Gtk::Label.new( message )
-    w.signal_connect "key-release-event" do Gtk.main_quit end
-    w.set_default_size( 600, 120 )
-    w.show_all
-    Gtk.main
-  end
-  alias popup message_box
-
-  extend self
-end # module YSupport::X

data/test/kde_test.rb

@@ -1,11 +0,0 @@
-#! /usr/bin/ruby
-#encoding: utf-8
-
-require 'minitest/autorun'
-require './../lib/y_support/kde'
-
-describe YSupport::KDE do
-  it "should at least respond to certain messages" do
-    assert_respond_to YSupport::KDE, :show_file_with_kioclient
-  end
-end

data/test/literate_test.rb

@@ -1,231 +0,0 @@
-#! /usr/bin/ruby
-# coding: utf-8
-
-require 'minitest/autorun'
-# require 'y_support/literate'     # tested component itself
-require './../lib/y_support/literate'
-
-describe Literate::Attempt do
-  before do
-    @str = "lorem ipsum dolor sit amet"
-    @txt = "split the sentence into words"
-    # A simple attempt block.
-    @a = Literate::Attempt.new subject: @str, text: @txt do
-      note is: "natural language sentence"
-      split ' '
-    end
-    # More verbose attempt block.
-    chosen_word = 3
-    @b = Literate::Attempt.new subject: @str, text: @txt do
-      » is: "natural language sentence"
-      » has: "#{size} characters"
-      words = split ' '
-      » "number of words", is: words.size
-      » "chosen word", is: words[ chosen_word ]
-      words
-    end
-  end
-
-  it "should have 4 basic properties" do
-    @a.__text__.must_equal @txt
-    @a.__subject__.must_equal @str
-    @a.__block__.must_be_kind_of Proc
-    @a.__knowledge_base__.must_be_empty
-    # Fact list is empty because the block hasn't been run yet.
-    # Let's run the block:
-    @a.__run__
-    # Now the fact list includes the comment made in the block.
-    @a.__knowledge_base__.size.must_equal 1
-  end
-
-  describe "#__run__" do
-    it "must run the attempt's block" do
-      expected_result = "lorem", "ipsum", "dolor", "sit", "amet"
-      @a.__run__.must_equal expected_result
-    end
-  end
-
-  describe "Object#try method" do
-    before do
-      error = false
-      @error_switch = -> arg { error = arg }
-      @text = "to split into words"
-      @block = proc do
-        note is: "a string with several words"
-        fail error if error
-        split ' '
-      end
-    end
-
-    it "must execute the block allowing subject's methods" do
-      "hello world".try( @text, &@block )
-        .must_equal [ "hello", "world" ]
-      @error_switch.( TypeError )
-      -> { "hello world".try @text, &@block }.must_raise TypeError
-      @error_switch.( NameError )
-      -> { "hello world".try @text, &@block }.must_raise NameError
-    end
-
-    it "must allow Literate::Attempt#comment inside the block" do
-      begin
-        @error_switch.( TypeError )
-        "hello world".try @text, &@block
-      rescue => error
-        # Proof that Literate::Attemp#comment activated.
-        m = error.message
-        m.must_include "When trying to split into words"
-        m.must_include "a string with several words"
-      else
-        flunk "Error expected but nothing raised!"
-      end
-    end
-  end
-
-  describe "#note" do
-    it "must write entries into @__knowledge_base__" do
-      @a.__run__
-      x = { @str => [ is: "natural language sentence" ] }
-      @a.__knowledge_base__.must_equal x
-    end
-
-    it "must write entries into @__knowledge_base__" do
-      @b.__run__
-      x = { @str => [ is: "natural language sentence",
-                      has: "26 characters" ],
-            "number of words" => [ is: 5 ],
-            "chosen word" => [ is: "sit" ] }
-      @b.__knowledge_base__ .must_equal x
-    end
-  end
-
-  describe "#__describe__" do
-    it "must produce description of the main subject" do
-      @a.__run__
-      @a.__describe__( @a.__subject__ )
-        .must_equal [ "lorem ipsum dolor sit amet",
-                      { is: "natural language sentence" } ]
-      @b.__run__
-      @b.__describe__( @a.__subject__ )
-        .must_equal [ "lorem ipsum dolor sit amet",
-                      { is: "natural language sentence",
-                        has: "26 characters" } ]
-    end
-  end
-
-  describe "#__circumstances__" do
-    it "..." do
-      @a.__run__
-      @a.__circumstances__.must_equal ""
-      @b.__run__
-      @b.__circumstances__
-        .must_equal "number of words being 5, " +
-                    "chosen word being sit"
-    end
-  end
-end
-
-describe "usecase 1: name validator" do
-  before do
-    @name_validator = Object.new
-    @name_validator.define_singleton_method :validate do |name|
-      name.to_s.try "to validate the requested name" do
-        note "rejecting non-capitalized names"
-        fail NameError unless ( ?A..?Z ) === self[0]
-        note "rejecting names with spaces"
-        fail NameError unless split( ' ' ).size == 1
-      end
-      return name
-    end
-  end
-
-  it "should validate good names" do
-    @name_validator.validate( :Fred ).must_equal :Fred
-    @name_validator.validate( "Su_san" ).must_equal "Su_san"
-  end
-
-  it "should reject bad names with a good error message" do
-    expected_message =
-      "When trying to validate the requested name, rejecting " +
-      "non-capitalized names: NameError!"
-    begin
-      @name_validator.validate( :fred )
-    rescue => error
-      error.message.must_equal expected_message
-    end
-  end
-end
-
-# describe 'case 1' do
-#   it "should work" do
-#     # begin
-#     #   @a.__run__
-#     # rescue TypeError => err
-#     #   expected_msg = "When trying concatenation of an array " +
-#     #                  "with 2 elements, TypeError occurred: " +
-#     #                  "Lorem ipsum dolor sit amet!"
-#     #   # Make sure the last 45 characters is OK.
-#     #   assert_equal expected_msg[-45..-1], err.message[-45..-1]
-#     #   # # Make sure that whole message is as expected.
-#     #   # assert_equal expected_msg, err.message
-#     # else
-#     #   flunk "Expected TypeError error not raised!"
-#     # end
-#   end
-# end
-
-# describe 'case 2' do
-#   it "should work" do
-#     begin
-#       try "to call constant Nothing" do Nothing end
-#     rescue NameError => err
-#       expected_msg = 'When trying to call constant Nothing, ' +
-#         'NameError occurred: uninitialized constant Nothing'
-#       assert_equal( expected_msg, err.message )
-#     else
-#       flunk "Expected NameError error not raised!"
-#     end
-#   end
-# end
-
-# describe 'case 3' do
-#   it "should work" do
-#     o = Object.new
-#     class << o
-#       def to_s; "THIS OBJECT" end
-#       def hello!; "hello hello" end
-#     end
-#     # Object's methods must be callable
-#     o.try "to say hello" do hello! end.must_equal "hello hello"
-#     begin
-#       o.try "to call a weird method" do goodbye! end
-#     rescue NoMethodError => err
-#       err.message.must_include "When trying to call a weird " +
-#         "method, NoMethodError occurred: undefined method"
-#       err.message.must_include "goodbye!"
-#     end
-#   end
-# end
-
-# describe 'case 4' do
-#   it "should work" do
-#     begin
-#       "FooBar".try "to do something" do
-#         comment has: "#{size} letters",
-#                 is: "a #{self.class} instance"
-#         unless include? "Quux"
-#           comment "Quux", is: "not a part of it"
-#           try "to append Quux to it" do
-#             self << "Quux"
-#             fail "EPIC FAIL"
-#           end
-#         end
-#       end
-#     rescue => err
-#       err.message.must_equal "When trying to do something, " +
-#         "FooBar having 6 letters, being a String instance, " +
-#         "Quux being not a part of it, RuntimeError occurred: " +
-#         "When trying to append Quux to it, RuntimeError " +
-#         "occurred: EPIC FAIL"
-#     end
-#   end
-# end

data/test/misc_test/test_module/fixture_class.rb

@@ -1,8 +0,0 @@
-class MiscTest
-  module TestModule
-    class FixtureClass
-      def hello; "world" end
-    end
-  end
-end
-    

data/test/x_test.rb

@@ -1,21 +0,0 @@
-#! /usr/local/bin/ruby
-# encoding: utf-8
-
-require 'minitest/autorun'
-
-describe "y_support/x" do
-  before do
-    require './../lib/y_support/x'
-    YSupport::X.echo_primary_clipboard '"foo & bar"'
-    YSupport::X.echo_secondary_clipboard "baz"
-  end
-
-  it "should have clipboard as expected" do
-    assert_equal '"foo & bar" baz', [`xsel -b`, `xsel -s`].join(' ')
-  end
-
-  it "should know #query_box and #message_box methods" do
-    assert_respond_to YSupport::X, :query_box
-    assert_respond_to YSupport::X, :message_box
-  end
-end # describe "y_support/x"