mrcr-cache 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 50c58c6d0518cc3345cc446309997c0c7d05d6a4
-  data.tar.gz: cb4d12a4b0d4c035b641036027bbe1103b296d40
+  metadata.gz: 7b7da641b1029613733d14a8823c39bdbcb1abe7
+  data.tar.gz: 6b7e4013b3074502cfbace458b58937d479a5a05
 SHA512:
-  metadata.gz: 981b098fd102a8fad6daec312eebf94b1a3a05def3a0940681788f01dc071dd5a6645c8a77b1ea4c1997624b252efd3137fa999d5fc4503bf30260cc796a6946
-  data.tar.gz: dd07f013f3f072dea0a9eb9de4d937316ae3adff08d07bf6d28be972a725cad9dda3dc9a18b2ea5a4d90bfffecb8a6fa5fa31794ee9848f7da9964afa9cd2a65
+  metadata.gz: 5091c9e32958be89b49fe40c0928258476daefe273962c3598763dfdabee4904901b73afe5e96d4e155f6d826344c04c39dbc9e9bc20d9f30a25b49d3a09a892
+  data.tar.gz: 6c7741baeca70826d5c7bc265819f929a234f46c2725141646dcb55ffa6e10a24f53cd650a641673e01fe14ef060c8385b427628c04ce2e84d4440e8d6d4b679

data/README.md

@@ -1,3 +1,6 @@
+[![Gem Version](https://badge.fury.io/rb/mrcr-cache.svg)](https://badge.fury.io/rb/mrcr-cache)
+[![Build Status](https://travis-ci.org/merqlove/mrcr-cache.svg?branch=master)](https://travis-ci.org/merqlove/mrcr-cache)
+
 # Mrcr::Cache
 
 Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/mrcr/cache`. To experiment with that code, run `bin/console` for an interactive prompt.

data/lib/mrcr/cache.rb

@@ -11,7 +11,8 @@ module Mrcr
   #     extend Mrcr::Cache
   #
   #     def heavy_computation(arg1, arg2)
-  #       fetch_or_store(arg1, arg2) { arg1 ^ arg2 }
+  #       fetch_or_store(arg1) { arg1 ^ arg2 }
+  #       fetch(arg1, nil)
   #     end
   #   end
   #
@@ -45,8 +46,22 @@ module Mrcr
     #       they are always the same instances, otherwise you introduce a memory leak
     #
     # @return [Object] block's return value (cached for subsequent calls with the same argument values)
-    def fetch_or_store(*args, &block)
-      cache.fetch_or_store(args.hash, &block)
+    def fetch_or_store(key, &block)
+      cache.fetch_or_store(key.hash, &block)
+    end
+
+    # Caches a result of the block evaluation
+    #
+    # @param [Array<Object>] args List of hashable objects
+    # @yield An arbitrary block
+    #
+    # @note beware Proc instance hashes are not equal, i.e. -> { 1 }.hash != -> { 1 }.hash,
+    #       this means you shouldn't pass Procs in args unless you're sure
+    #       they are always the same instances, otherwise you introduce a memory leak
+    #
+    # @return [Object] block's return value (cached for subsequent calls with the same argument values)
+    def fetch(key, default = nil)
+      cache.fetch(key.hash, default)
     end
 
     # Instance methods
@@ -57,8 +72,19 @@ module Mrcr
       # @yield An arbitrary block
       #
       # @return [Object] block's return value
-      def fetch_or_store(*args, &block)
-        self.class.fetch_or_store(*args, &block)
+      def fetch_or_store(key, &block)
+        self.class.fetch_or_store(key, &block)
+      end
+
+      # Delegates call to the class-level method
+      #
+      # @param [Object] value List of hashable objects
+      # @param [Object] default List of hashable objects
+      # @yield An arbitrary block
+      #
+      # @return [Object] block's return value
+      def fetch(key, default = nil)
+        self.class.fetch(key, default)
       end
     end
   end

data/lib/mrcr/cache/version.rb

@@ -1,5 +1,5 @@
 module Mrcr
   module Cache
-    VERSION = '0.1.0'.freeze
+    VERSION = '0.1.1'.freeze
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mrcr-cache
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Alexander Merkulov