hidden_hooks 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88532a44bde6fdd20a6bcd02505060ec0abffd7fe55e815c3dd82a80d0be8819
-  data.tar.gz: 118bd2af55f7472686deaf3c93f9008b8d3fd820dab2082d6f032103f4f72583
+  metadata.gz: 4b408f5e35a24cb32e4f5d2927174c96e10a2220c654d5a8900a89e4e2970152
+  data.tar.gz: 81f34fb4792cc92fdbbc41d5ccb0279ea423316f03cc58e806c6d3f922cc903f
 SHA512:
-  metadata.gz: 6c7b53ac8c04c1b6d02dbd6af42d7c7d6e6d93a60faea4c23ffcbf615e6744d3626678b01a4d8d4c4b53846263e188aedfcfb39ea9e22d36c61ddbdb4c98fa9e
-  data.tar.gz: c81d8c1c686af906141279a02067a90a131445506a6c83c9fd967bd582b7868a6da54e780f08c1cba3d44da920ae8796e2be2a8c2b47611792647eb92da39434
+  metadata.gz: 2d2c91bb68d8175daecb0e13beafec167bb39c88a9d1b49468d56074874912c945bd517f9a4db9bc8172e1df4640ab7b25aaf6f03921328d7d14befc9fbe3b66
+  data.tar.gz: dbdc9b528501321089404046528a6665189c95ea81f4b871ea187be3a45599b83271e60739bcbb7bbc050d782dc58e4fc3d60541d59f896ca81a8403c75cf6f4

data/CHANGELOG.md

@@ -8,6 +8,12 @@
 ### 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

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/version.rb

@@ -1,3 +1,3 @@
 module HiddenHooks
-  VERSION = '1.1.2'
+  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.2
+  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