hidden_hooks 1.1.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c3de95afe7b03bb8fc886bb721ef7af2db8d5c8284c7aa7c0d331e33f5b5751
-  data.tar.gz: 02f901e311228c2db78c00c1d6f7cdc6e4ef4b6c56ca048c85c7976a2721170b
+  metadata.gz: 4b408f5e35a24cb32e4f5d2927174c96e10a2220c654d5a8900a89e4e2970152
+  data.tar.gz: 81f34fb4792cc92fdbbc41d5ccb0279ea423316f03cc58e806c6d3f922cc903f
 SHA512:
-  metadata.gz: 5d5c2d1346b269bd2f49a45c5cb419ad3cedd239d8f5c2c46fc6f5b95c7ccfe18d5c52f700c63e0a133f4ff81498afbca6917b1449a2e315fcef9dc1024a338f
-  data.tar.gz: f5020d12589ece606c447d45bef122fde445d4136cce36e2120cd9ed23d835615c3cab2f47de1b50d1a9b1fbe2326f97cd08e47f3a47704a3be6f37ee7706fcb
+  metadata.gz: 2d2c91bb68d8175daecb0e13beafec167bb39c88a9d1b49468d56074874912c945bd517f9a4db9bc8172e1df4640ab7b25aaf6f03921328d7d14befc9fbe3b66
+  data.tar.gz: dbdc9b528501321089404046528a6665189c95ea81f4b871ea187be3a45599b83271e60739bcbb7bbc050d782dc58e4fc3d60541d59f896ca81a8403c75cf6f4

data/CHANGELOG.md

@@ -8,6 +8,20 @@
 ### Bug fixes
 )-->
 
+## 1.2.0 2025-02-04
+
+### New features
+
+- Added the `context` keyword parameter for hooks.
+
+## 1.1.2 2025-01-28
+
+### Bug fixes
+
+- Fixed Active Record integration not setting callbacks for derived classes.
+- Removed `after_*_commit` shortcut hooks.
+  - These aren't actually callbacks, but little more than wrappers for `after_commit` itself, so the method that gets called on the callback object is always `#after_commit`, causing some weird behaviors.
+
 ## 1.1.1 2025-01-28
 
 ### Bug fixes

data/README.md

@@ -120,12 +120,44 @@ end
 
 #### Interface Declaration
 
-A class `C` declares the interface through `HiddenHooks[C]`. Calling a method on the returned proxy will call every hook that someone else defined, forwarding any argument. 
+A class `C` declares the interface through `HiddenHooks[C]`. Calling a method on the returned proxy will call every hook that someone else defined, forwarding any argument.
+
+```ruby
+class User
+  def confirm!
+    HiddenHooks[User].before_confirmation self
+    @confirmed = true
+    HiddenHooks[User].after_confirmation self
+  end
+end
+```
 
 #### Hook Definition
 
 Whenever you want to define a hook, you simply call `HiddenHooks.hook_up`. Inside the block, you can call any method and pass it a class and a block: the block will become a hook for that class.
 
+```ruby
+class Admin
+  HiddenHooks.hook_up do
+    before_confirmation User do |user|
+      Admin.first.notify! "#{user.name} is being confirmed."
+    end
+  end
+end
+```
+
+You can provide a callable `context`, which will be invoked with the same parameters as the hook. Its result will be bound to `self` inside the hook.
+
+```ruby
+class Admin
+  HiddenHooks.hook_up do
+    before_confirmation User, context: proc { Admin.first } do |user|
+      notify! "#{user.name} is being confirmed."
+    end
+  end
+end
+```
+
 #### Rails Callbacks
 
 Thanks to the [callback objects](https://guides.rubyonrails.org/active_record_callbacks.html#callback-objects) system, in Rails you can simply pass the proxy to the callback methods:

data/lib/hidden_hooks/active_record.rb

@@ -4,30 +4,30 @@ module HiddenHooks
   module ActiveRecord
     extend ActiveSupport::Concern
 
-    included do
-      [
-        :after_commit,
-        :after_create,
-        :after_create_commit,
-        :after_destroy,
-        :after_destroy_commit,
-        :after_find,
-        :after_initialize,
-        :after_rollback,
-        :after_save,
-        :after_save_commit,
-        :after_touch,
-        :after_update,
-        :after_update_commit,
-        :after_validation,
-        :before_commit,
-        :before_create,
-        :before_destroy,
-        :before_save,
-        :before_update,
-        :before_validation
-      ].each do |callback|
-        send callback, HiddenHooks[self], prepend: true
+    class_methods do
+      def inherited subclass
+        super
+
+        [
+          :after_commit,
+          :after_create,
+          :after_destroy,
+          :after_find,
+          :after_initialize,
+          :after_rollback,
+          :after_save,
+          :after_touch,
+          :after_update,
+          :after_validation,
+          :before_commit,
+          :before_create,
+          :before_destroy,
+          :before_save,
+          :before_update,
+          :before_validation
+        ].each do |callback|
+          subclass.send callback, HiddenHooks[subclass], prepend: true
+        end
       end
     end
   end

data/lib/hidden_hooks/version.rb

@@ -1,3 +1,3 @@
 module HiddenHooks
-  VERSION = '1.1.1'
+  VERSION = '1.2.0'
 end

data/lib/hidden_hooks.rb

@@ -11,8 +11,16 @@ module HiddenHooks
   class SetUpProxy
     private
 
-    def method_missing hook, klass, &block
-      ::HiddenHooks.hooks[klass][hook] << block
+    def method_missing hook, klass, context: nil, &block
+      ::HiddenHooks.hooks[klass][hook] << if context.nil?
+                                            block
+                                          else
+                                            proc do |*args, **kwargs, &hook_block|
+                                              context
+                                                .call(*args, **kwargs, &hook_block)
+                                                .instance_exec(*args, hook_block, **kwargs, &block)
+                                            end
+                                          end
     end
 
     def respond_to_missing? _, _=false

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hidden_hooks
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
 platform: ruby
 authors:
 - Moku S.r.l.
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-01-28 00:00:00.000000000 Z
+date: 2025-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport