inverse_methods 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b107057c14015315b7c09b3d9c342f848b50eb57
-  data.tar.gz: ed2ed1c3b559bdb011d15841d1040b95b2236b13
+  metadata.gz: 3a00cfd4c5c28a08d41837a2281cd898397de830
+  data.tar.gz: 57b9ef38aa446c7b34cafb8ddabd7085295ad30e
 SHA512:
-  metadata.gz: '0702282f19a800fe6ce2d0cb3dccfac7c16ab26fcc113828932de87fb81b00ca25aadf6d52ce7ad3642e99d97852033b083294037e9e8aecbc109c8ae5d82fdd'
-  data.tar.gz: dff2fcb76a39d5d6e63748c5465d171dd0241d8ea23a5bfa7692beb0f2f50501d833979dcf50112a4a78400fd91ff8484223f93f9b9c91af1c8e1bdfdce3ff18
+  metadata.gz: 0f21f8419c2e40b9bd5bccd0584dfb942b59ca41f14023297a00ec3bda19aaf96113a19e64df3fe3480c6490baa4f3ec4741937df6fb37f412971ab4cbd87ef3
+  data.tar.gz: 7bc2cd0367f58c1ed88872c58993ec258eecfdef9383b89a86887a4473eb921a6fc63e2a2a7dc8dc666f384c00a84246fa5106bfce39a7577a0e36148b3b5ea4

data/lib/inverse_methods.rb

@@ -8,13 +8,16 @@ EvalProc = ->(sym, argument, context){
 module InverseMethods
 
   def pass_to(*syms)
+    syms = syms[0] if syms[0].is_a?(Array)
     RubyVM::DebugInspector.open { |inspector|
       caller_context = inspector.frame_binding(2)
       syms.each { |sym| EvalProc.call(sym, self, caller_context) }
     }
+    self
   end
 
   def chain_to(*syms)
+    syms = syms[0] if syms[0].is_a?(Array)
     RubyVM::DebugInspector.open { |inspector|
       caller_context = inspector.frame_binding(2)
       initial_result = EvalProc.call syms.shift, self, caller_context

data/lib/version.rb

@@ -1,3 +1,3 @@
 module InverseMethods
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 end

data/readme.md

@@ -1,3 +1,18 @@
+### Install
+
+`gem install inverse_methods`
+`require 'inverse_methods'`
+
+## Accessing methods
+
+There is a single module `InverseMethods` which can be included where it's needed or patched on `Object` for global access.
+
+To load it globally, use `Object.include InverseMethods`. Or use a more specific scope such as `MyClass.include InverseMethods` or `MyClass.extend InverseMethods`.
+
+It can be used as a refinement: `using InverseMethods`.
+
+### Explanation
+
 Two methods which can be added on Object:
 
 Both use `debug_inspector` to do some stuff with Ruby that wouldn't otherwise be possible.
@@ -5,15 +20,18 @@ Both use `debug_inspector` to do some stuff with Ruby that wouldn't otherwise be
 `pass_to` is kind of like a reverse tap. It still works as a "tap" (it returns the caller) but takes arguments differently:
 
     foo = []
-    1.pass_to *%i{ foo.push foo.push }
+    1.pass_to %i{ foo.push foo.push }
+    # => 1
     puts foo # => [1,1]
 
 The caller is being passed as an argument (serialized using `Marshal.dump`), and the symbols in the list are methods which it is passed to. They are evaluated in the caller context, which is why the local variable `foo` can be referenced.
 
+The method names passed to `pass_to` are not chained. This is why `[1,1]` was returned instead of `[1, [...]]` (the three dots being a recursive reference). The `foo.push 1` calls happen independently of one another.  
+
 The above example, if modified like so, wouldn't work:
 
     foo = []
-    1.pass_to :foo.push :foo.push
+    1.pass_to [:foo.push, :foo.push]
     puts foo
 
 The reason is that `:foo.push` is a `SyntaxError`. It needs to be written as `:"foo.push"`, which the `%i{ array.of symbols }` shorthand would do automatically.
@@ -21,7 +39,7 @@ The reason is that `:foo.push` is a `SyntaxError`. It needs to be written as `:"
 The second method is `chain_to`, which is perhaps the 'functional programming' alternative to `pass_to` (and `tap`, which it's based on). It works similarly:
 
     foo = []
-    [1].chain_to *%i{[0].concat [2].concat}
-    puts foo # => [0,1,2]
+    [1].chain_to %i{[2].concat [3].concat}
+    puts foo # => [3,2,1]
 
-Only the first symbol (`:"[].concat"`) gets the original argument, `[1]`, passed when evaluated. The next symbol `:"[2].concat"` gets the first evaluation's result (`[0, 1]`) passed.
+Only the first symbol (`:"[2].concat"`) gets the original argument, `[1]`, passed when evaluated. The next symbol `:"[3].concat"` gets the first evaluation's result (`[2, 1]`) passed.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inverse_methods
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - maxpleaner
@@ -55,7 +55,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 2.5.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.6.11
 signing_key: 
 specification_version: 4
 summary: two added methods on Object