mumukit-core 1.13.0 → 1.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f1171e9bc75ea6096afe03f8a30b15c32efafa0abbd2aef71f5ba96a32da23f
-  data.tar.gz: fad237169e5d66e359d831f3abe2456d42e82d2765ca821ebca8a4078357afc2
+  metadata.gz: cc881d626353e8ffa9fbd7f6710158db924bfcffd4ce3f7bed535a744d20c5e6
+  data.tar.gz: effc6a4fcd8de536ecd6eb52716d0aec3d6fe43f137d0fcd46a4f4f9c7944414
 SHA512:
-  metadata.gz: 201065bf24ae05cc63f5bd631d7949a188a9f7fdcc87fce7516375b7e9e0403d007fb274d3add8561119a73efb1d10628df75eae308e679b389de692beb38251
-  data.tar.gz: e45109ef518aa076021c23a3d04bb619b6934f6c5a05c6485373691ba88686ef07e6e99294bda722257cd26a3088a0ba30ca6ebf2ad8cd83b8b487e79b815c75
+  metadata.gz: 6f2038b0dd25424fc31c1e051bd49655a8965a0d80111a25ca351595597d6f453530850314d31a681ba52774531f62264ddd39f5b0705a2c57885ae42202e067
+  data.tar.gz: 5aac0b02e4eafea271f906400e98c0ee6dfc364edfd2de0fe3670f85e0c35741bcd987969cd1efaef0f023126159b88dc6016dc9bd486ef492b8c7e626d4b007

data/lib/mumukit/core/module.rb

@@ -6,11 +6,86 @@ class Module
     end
   end
 
-  def patch(method_name, &block)
-    method_proc = instance_method method_name
+  # Redefines a previous definition of the given method.
+  # It takes a block with the original arguments and the `hyper`
+  # reference to the original definition
+  def patch(selector, &block)
+    revamp selector do |_, this, *args, hyper|
+      this.instance_exec(*args, hyper, &block)
+    end
+  end
+
+  # `revamp` is a `patch` generalization
+  # that accepts multiple selectors and
+  # takes a more general callback, like the following:
+  #
+  # ```
+  # revamp :foo, :bar do |selector, this, *args, hyper|
+  #   puts "sending #{selector} to #{this}..."
+  #   result = hyper.call(*args)
+  #   puts "done. result is #{result}"
+  #   result
+  # end
+  # ```
+  #
+  # `revamp` should be prefered to `patch` when more control or performance
+  # is required
+  def revamp(*selectors, selector_transformer: nil, &block)
+    selectors.each do |selector|
+      method_proc = instance_method selector
+      selector_transfom = selector_transformer ? selector_transformer.call(selector) : selector
+
+      define_method selector do |*args|
+        block.call(selector_transfom, self, *args, method_proc.bind(self))
+      end
+    end
+  end
+
+  # Revamps an accessor. This method is similar to `revamp`,
+  # but:
+  #
+  #  * assumes a 0 arguments array
+  #  * takes the accessor's original result instead of the `hyper` reference
+  #
+  # As a consecuence, `revamp_accessor` can not alter the way and the moment
+  # the original method is evaluated.
+  #
+  # ```
+  # revamp_accessor :foo, :bar do |selector, this, result|
+  #   puts "result of sending #{selector} to #{this} is #{result}"
+  #   result
+  # end
+  # ```
+  #
+  # :warning: the block will not be called on a `nil` result
+  def revamp_accessor(*selectors, &block)
+    revamp(*selectors) do |selector, this, hyper|
+      result = hyper.call
+      result && block.call(selector, this, result)
+    end
+  end
 
-    define_method method_name do |*args|
-      instance_exec(*args, method_proc.bind(self), &block)
+  # Caches an accessor, using the idiom `@__foo__ ||= foo`. For example, the following code:
+  #
+  # ```
+  # def foo
+  #   @__foo__ ||= #...implementation...
+  # end
+  # ```
+  #
+  # Can be turned into:
+  #
+  # ```
+  # def foo
+  #   #...implementation...
+  # end
+  #
+  # cache_accessor :foo
+  # ```
+  #
+  def cache_accessor(*selectors)
+    revamp(*selectors, selector_transformer: proc { |it| "@__#{it}__".to_sym }) do |attr_name, this, hyper|
+      this.instance_variable_get(attr_name) || this.instance_variable_set(attr_name, hyper.call)
     end
   end
 end

data/lib/mumukit/core/version.rb

@@ -1,5 +1,5 @@
 module Mumukit
   module Core
-    VERSION = '1.13.0'
+    VERSION = '1.14.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mumukit-core
 version: !ruby/object:Gem::Version
-  version: 1.13.0
+  version: 1.14.0
 platform: ruby
 authors:
 - Franco Leonardo Bulgarelli
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-24 00:00:00.000000000 Z
+date: 2019-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -186,8 +186,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.8
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Ruby core extensions for mumuki on top of active support