invokable 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: faf0947e19adf5c11f17f5893122d24aa48323807dd364593a38c391e8901c34
-  data.tar.gz: a482d9ddd514251f362c149eca16774b5b4853159eb52c79653c3f5f8df5b9ac
+  metadata.gz: f4908866aac724a3af3d142852f6412f3cc93ee7ab8c85f2dd856b08f0039c6c
+  data.tar.gz: bf5f3d83df9c69f5357eacef3bdc2ecc44384852124f4fc012fa6d3e14716cd5
 SHA512:
-  metadata.gz: 7d2b9ac66665785662b3ab016981a4c747ab32c88e637cb2bfc2a52e34ed353e5f341a5ef178582e7a3cae584576c341aa88907967cd4722acd07c2cb29d001e
-  data.tar.gz: a89620c1f7127ed27794ef84d45803cbabaf93ceee680edf80a638f4c020551fbde83b3682d8afef70597a692158b157c701d9f3c27b634e5e24476c37f81337
+  metadata.gz: f71bcec50cf1e9d0049259803eae9d5b19e102f78f14fe0854d5e2c238c3b7679552d64bb66608305c497379418f717fa29a0fe1d921c835c3397a58b37d5a47
+  data.tar.gz: 23827b487b5bb767871585d3bb641f53e8aaa4f28c1e4ef1934e93f200b7665a4a62a34f855767a7bc5424fa472ca62854021e4726b05c0901618ca119a3030c

data/Gemfile

@@ -9,3 +9,7 @@ group :development do
   gem 'pry'
   gem 'yard'
 end
+
+group :test do
+  gem 'gen-test'
+end

data/Gemfile.lock

@@ -1,18 +1,27 @@
 PATH
   remote: .
   specs:
-    invokable (0.2.2)
+    invokable (0.3.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
     coderay (1.1.2)
+    concurrent-ruby (1.1.5)
     diff-lcs (1.3)
+    faker (1.9.6)
+      i18n (>= 0.7)
+    gen-test (0.1.1)
+      faker (~> 1.9.6)
+      regexp-examples (~> 1.5.0)
+    i18n (1.8.2)
+      concurrent-ruby (~> 1.0)
     method_source (0.9.2)
     pry (0.12.2)
       coderay (~> 1.1.0)
       method_source (~> 0.9.0)
     rake (10.5.0)
+    regexp-examples (1.5.1)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
@@ -33,6 +42,7 @@ PLATFORMS
 
 DEPENDENCIES
   bundler (~> 1.17)
+  gen-test
   invokable!
   pry
   rake (~> 10.0)

data/README.md

@@ -3,9 +3,9 @@
 
 # Invokable
 
-Treat any Object, Hashes, Arrays, and Sets as Procs (like Enumerable but for Procs)
+Objects are functions! Treat any Object, Hashes, Arrays, and Sets as Procs (like Enumerable but for Procs)
 
-# Synopsis
+## Synopsis
 
 ```ruby
   require 'invokable/hash'
@@ -40,7 +40,7 @@ Treat any Object, Hashes, Arrays, and Sets as Procs (like Enumerable but for Pro
     end
   end
 
-  data_for_user = GetDataFromSomeService.new
+  data_for_user = GetDataFromSomeService.new.memoize # 'memoize' makes a proc that caches results
   User.all.map(&data_for_user)
 ```
 
@@ -54,15 +54,15 @@ require 'invokable/set'   # loads set patch
 require 'invokable/data'  # loads all patches
 ```
 
-# Why?
+## Why?
 
 A function is a mapping of one value to another with the additional constraint that for the one input value you will
 always get the same output value. So, conceptually, Ruby Hashes, Arrays, and Sets are all functions. Also, there are
 many one method objects out there (e.g. ServiceObjects) that are essentially functions. Why not treat them as such?
 
-# API
+## API
 
-## `to_proc -> Proc`
+### `to_proc => Proc`
 
 ```ruby
 hash = { a: 1, b, 2 }
@@ -76,12 +76,16 @@ returning a proc that passes it's arguments to the object's `call` method. When
 loaded `Hash#call` is mapped to `Hash#dig`, `Array#call` is mapped to `Array#at`, and `Set#call`
 is mapped to `Set#include?`.
 
-## `curry([arity]) -> Proc`
+### `curry(arity = nil) => Proc`
 
 Returns a curried proc. If the `arity` is given, it determines the number of arguments.
 (see [Proc#curry](https://ruby-doc.org/core-2.7.0/Proc.html#method-i-curry)).
 
-# Installation
+### `memoize => Proc`
+
+Returns a memoized proc, that is, a proc that caches it return values by it's arguments.
+
+## Installation
 
 Add this line to your application's Gemfile:
 
@@ -97,16 +101,15 @@ Or install it yourself as:
 
     > gem install invokable
 
-# See Also
+## See Also
 
   - [Clojure](https://clojure.org)
   - [Arc](http://www.arclanguage.org)
 
-# TODO
+## TODO
 
-  - add support for `memoize` and maybe transducers.
   - benchmark Invokable#to_proc
 
-# License
+## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/invokable.gemspec

@@ -8,7 +8,7 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Delon Newman"]
   spec.email         = ["contact@delonnewman.name"]
 
-  spec.summary       = %q{Treat any Object, Hashes, Arrays and Sets as Procs (like Enumerable but for Proc-like objects)}
+  spec.summary       = %q{Objects are functions! Treat any Object, Hashes, Arrays and Sets as Procs (like Enumerable but for Proc-like objects)}
   spec.description   = spec.summary
   spec.homepage      = "https://github.com/delonnewman/invokable"
   spec.license       = "MIT"

data/lib/invokable.rb

@@ -1,6 +1,5 @@
 require 'invokable/version'
 
-# TODO: Add memoize, transducers?
 module Invokable
   # If object responds to `call` convert into a Proc forwards it's arguments along to `call`.
   #
@@ -28,4 +27,14 @@ module Invokable
   def curry(arity = nil)
     to_proc.curry(arity)
   end
+
+  # Return a memoized proc, that is, a proc that caches it's return values by it's arguments.
+  #
+  # @return [Proc]
+  def memoize
+    Proc.new do |*args|
+      @memo ||= {}
+      @memo[args.hash] ||= call(*args)
+    end
+  end
 end

data/lib/invokable/version.rb

@@ -1,3 +1,3 @@
 module Invokable
-  VERSION = "0.2.2"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: invokable
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Delon Newman
@@ -52,8 +52,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
-description: Treat any Object, Hashes, Arrays and Sets as Procs (like Enumerable but
-  for Proc-like objects)
+description: Objects are functions! Treat any Object, Hashes, Arrays and Sets as Procs
+  (like Enumerable but for Proc-like objects)
 email:
 - contact@delonnewman.name
 executables: []
@@ -102,6 +102,6 @@ requirements: []
 rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
-summary: Treat any Object, Hashes, Arrays and Sets as Procs (like Enumerable but for
-  Proc-like objects)
+summary: Objects are functions! Treat any Object, Hashes, Arrays and Sets as Procs
+  (like Enumerable but for Proc-like objects)
 test_files: []