y_support 2.5.2 → 2.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ee5ad7ff95e53cc6726095f24b26a862b4da6eb6
-  data.tar.gz: 596a5b7d77c3b777091fd49ca219857ced62a7e3
+  metadata.gz: 45dd9eb80e6817e7e37732c09782c38da5de8ab0
+  data.tar.gz: 66d6e1d35bc5d809506d39a79513498ffce83e68
 SHA512:
-  metadata.gz: 95135218b6dff384f1dce606e26e359e15ab8154051d1384645a49dacf795a728f2731eaac966dee1b174268319dd936df410e2b6734f8163a4f1e94c00f1af0
-  data.tar.gz: 8dac0826c19777545ba983b317ecaf513b6f018b7665c21d7d46d1f585e17dfcc2f3d4f7b9046b6d8a7a4a6d6ff8a7952f1843f88c3a5f481bbb018801c45045
+  metadata.gz: 9226a106d85dfbc113bad61619b2a8dddb9af15957e8e1283cbc74ecb54a5af12d5016c73e434f9b23d32868c2527751fb58f2217af31675fece6f0e0e3d0a48
+  data.tar.gz: dd21b15c30466bce72b0a7715194574862b4179fd080fa7085a9ded206ff37c3843d234bfd0dfea82f47bb240b5af8dd35240f98599135ac7bda937073e1f969

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

@@ -4,49 +4,52 @@ require File.dirname( __FILE__ ) + '/../module'
 require File.dirname( __FILE__ ) + '/../class'
 
 class Object
-  # Assigns prescribed atrributes to the object and makes them accessible with
-  # getter (reader) methods. Raises NameError should any of the getters shadow /
-  # overwrite existing methods.
+  # Assigns atrributes to the receiver object and makes them
+  # accessible via reader methods (aka. getter or selector
+  # methods). Raises `NameError` in case of name collisions with
+  # existing methods of the receiver object.
   # 
   def set_attr_with_readers hash
     hash.each_pair { |ß, value|
-      fail NameError, "Method \##{ß} already defined!" if methods.include? ß
+      fail NameError, "Method \##{ß} already defined on " \
+        "#{self}! Use #set_attr_with_readers! to overload " \
+        "preexisting methods." if methods.include? ß
       set_attr_with_readers! ß => value
     }
   end
+  alias set_attr_with_selectors set_attr_with_readers
 
-  # Like +#set_attr_with_readers+, but it overloads existing methods, if present.
-  # Whereas +#set_attr_with_readers+ guards against the presence of methods with
-  # the same name, +#set_attr_with_reader!+ overloads them in the following way:
-  #
-  # * Colliding instance method defined in the singleton class of the receiver
-  #   is overwritten (redefined).
-  # * Colliding instance methods defined on the receiver's class ancestors are
-  #   overloaded (partially shadowed). If the method message is sent without
-  #   arguments or block, the reader activates and returns the corresponding
-  #   instance variable regardless of what the behavior of the shadowed method
-  #   might have been. However, if the method message is sent with arguments
-  #   or block, the original method is invoked (via +super+) and its result
-  #   returned.
+  # Like +#set_attr_with_readers+, but overloads existing methods
+  # if their names collied with the attributes to be set.
+  # Overloading is performed in the following way: If the attribute
+  # reader is called without parameters, it acts as an attribute
+  # reader (as expected). If the user tries to invoke the attribute
+  # method with parameters (or a block), the message falls through
+  # to the colliding instance method. In this way, both methods
+  # are preserved -- collision only happens if the colliding
+  # method took no parameters.
   # 
   def set_attr_with_readers! hash
     hash.each_pair { |ß, value|
+      # puts "Setting @#{ß} of #{self} to #{value}."
       instance_variable_set "@#{ß}", value
       singleton_class.class_exec do
         define_method ß do |*args, &block|
-          return instance_variable_get "@#{ß}" if args.empty? && block.nil?
+          return instance_variable_get "@#{ß}" if
+            args.empty? && block.nil?
           super *args, &block
         end
       end
     }
   end
 
-  # Constructs heir classes (parametrized subclasses) of the supplied modules
-  # (classes) and makes them available under specified getters. Expects a hash of
-  # pairs { symbol: class }, and a hash of parameters with which to parametrize
-  # the modules (classes). The methods guards against collisions in the subclass
-  # getter symbols, rasing +NameError+ should these shadow or overwrite existing
-  # methods.
+  # Constructs heir classes (parametrized subclasses) of the
+  # supplied modules (classes) and makes them available under
+  # specified getters. Expects a hash of pairs { symbol: class },
+  # and a hash of parameters with which to parametrize the modules
+  # (classes). The methods guards against collisions in the
+  # subclass getter symbols, rasing +NameError+ should these shadow
+  # or overwrite existing methods.
   # 
   def param_class( hash, with: {} )
     hash.each { |ß, m|
@@ -63,9 +66,10 @@ class Object
     return nil
   end
 
-  # Like +#param_class+, but it shadows or overwrites existing methods colliding
-  # with the getters of the parametrized classes. See +#set_attr_with_readers!"
-  # for full explanation of the shadowing / overwriting behavior.
+  # Like +#param_class+, but it shadows or overwrites existing
+  # methods colliding with the getters of the parametrized
+  # classes. See +#set_attr_with_readers!"  for full explanation of
+  # the shadowing / overwriting behavior.
   # 
   def param_class!( hash, with: {} )
     hash.each { |ß, m|
@@ -81,4 +85,26 @@ class Object
     }
     return nil
   end
+
+  # New syntax for #param_class method for creating parametrized
+  # subclasses.
+  #
+  def owns_subclass( name, of:, parametrized_by: {},
+                    named: proc do |**params|
+                      param_str = params.empty? ? "" :
+                                    "[#{params.pretty_print}]"
+                      "#{name}#{param_str}>"
+                    end,
+                    overwrite_existing_methods: true )
+    if overwrite_existing_methods then
+      param_class!( { name => of }, with: parametrized_by )
+    else
+      param_class( { name => of }, with: parametrized_by )
+    end
+    # FIXME: This method cannot stay like this. It is not possible
+    # for has_subclass method expecting a single class to subclass
+    # to rely on param_class method which is intended for multiple
+    # classes. Simplify simplify simplify. And change that SO
+    # answer when done.
+  end
 end

data/lib/y_support/version.rb

@@ -1,4 +1,4 @@
 module YSupport
-  VERSION = "2.5.2"
+  VERSION = "2.5.3"
   DEBUG = false
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: y_support
 version: !ruby/object:Gem::Version
-  version: 2.5.2
+  version: 2.5.3
 platform: ruby
 authors:
 - boris
@@ -163,4 +163,3 @@ test_files:
 - test/name_magic_test.rb
 - test/typing_test.rb
 - test/unicode_test.rb
-has_rdoc: