callback-collection 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 78150ace9b1f03ae373409b70582aab42fded3b8ca7cf7268c9e15fcc8eba8a6
-  data.tar.gz: 98fa5ae6f33bc0116f4510d58f698c5e493fd17582843f6b067888d9cf5d82db
+  metadata.gz: 1b8d078e3adf404673581fa27324c5047a56f553607ed5a061cfd2235beda3af
+  data.tar.gz: 46b3b5395ebe4f3b28613abe64aa0732d4e5b090cdada60680706c6552e73a1a
 SHA512:
-  metadata.gz: 9473879ba7b4f83ce62116855eff9b7dac6ea4923ed4cd43610490be669792bea01ed6ec273c8de58351b127a33efd36ecf0670da0a681d6116d6ebbc6fa9db4
-  data.tar.gz: f4decc447ab5a9b79a6531fdaf40d0cadec9ecfca4f0f460d85ac8c629df1ae7f4d39aaa83b8bf23f822a7d7558133a4ac99cfb278bbe8364e4a6b2aa348bf4d
+  metadata.gz: bb5f40c036768f917b0b2478fb1abfac644cc1514cb770c012503f03e3a5aea4c7f1607cd5f88ad74a9de4febad7b01096ca415c972654ff54c2febd0877ad6a
+  data.tar.gz: 3579c01beef765ea0388ee4ce0344fc89ddfbc35ecd524b9307c0536fbe14529ce77b9eee1da348c3271ed948a2649297c2f905bb37438ce27261bb0844ea81f

data/README.md

@@ -40,6 +40,47 @@ callbacks.respond_with(:success, "Ruby")
 La collection est figée à la fin de son initialisation. Toute tentative
 d'ajouter ensuite un callback lève une `FrozenError`.
 
+### Ractors (Ruby 3.0 et versions ultérieures)
+
+Les blocs conservent leur contexte lexical et ne peuvent donc pas être partagés
+entre Ractors. Pour créer une collection partageable, enregistrez plutôt un
+objet partageable et l'une de ses méthodes :
+
+```ruby
+module Handlers
+  def self.sum(left, right)
+    left + right
+  end
+end
+
+callbacks = CallbackCollection.new do |collection|
+  collection.register(:sum, Handlers)
+end
+
+Ractor.shareable?(callbacks)
+# => true
+
+worker = Ractor.new(callbacks) do |collection|
+  collection.respond_with(:sum, 20, 22)
+end
+
+result = worker.respond_to?(:value) ? worker.value : worker.take
+result
+# => 42
+```
+
+Le troisième argument de `register` permet d'utiliser un nom de méthode
+différent du nom du callback :
+
+```ruby
+collection.register(:total, Handlers, :sum)
+```
+
+Le receveur enregistré et les données qu'il utilise doivent eux-mêmes respecter
+les règles de partage des Ractors. L'appel à `respond_with` reste identique.
+Sous Ruby 2.7, la gem et `register` restent utilisables normalement ; seule
+l'exécution avec `Ractor` est indisponible.
+
 ## Développement
 
 ```sh
@@ -70,8 +111,9 @@ Publiez ensuite une version en poussant le tag correspondant à
 `CallbackCollection::VERSION` :
 
 ```sh
-git tag v0.1.0
-git push origin v0.1.0
+VERSION=$(ruby -Ilib -rcallback_collection/version -e 'print CallbackCollection::VERSION')
+git tag "v${VERSION}"
+git push origin "v${VERSION}"
 ```
 
 GitHub Actions construit et publie alors la gem. RubyDoc génère

data/lib/callback_collection/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class CallbackCollection
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/callback_collection.rb

@@ -12,10 +12,30 @@ require_relative "callback_collection/version"
 #   callbacks.respond_with(:success, "data")
 #   # => "Received data"
 class CallbackCollection
+  class RegisteredCallback
+    def initialize(receiver, method_name)
+      @receiver = receiver
+      @method_name = method_name
+      freeze
+    end
+
+    def call(*args, **kwargs, &block)
+      return @receiver.public_send(@method_name, *args, &block) if kwargs.empty?
+
+      @receiver.public_send(@method_name, *args, **kwargs, &block)
+    end
+  end
+  private_constant :RegisteredCallback
+
   def initialize
     callbacks
     yield(self) if block_given?
     callbacks.freeze
+    freeze
+  end
+
+  def register(callback, receiver, method_name = callback)
+    store_callback(callback, RegisteredCallback.new(receiver, method_name))
   end
 
   def respond_with(callback, *args, **kwargs, &block)
@@ -30,10 +50,7 @@ class CallbackCollection
 
   def method_missing(method_name, *args, &block)
     if block
-      raise FrozenError, "Cannot define a callback after initialization." if callbacks.frozen?
-
-      callbacks[method_name] = block
-      self
+      store_callback(method_name, block)
     else
       super
     end
@@ -48,4 +65,13 @@ class CallbackCollection
   def callbacks
     @callbacks ||= {}
   end
+
+  private
+
+  def store_callback(callback, handler)
+    raise FrozenError, "Cannot define a callback after initialization." if callbacks.frozen?
+
+    callbacks[callback] = handler
+    self
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: callback-collection
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Nicolas Vandenbogaerde
@@ -56,7 +56,7 @@ homepage: https://github.com/nicolasva/callback-collection
 licenses: []
 metadata:
   rubygems_mfa_required: 'true'
-  documentation_uri: https://www.rubydoc.info/gems/callback-collection/0.1.0
+  documentation_uri: https://www.rubydoc.info/gems/callback-collection/0.2.0
   source_code_uri: https://github.com/nicolasva/callback-collection
 rdoc_options: []
 require_paths: