proxy_method 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c657128b142fe48e200ca1f941149f68bc03554e7ad7842ee6fcc3bbf224839
-  data.tar.gz: 6fce2ccbef0015d9ccbfe279dd770e984ca64264eaec3d57e0172d50843e4486
+  metadata.gz: 8bc049207e43c67354f9411eb043f1637cfd8cfc9c96214375527d5a9b077e5b
+  data.tar.gz: b64c28b819fe354192ee34f42fde428d4f27a0274ddd4da4cff6db2e9154b3f1
 SHA512:
-  metadata.gz: d61a9a3e76e3032bf305f86453cbe147a86bbd474a31e6a2915e9a26d9a0cf79f7a87c3759b00912a8e0fa4ee3952ca06c27c748c57c613d969cf527fbabb506
-  data.tar.gz: d92c4e6f54a0f449a14f0a9156a57a7f32140703335440676727b3874221935b2fd76fbf735ed1ff39bb34966ecc74e14b51458b3c80390edda4789b6c791784
+  metadata.gz: 3a45bfc0ef058d8dd4b8a6fa24ffc2c9bbdc9abcd0b48085d59c4609cb855ee83b7a4ff8a0dc7dd9b723a1a516dbc053ccc0a08d7e0ab6ebe2bcd1c17e3f626a
+  data.tar.gz: 85098afdef7599ddfb4f910ffa56dbaa8d9b276f0fbd84a272a477603bec55904c2be03de5b432a551fa9c0833cd037666497c1742906a3da788c9bdd0e9867c

data/README.md

@@ -128,6 +128,57 @@ You can also use an unproxied version of the entire class:
     duck_unproxied.save
     # => 'saved'
 
+Run a custom block, instead of raising an exception at all. In other words, *actually* proxy the
+method! The object which is passed to the block is already unproxied, you don't have to do this
+yourself:
+
+    class MethodicalMeerkat < Animal
+      include ProxyMethod
+      
+      proxy_method(:save) do |unproxied_object|
+        "indirectly #{unproxied_object.save}!"
+      end
+    end
+    
+    MethodicalMeerkat.new.save
+    # => 'indirectly saved!'
+
+The object which is passed to the block is already unproxied, so it's free to use as you'd expect.
+
+From there, you can allow your proxied block it to be used for multiple methods:
+
+    class MethodicalMeerkat < Animal
+      include ProxyMethod
+      
+      proxy_method([:save, :update]) do |object, method_name|
+        "indirectly #{object.send(method_name)}!"
+      end
+    end
+    
+    MethodicalMeerkat.new.save
+    # => 'indirectly saved!'
+    
+    MethodicalMeerkat.new.update
+    # => 'indirectly updated!'    
+
+Provide your proxied block with args and a block of its own. The block will be given the
+unproxied object itself, followed by the standard arguments to `method_missing`, 
+so it works in much the same way.
+
+    class MethodicalMeerkat < Animal
+      include ProxyMethod
+      
+      proxy_method(:save) do |object, method_name, *args, &block|
+        "indirectly #{object.send(method_name, *args, &block)}!"
+      end
+    end
+    
+    MethodicalMeerkat.new.save
+    # => 'indirectly saved!'
+    
+    MethodicalMeerkat.new.update
+    # => 'indirectly updated!'    
+
 
 ## Installation
 Add this line to your application's Gemfile:

data/lib/proxy_method/version.rb

@@ -1,3 +1,3 @@
 module ProxyMethod
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

data/lib/proxy_method.rb

@@ -16,7 +16,7 @@ module ProxyMethod
       @_proxy_class_methods_enabled = true
     end
 
-    def proxy_class_method(original_method_names, options = {})
+    def proxy_class_method(original_method_names, options = {}, &proxy_block)
       original_method_names = Array(original_method_names)
 
       error_message = options[:raise] || DEFAULT_PROXY_MESSAGE
@@ -29,7 +29,11 @@ module ProxyMethod
         self.singleton_class.send(:alias_method, new_method_name, original_method_name)
         define_singleton_method(original_method_name) do |*args, &block|
           if proxy_class_methods_enabled?
-            raise error_message
+            if proxy_block
+              proxy_block.call(self.unproxied, original_method_name, *args, &block)
+            else
+              raise error_message
+            end
           else
             send(new_method_name, *args, &block)
           end
@@ -37,7 +41,7 @@ module ProxyMethod
       end
     end
 
-    def proxy_instance_method(original_method_names, options = {})
+    def proxy_instance_method(original_method_names, options = {}, &proxy_block)
       original_method_names = Array(original_method_names)
 
       error_message = options[:raise] || DEFAULT_PROXY_MESSAGE
@@ -51,7 +55,11 @@ module ProxyMethod
 
         define_method(original_method_name) do |*args, &block|
           if proxy_instance_methods_enabled?
-            raise error_message
+            if proxy_block
+              proxy_block.call(self.unproxied, original_method_name, *args, &block)
+            else
+              raise error_message
+            end
           else
             send(new_method_name, *args, &block)
           end
@@ -66,7 +74,7 @@ module ProxyMethod
     end
 
     def proxied
-      self.dup.proxy!
+      self.dup.reproxy!
     end
 
     def unproxy!
@@ -94,7 +102,7 @@ module ProxyMethod
   end
 
   def proxied
-    self.dup.proxy!
+    self.dup.reproxy!
   end
 
   def unproxy!

data/test/test_proxy_method.rb

@@ -62,6 +62,18 @@ class ArgumentativeAardvark < Animal
   proxy_method :blocky
 end
 
+class MethodicalMeerkat < Animal
+  include ProxyMethod
+
+  proxy_class_method(:create) do |klass, method_name, *args, &block|
+    'indirectly ' + klass.send(method_name, *args, &block) + '!'
+  end
+
+  proxy_method(:save) do |object, method_name, *args, &block|
+    'indirectly ' + object.send(method_name, *args, &block) + '!'
+  end
+end
+
 class ProxyMethodTest < MiniTest::Test
   describe "proxying class methods" do
     it "does not allow original method name to be called" do
@@ -94,6 +106,10 @@ class ProxyMethodTest < MiniTest::Test
       assert_equal "Disabled by proxy_method", exception.message
     end
 
+    it "allows an alternate block to be run instead of an exception" do
+      assert_equal 'indirectly created!', MethodicalMeerkat.create
+    end
+
     it "allows for multiple methods to be proxied in one call" do
       exception = assert_raises StandardError do
         MultiMonkey.create
@@ -190,6 +206,10 @@ class ProxyMethodTest < MiniTest::Test
       assert_equal "Disabled by proxy_method", exception.message
     end
 
+    it "allows an alternate block to be run instead of an exception" do
+      assert_equal 'indirectly saved!', MethodicalMeerkat.new.save
+    end
+
     it "allows for multiple methods to be proxied in one call" do
       exception = assert_raises StandardError do
         MultiMonkey.new.save

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: proxy_method
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Jaime Bellmyer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-12-21 00:00:00.000000000 Z
+date: 2019-12-27 00:00:00.000000000 Z
 dependencies: []
 description: |2
       The purpose of this gem is to prevent directly running the inherited