around_the_world 0.23.3 → 0.23.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fafff3aedd6efd98d5114af5c4910af0aca7252bea80091382dab3fe7c7bd5fb
-  data.tar.gz: 6038aa1b445beebd7a066397838f7600999be195c34e8580869f5810eaeb6204
+  metadata.gz: 23a890fe677d896aa33ac95d8566e8471077ea8da13b1e1cfd1f31f86ba6b6c7
+  data.tar.gz: a5b921005580bfad7decdb3473494e13f39db5fc1a47311caa230a69d1a19bbf
 SHA512:
-  metadata.gz: 586d9126b97c271775160d21d21bbb6384e63e33eca890bf8ccc83b2547edd25db4281832e2543bdb5610f6707e716d909d58826e84a60fcf2470b3da462f57d
-  data.tar.gz: f4e9d6ff94769138dcf6b4b0c8424472bc094171c8d2a4d65b5cbc44ecfd5f7d6581751808ff9f491953643244bfc0430e5235595035df6795f23f4ce5398d24
+  metadata.gz: c7bef9bce830d89210ac4634ff63697357c83a7707443b0e29f128046bfecbab567785c0d6dadc990b91df077dda90972ac6beb6874f5cdea324b8ee97f14f66
+  data.tar.gz: 00ad4983a51f3e5f987c10baeea406acd4936d6ba5bb34e2f980792a8a5fe47a418b4f0c40dbbfa91fdfa29343cda4423acc937c111968a8e796b612785f2d4a

data/README.md

@@ -40,12 +40,20 @@ Define a method that gets called _around_ the given instance method:
 class SomeClass
   include AroundTheWorld
 
+  def make_something_happen!
+    @something_happened = true
+  end
+  
   def did_something_happened?
-    true
+    !!@something_happened
   end
-
-  around_method :did_something_happened? do |*args, **opts|
-    things_happened = super(*args, **opts)
+  
+  around_method :make_something_happen!, :did_something_happened? do |*args| # use |...| for ruby 2.7+
+    # For Ruby <= 2.6:
+    things_happened = super(*args)
+    
+    #Or, for Ruby <= 2.7:
+    things_happened = super(...)
 
     if things_happened
       "Something happened!"
@@ -57,6 +65,12 @@ end
 ```
 
 ```
+> SomeClass.new.did_something_happened?
+=> "Nothing to see here..."
+
+> SomeClass.new.make_something_happen!
+=> "Something happened!"
+
 > SomeClass.new.did_something_happened?
 => "Something happened!"
 ```
@@ -72,12 +86,12 @@ class SomeClass
     "method behavior"
   end
 
-  around_method :some_method, prevent_double_wrapping_for: :memoization do |*args, **opts|
-    @memoized ||= super(*args, **opts)
+  around_method :some_method, prevent_double_wrapping_for: :memoization do |...|
+    @memoized ||= super(...)
   end
 
-  around_method :some_method, prevent_double_wrapping_for: :memoization do |*args, **opts|
-    @memoized ||= super(*args, **opts)
+  around_method :some_method, prevent_double_wrapping_for: :memoization do |...|
+    @memoized ||= super(...)
   end
 end
 ```
@@ -98,8 +112,8 @@ class SomeClass
 
     def a_singleton_method; end
 
-    around_method :a_singleton_method do |*args, **opts|
-      super(*args, **opts)
+    around_method :a_singleton_method do |...|
+      super(...) # See above for ruby <= 2.6 syntax
 
       "It works for class methods too!"
     end

data/lib/around_the_world.rb

@@ -23,9 +23,13 @@ module AroundTheWorld
     #
     # @example
     #   class SomeClass
-    #     around_method :dont_look_in_here do |*args, **opts|
-    #       things_happened = super(*args, **opts)
-    #
+    #     around_method :make_something_happen!, :did_something_happened? do |*args| # use |...| for ruby 2.7+
+    #       # For Ruby <= 2.6:
+    #       things_happened = super(*args)
+
+    #       #Or, for Ruby <= 2.7:
+    #       things_happened = super(...)
+
     #       if things_happened
     #         "Something happened!"
     #       else
@@ -42,19 +46,19 @@ module AroundTheWorld
     #   => "Something happened!"
     #
     # @example
-    #   around_method :dont_look_in_here, prevent_double_wrapping_for: :memoization do |*args, **opts|
-    #     @memoized ||= super(*args, **opts)
+    #   around_method :dont_look_in_here, prevent_double_wrapping_for: :memoization do |...|
+    #     @memoized ||= super(...)
     #   end
     #
-    #   around_method :dont_look_in_here, prevent_double_wrapping_for: :memoization do |*args, **opts|
-    #     @memoized ||= super(*args, **opts)
+    #   around_method :dont_look_in_here, prevent_double_wrapping_for: :memoization do |...|
+    #     @memoized ||= super(...)
     #   end
     #   # => AroundTheWorld::DoubleWrapError:
     #          "Module AroundTheWorld:ProxyModule:memoization already defines the method :dont_look_in_here"
     #
-    #   around_method :dont_look_in_here do |*args, **opts|
+    #   around_method :dont_look_in_here do |...|
     #     do_something_else
-    #     super(*args, **opts)
+    #     super(...)
     #   end
     #   # => no error raised
     #
@@ -65,8 +69,8 @@ module AroundTheWorld
     #     class << self
     #       def a_singleton_method; end
     #
-    #       around_method :a_singleton_method do |*args, **opts|
-    #         super(*args, **opts)
+    #       around_method :a_singleton_method do |...|
+    #         super(...)
     #         "It works for class methods too!"
     #       end
     #     end
@@ -76,19 +80,21 @@ module AroundTheWorld
     #   => "It works for class methods too!"
     #
     # @api public
-    # @param method_name [Symbol]
+    # @param method_names [Array<Symbol, String>] A list of methods to be wrapped
     # @param :prevent_double_wrapping_for [Object]
     #   If defined, this prevents wrapping the method twice for a given purpose. Accepts any argument.
     # @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
-      )
+    def around_method(*method_names, prevent_double_wrapping_for: nil, allow_undefined_method: false, &block)
+      method_names.each do |method_name|
+        MethodWrapper.wrap(
+          method_name: method_name,
+          target: self,
+          prevent_double_wrapping_for: prevent_double_wrapping_for,
+          allow_undefined_method: allow_undefined_method,
+          &block
+        )
+      end
     end
   end
 end

data/lib/around_the_world/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: around_the_world
 version: !ruby/object:Gem::Version
-  version: 0.23.3
+  version: 0.23.8
 platform: ruby
 authors:
 - Allen Rettberg
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-27 00:00:00.000000000 Z
+date: 2020-06-09 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.23.3
+  documentation_uri: https://www.rubydoc.info/gems/around_the_world/0.23.8
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -63,7 +63,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Allows you to easily wrap methods with custom logic on any class