around_the_world 0.2.5 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d0727321851d428fa841e62287b39c108fa8c18a3eedb5206785bd6ff6a59ab
-  data.tar.gz: 213a3401591f3d70fc6341d91475747d08b241420e05e24fa989e47b0095e6da
+  metadata.gz: ae037956a90fb7dd64586ff7f8b8bb1f02da897011c265881dbe071dc6f42c14
+  data.tar.gz: 1457f469d63242d427188b15506f6161260c02398519184d33b246051d5b669b
 SHA512:
-  metadata.gz: b1b20790c35b223c2499fdd542695e9283a001f6b18c38f3a9ed4eb31271e68580c09275c16f309e9281ce55213e39c87668f8f88fdd828f305313c88b77f923
-  data.tar.gz: eed8950132f53c6802892e7028b21ecff8111950e1b3c0dea61e01c3ff30c8230b848620d72fbad1926a4475412fc1e75ebee935ed7a90aeb703ff180fec9cfe
+  metadata.gz: 8e978961b7b9012e53bf9eeeda5f8efbb65bb6b4595c1585f8b89f98d0ef4a128fdfff849f3ed22bc8d5290f65a7134f85e35e4c22873e9ea5421b64c8db9349
+  data.tar.gz: 805e10ccc80702bb5dc8861c8eb7f659e7e7320159c852f4b58054389a27bb179d7b89212f27679186599211bb04a5e0aa9b1b8118e410b8da3216f0659f17eb

data/lib/around_the_world.rb

@@ -1,7 +1,67 @@
 # frozen_string_literal: true
 
-require "around_the_world/version"
+require_relative "around_the_world/version"
+require_relative "around_the_world/errors"
+require "active_support/concern"
 
 module AroundTheWorld
-  # Your code goes here...
+  extend ActiveSupport::Concern
+
+  class_methods do
+    protected
+
+    # Defines a method that gets called +around+ the given instance method.
+    #
+    # @example
+    #   class SomeClass
+    #     around_method :dont_look_in_here, "DoesAThing" do
+    #       things_happened = super
+    #
+    #       if things_happened
+    #         puts "Something happened!"
+    #       else
+    #         puts "Nothing to see here..."
+    #       end
+    #     end
+    #
+    #     def dont_look_in_here
+    #       do_some_things
+    #     end
+    #   end
+    #
+    #   SomeClass.new.dont_look_in_here
+    #   => "Something happened!"
+    #
+    # @param method_name [Symbol]
+    # @param proxy_module_name [String] The camelized name of a custom module to place the wrapper method in.
+    #                                   This is necessary to enable wrapping a single method more than once
+    #                                   since a module cannot super to itself.
+    #                                   It's recommended to name the module after what the method wrapper will do,
+    #                                   for example LogsAnEvent for a wrapper method that logs something.
+    #                                   Because of the potential for overriding previously wrapped methods, this
+    #                                   parameter is required.
+    def around_method(method_name, proxy_module_name, &block)
+      proxy_module = around_method_proxy_module(proxy_module_name)
+      ensure_around_method_uniqueness!(method_name, proxy_module)
+
+      proxy_module.define_method(method_name, &block)
+      prepend proxy_module unless ancestors.include?(proxy_module)
+    end
+
+    private
+
+    def around_method_proxy_module(proxy_module_name)
+      namespaced_proxy_module_name = "#{self}::#{proxy_module_name}"
+
+      const_set(proxy_module_name, Module.new) unless const_defined?(namespaced_proxy_module_name)
+
+      const_get(namespaced_proxy_module_name)
+    end
+
+    def ensure_around_method_uniqueness!(method_name, proxy_module)
+      return unless proxy_module.instance_methods.include?(method_name.to_sym)
+
+      raise DoubleWrapError, "Module #{proxy_module} already defines the method :#{method_name}"
+    end
+  end
 end

data/lib/around_the_world/errors.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module AroundTheWorld
+  class DoubleWrapError < StandardError; end
+end

data/lib/around_the_world/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: around_the_world
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.3.0
 platform: ruby
 authors:
 - Allen Rettberg
@@ -9,7 +9,21 @@ autorequire:
 bindir: bin
 cert_chain: []
 date: 2018-10-03 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.1.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.1.6
 description: Why metaprogram like a chump when you can do it like a champ!
 email:
 - allen.rettberg@freshly.com
@@ -20,6 +34,7 @@ files:
 - LICENSE.txt
 - README.md
 - lib/around_the_world.rb
+- lib/around_the_world/errors.rb
 - lib/around_the_world/version.rb
 homepage: https://www.freshly.com
 licenses: