much-plugin 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: baebd1ccaff9c505af4deac64f758ccad4a5f41a8bc5e94ad3fd3bdcc6a6a8cb
-  data.tar.gz: 8da8eca30eb1766bb3d3c5b0beab9a271a0b27ac7c2d281d169b0f7b4be0110f
+  metadata.gz: fbaad5b7dab33dc311e475f220cfbfc341f7def78de5fbf58d0f73b1663d6824
+  data.tar.gz: 6fad28bbd725bd87257f6c6e60e9cce2467a0f5ae5ab81b4030b7c266a419abd
 SHA512:
-  metadata.gz: 66e7398810226de3fda5cc76e8c298f15a8e38b1b56647e6abd9751c9469fd2f2919fbfd668747807e68b274304ecc3f08035c0341c596abcf2a45458cb2d56f
-  data.tar.gz: dbdaf8782afdad32471fdf75eba18e7ac05f1dc423167808fdb4794ae1c2a3cf924d2009685fcaf353c74fc15bcc519d660f351c302c2072de2223e827f9078f
+  metadata.gz: b2fce8bb616549534a12f8532dcf4efcc23306ea1cfba943ec7360c7ee07645fef72ac412e983369685c6df477c51f3be04c0b583b3a7357a6db026db6c7858f
+  data.tar.gz: 4321146b24ba6f7cdebecfa094f63bb3244996188df4d03b609a14c1cbc876cb3f06dc8d747ca1256aae0c7ba077ba3b68b7197c851fe86dae0639d11de1a11b

data/Gemfile

@@ -2,7 +2,7 @@ source "https://rubygems.org"
 
 gemspec
 
-gem 'pry', "~> 0.9.0"
+gem "pry", "~> 0.12.2"
 
 # to release, uncomment this and run `bundle exec ggem r -f`
 gem 'ggem'

data/README.md

@@ -45,6 +45,28 @@ module MyPluginMixin
 end
 ```
 
+### `after_plugin_included`
+
+These hooks work just like the `plugin_included` hooks, except they are evaluated _after_ any plugin class/instance methods have been evaluated. E.g. use this to call a class method that the plugin defines.
+
+```ruby
+requre "much-plugin"
+
+module MyPluginMixin
+  include MuchPlugin
+
+  after_plugin_included do
+    configure_the_plugin
+  end
+
+  plugin_class_methods do
+    def configure_the_plugin
+      # ...
+    end
+  end
+end
+```
+
 ## Example
 
 ```ruby

data/lib/much-plugin.rb

@@ -26,6 +26,10 @@ module MuchPlugin
         self.much_plugin_instance_methods_module.class_eval(&block)
       end
       plugin_receiver.send(:include, self.much_plugin_instance_methods_module)
+
+      self.much_plugin_after_included_blocks.each do |block|
+        plugin_receiver.class_eval(&block)
+      end
     end
 
     # the included detector is an empty module that is only used to detect if
@@ -55,6 +59,10 @@ module MuchPlugin
       @much_plugin_included_blocks ||= []
     end
 
+    def much_plugin_after_included_blocks
+      @much_plugin_after_included_blocks ||= []
+    end
+
     def much_plugin_class_method_blocks
       @much_plugin_class_method_blocks ||= []
     end
@@ -67,6 +75,10 @@ module MuchPlugin
       self.much_plugin_included_blocks << block
     end
 
+    def after_plugin_included(&block)
+      self.much_plugin_after_included_blocks << block
+    end
+
     def plugin_class_methods(&block)
       self.much_plugin_class_method_blocks << block
     end

data/lib/much-plugin/version.rb

@@ -1,3 +1,3 @@
 module MuchPlugin
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

data/much-plugin.gemspec

@@ -18,6 +18,6 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
 
-  gem.add_development_dependency("assert", ["~> 2.17.0"])
+  gem.add_development_dependency("assert", ["~> 2.18.1"])
 
 end

data/test/unit/much-plugin_tests.rb

@@ -13,7 +13,7 @@ module MuchPlugin
     subject{ @plugin }
 
     should have_imeths :much_plugin_included_detector, :much_plugin_included_blocks
-    should have_imeths :plugin_included
+    should have_imeths :plugin_included, :after_plugin_included
 
     should "know its included detector" do
       mixin = subject.much_plugin_included_detector
@@ -25,6 +25,7 @@ module MuchPlugin
 
     should "have no plugin included blocks by default" do
       assert_empty subject.much_plugin_included_blocks
+      assert_empty subject.much_plugin_after_included_blocks
     end
 
     should "append blocks" do
@@ -44,17 +45,21 @@ module MuchPlugin
         def self.block1_count; @block1_count ||= 0; end
         def self.inc_block2;   @block2_count ||= 0; @block2_count += 1; end
         def self.block2_count; @block2_count ||= 0; end
+
+        def self.do_something_count; @do_something_count ||= 0; end
       end
     end
 
     should "call the plugin included blocks" do
       assert_equal 0, @receiver.block1_count
       assert_equal 0, @receiver.block2_count
+      assert_equal 0, @receiver.do_something_count
 
       @receiver.send(:include, TestPlugin)
 
       assert_equal 1, @receiver.block1_count
       assert_equal 1, @receiver.block2_count
+      assert_equal 1, @receiver.do_something_count
     end
 
     should "call blocks only once no matter even if previously mixed in" do
@@ -62,11 +67,13 @@ module MuchPlugin
 
       assert_equal 1, @receiver.block1_count
       assert_equal 1, @receiver.block2_count
+      assert_equal 1, @receiver.do_something_count
 
       @receiver.send(:include, TestPlugin)
 
       assert_equal 1, @receiver.block1_count
       assert_equal 1, @receiver.block2_count
+      assert_equal 1, @receiver.do_something_count
     end
 
     should "call blocks only once even if mixed in by a 3rd party" do
@@ -79,23 +86,37 @@ module MuchPlugin
 
       assert_equal 1, @receiver.block1_count
       assert_equal 1, @receiver.block2_count
+      assert_equal 1, @receiver.do_something_count
 
       @receiver.send(:include, TestPlugin)
 
       assert_equal 1, @receiver.block1_count
       assert_equal 1, @receiver.block2_count
+      assert_equal 1, @receiver.do_something_count
 
       @receiver.send(:include, third_party)
 
       assert_equal 1, @receiver.block1_count
       assert_equal 1, @receiver.block2_count
+      assert_equal 1, @receiver.do_something_count
     end
 
-    TestPlugin = Module.new do
-      include MuchPlugin
-
-      plugin_included{ inc_block1 }
-      plugin_included{ inc_block2 }
-    end
+    TestPlugin =
+      Module.new do
+        include MuchPlugin
+
+        plugin_included{ inc_block1 }
+        after_plugin_included{
+          inc_block2
+          do_something
+        }
+
+        plugin_class_methods do
+          def do_something
+            @do_something_count ||= 0
+            @do_something_count += 1
+          end
+        end
+      end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: much-plugin
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Kelly Redding
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-09-03 00:00:00.000000000 Z
+date: 2020-06-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: assert
@@ -17,14 +17,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.17.0
+        version: 2.18.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.17.0
+        version: 2.18.1
 description: An API to ensure mixin included logic (the "plugin") only runs once.
 email:
 - kelly@kellyredding.com
@@ -66,8 +66,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: An API to ensure mixin included logic (the "plugin") only runs once.