memery 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: '0854715beed165845002189a1574152c3f79024e'
-  data.tar.gz: 8fa7be482b75e8c37caadd35d339dbeefbb670fc
+  metadata.gz: 7bea94e1b42ea3945a0d149eb6842d0c8cd5fb9b
+  data.tar.gz: af0473e8921f36a362a37e5b4b610489b1106f75
 SHA512:
-  metadata.gz: cb9fd46d872ba116c7d69583292ae1f2a36eee6d2095d699a5790fd5aa9dde9d663f1e80b248549ff2d70b8e9e28a0c9a5f071e4b5288f68e1e84e5d3eced1bf
-  data.tar.gz: 671d518ef8430157f8f30e3ea544ef45f9e472d54a8600345d30c8a4029c2782c79c36d93985f48f17718099a9aa9c91e2a59df677319e372f9a4eae2dab4361
+  metadata.gz: d87994d56fcaa1b6cde160140b262f96e873ea4663e53e322f1de79661b8ca1c63b5cee5e52a3328245272e9b982d94ac447a01f54ce3dc0681904660ef78a69
+  data.tar.gz: f227cea7e655a3568c046d01d31e56d11dc9dc176261bf906c2b4cdf97d65f9195eb21922ef31da69e6912d59d4cb2012f7d798c44650fec725c1a2c9a7787c5

data/README.md

@@ -1,6 +1,6 @@
 # Memery
 
-Memery is a gem for memoization in Ruby. Example:
+Memery is a gem for memoization in Ruby.
 
 ## Usage
 
@@ -24,14 +24,42 @@ a = A.new
 a.call # => 42
 a.call # => 42
 a.call # => 42
-
 # Text will be printed only once.
+
+a.call { 1 } # => 42
+# Will print because passing a block disables memoization
 ```
 
 ## Difference with other gems
-Memery is very similar to [Memoist](https://github.com/matthewrudy/memoist). The difference is that it doesn't override methods, instead it uses Ruby 2 `Module.prepend` feature. This approach is cleaner and it allows subclasses' methods to work properly: if you redefine a memoized method in a subclass, it's not memoized by default, but you can memoize it normally (without using awkward `identifier: ` argument) and it will just work.
+Memery is very similar to [Memoist](https://github.com/matthewrudy/memoist). The difference is that it doesn't override methods, instead it uses Ruby 2 `Module.prepend` feature. This approach is cleaner and it allows subclasses' methods to work properly: if you redefine a memoized method in a subclass, it's not memoized by default, but you can memoize it normally (without using awkward `identifier: ` argument) and it will just work:
+
+```ruby
+class A
+  include Memery
 
-The other key difference is that it doesn't change method's signature (no extra `reload` param). If you need unmemoized result of method, just create an unmemoized version like this:
+  memoize def x(param)
+    param
+  end
+end
+
+class B < A
+  memoize def x(param)
+    super(2) * param
+  end
+end
+
+b = B.new
+b.x(1) # => 2
+b.x(2) # => 4
+b.x(3) # => 6
+
+b.instance_variable_get(:@_memery_memoized_values)
+# => {:x_70318201388120=>{[1]=>2, [2]=>4, [3]=>6}, :x_70318184636620=>{[2]=>2}}
+```
+
+Note how both method's return values are cached separately and don't interfere with each other.
+
+The other key difference is that it doesn't change method's signature (no extra `reload` param). If you need to get unmemoized result of method, just create an unmemoized version like this:
 
 ```ruby
 memoize def users
@@ -49,6 +77,14 @@ Alternatively, you can clear the whole instance's cache:
 a.clear_memery_cache!
 ```
 
+Finally, you can provide a block:
+
+```ruby
+a.users {}
+```
+
+However, this solution is kind of hacky.
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/memery.rb

@@ -38,7 +38,9 @@ module Memery
       visibility = Memery.method_visibility(self, method_name)
 
       @_memery_module.module_eval do
-        define_method(method_name) do |*args|
+        define_method(method_name) do |*args, &block|
+          return super(*args, &block) if block
+
           @_memery_memoized_values ||= {}
 
           key = [method_name, mod_id].join("_").to_sym

data/lib/memery/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Memery
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: memery
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Yuri Smirnov