around_the_world 0.22.3.1 → 0.22.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d47dda2b6885706b13d013c72a336308128624438d92ba65fadc80f4a37082f
-  data.tar.gz: 8786045a2b7bc0fdc8f131d650236c75c61d9367a58f392ce18f7bb961608a3f
+  metadata.gz: d57efe8236b3276024f645121baabaaae3ab8bd5cf6c44a66e3581d4cc165b3d
+  data.tar.gz: 1666143f74d1fa5b4b71ba11cde97a560c21c7105cdfa99dde608383b567f420
 SHA512:
-  metadata.gz: ba980c40022b0f16ed6c81464c20237b598c7915a83e243b6c26a38f4f959aadf45777655100f557cea05c66d6ecc00aa66672a60f1aef1955307cd1070933f2
-  data.tar.gz: a4c51fc4a06e4504b5911f0fb7b92015195d3043551b380e306c74e83c6003a46ce4e2269f9b4901c1efeaec91c447df52874169b0f62dc7dfff7480c7646907
+  metadata.gz: a67f26e3d3e62a88b3d2618e2ed1caf44c244b474b0a13a4efa1012a0577d29777f7b6585d1b67ea54368b7d5882d6d74e4311038dbe29ee6754667bf27f7552
+  data.tar.gz: 6da324801843a15e4e7de05bcc3b114577e75d84c09c178f404a7ed2f70a012f30362d9870c1de9a3b587943661aae8eff4335b12378148abb4193fcabbd90b3

data/lib/around_the_world.rb

@@ -1,12 +1,13 @@
 # frozen_string_literal: true
 
+require "active_support/concern"
+require "active_support/core_ext/object/blank"
+require "active_support/descendants_tracker"
+
 require_relative "around_the_world/errors"
 require_relative "around_the_world/method_wrapper"
 require_relative "around_the_world/proxy_module"
 require_relative "around_the_world/version"
-require "active_support/concern"
-require "active_support/core_ext/object/blank"
-require "active_support/descendants_tracker"
 
 module AroundTheWorld
   extend ActiveSupport::Concern
@@ -78,11 +79,14 @@ module AroundTheWorld
     # @param method_name [Symbol]
     # @param :prevent_double_wrapping_for [Object]
     #   If defined, this prevents wrapping the method twice for a given purpose. Accepts any argument.
-    def around_method(method_name, prevent_double_wrapping_for: nil, &block)
+    # @param :allow_undefined_method [Boolean] When false, an error is raised if the wrapped method is not
+    #   explicitly defined by the target module or class. Default: false
+    def around_method(method_name, prevent_double_wrapping_for: nil, allow_undefined_method: false, &block)
       MethodWrapper.wrap(
         method_name: method_name,
         target: self,
         prevent_double_wrapping_for: prevent_double_wrapping_for,
+        allow_undefined_method: allow_undefined_method,
         &block
       )
     end

data/lib/around_the_world/method_wrapper.rb

@@ -23,14 +23,17 @@ module AroundTheWorld
     #   An identifier to define the proxy module's purpose in the ancestor tree.
     #   A method can only be wrapped once for a given purpose, though it can be wrapped
     #   again for other purposes, or for no given purpose.
+    # @param :allow_undefined_method [Boolean] When false, an error is raised if the wrapped method is not
+    #   explicitly defined by the target. Default: false
     # @block The block that will be executed when the method is invoked.
     #        Should always call super, at least conditionally.
-    def initialize(method_name:, target:, prevent_double_wrapping_for: nil, &block)
+    def initialize(method_name:, target:, prevent_double_wrapping_for: nil, allow_undefined_method: false, &block)
       raise TypeError, "target must be a module or a class" unless target.is_a?(Module)
 
       @method_name = method_name.to_sym
       @target = target
       @prevent_double_wrapping_for = prevent_double_wrapping_for || nil
+      @allow_undefined_method = allow_undefined_method
       @block = block
     end
 
@@ -45,13 +48,14 @@ module AroundTheWorld
 
     private
 
-    attr_reader :prevent_double_wrapping_for, :block
+    attr_reader :prevent_double_wrapping_for, :allow_undefined_method, :block
 
     def prevent_double_wrapping?
       prevent_double_wrapping_for.present?
     end
 
     def ensure_method_defined!
+      return if allow_undefined_method
       return if target.instance_methods(true).include?(method_name) || target.private_method_defined?(method_name)
 
       raise MethodNotDefinedError, "#{target} does not define :#{method_name}"

data/lib/around_the_world/version.rb

@@ -2,5 +2,5 @@
 
 module AroundTheWorld
   # This constant is managed by spicerack
-  VERSION = "0.22.3.1"
+  VERSION = "0.22.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: around_the_world
 version: !ruby/object:Gem::Version
-  version: 0.22.3.1
+  version: 0.22.4
 platform: ruby
 authors:
 - Allen Rettberg
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-05 00:00:00.000000000 Z
+date: 2020-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -47,7 +47,7 @@ metadata:
   homepage_uri: https://github.com/Freshly/spicerack/tree/master/around_the_world
   source_code_uri: https://github.com/Freshly/spicerack/tree/master/around_the_world
   changelog_uri: https://github.com/Freshly/spicerack/blob/master/around_the_world/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/around_the_world/0.22.3.1
+  documentation_uri: https://www.rubydoc.info/gems/around_the_world/0.22.4
 post_install_message: 
 rdoc_options: []
 require_paths: