y_support 2.0.42 → 2.0.43

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a7a8d4d02757ef3f1d47a1093c04274fd462d890
-  data.tar.gz: 66d1c435eb4091ce1b749899af392aaa718c241a
+  metadata.gz: a7f4a0b0a8c590f42dd23407f86cccce3ea0b95b
+  data.tar.gz: 2cb43420440e01d7932a373aa197204f3b7115d3
 SHA512:
-  metadata.gz: 57036903f19cab0194e726943b98dec0d2becb6808ac26f1593097949e6e9c49aadc0a2a3149e0737b8dc03c88134512953d980ac89a53dd18df74c5f1e8836e
-  data.tar.gz: 63801b791d327a8f3b9f894c8659be66f8f4bc10e7376ebffb6e1d5666314106d803ad5ed384fe0574ffd40530422c960e1c1e9df1730d88755dab94e6a1892e
+  metadata.gz: 13398ec84e28cd5fdda66ccd6b040f403129a74ddc88cb3b91a264117e08a0469cba1e0006cc5d03c541e697fb17b60c41248fb711b26a9ab0a240a21c08467b
+  data.tar.gz: 5e3031f03fd0de7d043ace4d4b7e5c7a1f1a04ae042f6869c14bfa1e67776035efe804dd9ade11c999f441bf10c2f1a6856ca8b610f44509d4fcc257c3238a98

data/README.md

@@ -5,7 +5,8 @@
 helpful methods, which can be divided as follows
 
   * `NameMagic` (`lib/name_magic.rb`) -- its main feature is that it allows
-    constant magic known from classes to work with any objects.
+    constant magic so well known from Ruby classes (`Foo = Class.new;
+    Foo.name #=> "Foo"`) to work with any objects.
   * Miscellaneous helpful methods (`lib/misc.rb`)
   * Typing (runtime assertions, `lib/typing.rb`)
   * Other smaller components:
@@ -16,7 +17,17 @@ helpful methods, which can be divided as follows
 
 ## NameMagic
 
-Try for example:
+Ruby classes are well known for their "constant magic": When they are assigned
+to constants, they acquire `name` attribute corresponding to the constant name.
+```ruby
+  x = Class.new
+  x.name #=> nil
+  Foo = x
+  x.name #=> "Foo"
+```
+NameMagic mixin lends this feature to any Ruby class. The class in which
+NameMagic is mixed in will also hold the registry of the instances, named or
+unnamed. Example code:
 ```ruby
   require 'y_support/name_magic'
 
@@ -30,16 +41,20 @@ Try for example:
   class Cat < Animal; def sound; "meow" end end
 
   Pochi = Dog.new
-  unnamed_kitten = Cat.new
+  anonymous_kitten = Cat.new
 ```
 Mixin `NameMagic` makes class `Animal` keep registry of its instances:
 ```ruby
   Animal.instances.names
   #=> [:Pochi, nil]
-  Tama = unnamed_kitten
+  Tama = anonymous_kitten
   Animal.instances.names
   #=> [:Pochi, :Tama]
-  Cheburashka = Animal.new
+  # Name can also be supplied to the constructor explicitly:
+  Animal.new name: :Cheburashka
+  Animal.instance( "Cheburashka" )
+  Animal.instance( "Cheburashka" ).name
+  :Cheburashka
   Animal.instances.names
   #=> [:Pochi, :Tama, :Cheburashka]
   Dog.instances.names
@@ -48,6 +63,14 @@ Mixin `NameMagic` makes class `Animal` keep registry of its instances:
   Dog.instances.each &:speak
   Cat.instances.each &:speak
 ```
+The registry of instances is maintained by the namespace, so the instances can
+only be garbage collected after the namespace is garbage collected. If the user
+wants to enable this earlier, the namespace can be ordered to forget them:
+```ruby
+  Animal.forget_all_instances
+  Animal.instances
+  []
+```
 
 ## Other components
 

data/lib/y_support/core_ext/array/misc.rb

@@ -3,20 +3,24 @@
 require 'matrix'
 
 class Array
-  # This would collide with built-in #to_hash method.
+  # Converts an array, whose elements are also arrays, to a hash. Head
+  # (position 0) of each array is made to point at the rest of the array
+  # (tail), normally starting immediately after the head (position 1). The
+  # starting position of the tail can be controlled by an optional
+  # argument. Tails of 2 and more elements are represented as arrays.
   # 
-  # # Converts an array, whose elements are also arrays, to a hash. Head
-  # # (position 0) of each array is made to point at the rest of the array
-  # # (tail), normally starting immediately after the head (position 1). The
-  # # starting position of the tail can be controlled by an optional
-  # # argument. Tails of 2 and more elements are represented as arrays.
-  # # 
-  # def to_hash( tail_from = 1 )
-  #   self.reject { | e | e[0].nil? }.reduce({}) { |a, e|
-  #     tail = e[tail_from..-1]
-  #     a.merge( { e[0] => tail.size >= 2 ? tail : tail[0] } )
-  #   }
-  # end
+  def arrays_to_hash( tail_from = 1 )
+    no_nil_heads = begin
+                     self.reject { | e | e[0].nil? }
+                   rescue NoMethodError => err
+                     raise TypeError, "The receiver must be an array of " +
+                       "arrays! (#{err})"
+                   end
+    no_nil_heads.each_with_object Hash.new do |element, memo|
+      tail = element[ tail_from .. -1 ]
+      memo.update element.first => ( tail.size > 1 ? tail : tail.first )
+    end
+  end
 
   # Zips this array with another collection into a hash. If a block is given,
   # it is applied to each element of the array to get the hash values.
@@ -39,6 +43,37 @@ class Array
     zip_to_hash collection
   end
 
+  # Assuming an array of comparable elements ordered in an ascending order,
+  # this method expects an argument comparable with the elements, and returns
+  # the nearest smaller or equal element. The second optional ordered argument,
+  # true by default, controls whether equality is OK. If set to false, then
+  # the nearest _smaller_ element is sought.
+  # 
+  def ascending_floor arg, accept_equal=true
+    idx = if accept_equal then
+            find_index { |e| e > arg }
+          else find_index { |e| e >= arg } end
+    case idx
+    when 0 then nil
+    when nil then last
+    else fetch idx - 1 end
+  end
+
+  # Assuming an array of comparable elements ordered in an ascending order,
+  # this method expects an argument comparable with the elements, and returns
+  # the neares greater or equal element. The second optional ordered argument,
+  # true by default, controls whether equality is OK. If set to false, then the
+  # nearest _greater_ element is sought.
+  # 
+  def ascending_ceiling arg, accept_equal=true
+    idx = if accept_equal then
+            find_index { |e| not e < arg }
+          else find_index { |e| not e <= arg } end
+    case idx
+    when nil then nil
+    else fetch idx end
+  end
+
   # Allows style &[ function, *arguments ]
   # 
   def to_proc
@@ -104,8 +139,6 @@ class Array
     other.map { |e| index e }
   end
 
-  # TEST ME ** FUCK OFF TESTS
-  
   # Pretty-prints the array as line, with prescribed +:precision+ and +:gap+
   # (both are named arguments).
   # 

data/lib/y_support/version.rb

@@ -1,4 +1,4 @@
 module YSupport
-  VERSION = "2.0.42"
+  VERSION = "2.0.43"
   DEBUG = false
 end

data/test/misc_test.rb

@@ -76,6 +76,13 @@ describe Array do
     require '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 ) )
@@ -85,6 +92,26 @@ describe Array 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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: y_support
 version: !ruby/object:Gem::Version
-  version: 2.0.42
+  version: 2.0.43
 platform: ruby
 authors:
 - boris
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-18 00:00:00.000000000 Z
+date: 2013-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport