inverse_methods 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b107057c14015315b7c09b3d9c342f848b50eb57
+  data.tar.gz: ed2ed1c3b559bdb011d15841d1040b95b2236b13
+SHA512:
+  metadata.gz: '0702282f19a800fe6ce2d0cb3dccfac7c16ab26fcc113828932de87fb81b00ca25aadf6d52ce7ad3642e99d97852033b083294037e9e8aecbc109c8ae5d82fdd'
+  data.tar.gz: dff2fcb76a39d5d6e63748c5465d171dd0241d8ea23a5bfa7692beb0f2f50501d833979dcf50112a4a78400fd91ff8484223f93f9b9c91af1c8e1bdfdce3ff18

data/bin/inverse_methods

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+require 'inverse_methods'
+class InverseMethods::CLI < Thor
+  desc "test", "run tests"
+  def test
+    puts "No tests have been wrritten"
+    exit
+  end
+end
+InverseMethods::CLI.start ARGV

data/lib/inverse_methods.rb

@@ -0,0 +1,31 @@
+require 'debug_inspector'
+require 'byebug'
+
+EvalProc = ->(sym, argument, context){
+  eval %{ #{sym}(Marshal.load "#{Marshal.dump argument}") }, context
+}
+
+module InverseMethods
+
+  def pass_to(*syms)
+    RubyVM::DebugInspector.open { |inspector|
+      caller_context = inspector.frame_binding(2)
+      syms.each { |sym| EvalProc.call(sym, self, caller_context) }
+    }
+  end
+
+  def chain_to(*syms)
+    RubyVM::DebugInspector.open { |inspector|
+      caller_context = inspector.frame_binding(2)
+      initial_result = EvalProc.call syms.shift, self, caller_context
+      syms.reduce(initial_result) { |result, sym|
+        EvalProc.call sym, result, caller_context
+      }
+    }
+  end
+
+  refine Object do
+    include InverseMethods
+  end
+
+end

data/lib/version.rb

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

data/readme.md

@@ -0,0 +1,27 @@
+Two methods which can be added on Object:
+
+Both use `debug_inspector` to do some stuff with Ruby that wouldn't otherwise be possible.
+
+`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 }
+    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 above example, if modified like so, wouldn't work:
+
+    foo = []
+    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.
+
+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]
+
+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.

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: inverse_methods
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- maxpleaner
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-01-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: debug_inspector
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ''
+email: maxpleaner@gmail.com
+executables:
+- inverse_methods
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/inverse_methods
+- lib/inverse_methods.rb
+- lib/version.rb
+- readme.md
+homepage: http://github.com/maxpleaner/inverse_methods
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: two added methods on Object
+test_files: []