mediate 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06e45660926271c9435a4c2dd1634974b3873091f12160b907833cab8c9b7abf
-  data.tar.gz: 8b1fe7523830f57f8e2499bf8c3575ffc0eef7716478a554f683947a8958dd95
+  metadata.gz: 3d836d3d2c7c76a49fe26644d4fb93ce98f84ae6b77cb1a47ab0db43c3ccf3d2
+  data.tar.gz: 87b88af20dd82d6cadb44261d47864fb032f5c27648f1e50092c6ad2572f6495
 SHA512:
-  metadata.gz: 6f29b77858c6361cbdc54ccc79656d470dd2feb274fe341746fa66d9fc33e34a7c1906bc8df859dfbb0dbf68fa73fc5f1b7819a2bb889565c91388abfbd8d090
-  data.tar.gz: 20c32a19443169eb74e41524b8ae9a342a023a2f54a306d182c3419988dbc5479a739c5866012d29a83e1cb1aeace714f6677efaab7c6368d90082fa0655c879
+  metadata.gz: a8c012bc18b9939dcea6264760d45516359569fa865e725e488cb00ead4a22ab977ce1c6f6561ed256031b0c06824b998cbf090fe09fc2654a4273f5e6310584
+  data.tar.gz: 769e0b47ce6458170e422aefb56ff89bfde68adef9fdfe1b5ca65ae47ce2f138aa2b0407664c1910942fc81b5eac6af112d34d0a83513810c43e3b8b0f372eb3

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mediate (0.1.0)
+    mediate (0.1.2)
       concurrent-ruby (~> 1.1)
 
 GEM

data/README.md

@@ -96,7 +96,7 @@ Note that only one handler can be registered for a particular request class; att
 
 #### Implicit handler declaration
 
-For simple handlers, you can skip the explicit `RequestHandler` declaration above and instead pass a block to `Request.handle_with`.
+For simple handlers, you can skip the explicit `RequestHandler` declaration above and instead pass a lambda to `Request.handle_with`.
 
 ```ruby
 class Ping < Mediate::Request
@@ -107,14 +107,14 @@ class Ping < Mediate::Request
         super()
     end
     # This will have the same behavior as the PingHandler declaration above.
-    handle_with { |request| "Received: #{request.message}" }
+    handle_with ->(request) { "Received: #{request.message}" }
 end
 
 response = Mediate.dispatch(Ping.new('hello'))
 puts response # 'Received: hello'
 ```
 
-Behind the scenes, this defines a `Ping::Handler` class that calls the given block in its `handle` method.  For testing purposes, you can get an instance of this handler class by calling `Mediate::Request.create_implicit_handler` (see [Testing implicit request handlers](#testing-implicit-request-handlers)).
+Behind the scenes, this defines a `Ping::Handler` class that calls the given lambda in its `handle` method.  For testing purposes, you can get an instance of this handler class by calling `Mediate::Request.create_implicit_handler` (see [Testing implicit request handlers](#testing-implicit-request-handlers)).
 
 #### Request polymorphism
 
@@ -129,7 +129,7 @@ Unless we registered a handler for `SubPing` explicitly.
 
 ```ruby
 class SubPing < Ping
-    handle_with { |request| "Received from SubPing: #{request.message}" }
+    handle_with ->(request) { "Received from SubPing: #{request.message}" }
 end
 puts Mediate.dispatch(SubPing.new('howdy')) # 'Received from SubPing: howdy'
 ```
@@ -252,11 +252,11 @@ Special consideration is only required when testing paths that invoke methods on
 
 #### Testing implicit request handlers
 
-How can you test a request handler defined using `handle_with` and a block like the following?
+How can you test a request handler defined using `handle_with` and a lambda like the following?
 
 ```ruby
 class ExampleRequest < Mediate::Request
-    handle_with do |request|
+    handle_with lambda do |request|
         # ....
     end
 end

data/lib/mediate/mediator.rb

@@ -51,7 +51,7 @@ module Mediate
     end
 
     #
-    # Sends a notification to all register handlers for the given notification's type.
+    # Sends a notification to all registered handlers for the given notification's type.
     #
     # @param [Mediate::Notification] notification
     #

data/lib/mediate/request.rb

@@ -9,27 +9,25 @@ module Mediate
     IMPLICIT_HANDLER_CLASS_NAME = "Handler"
 
     #
-    # Registers a handler for this Request type using the given block as the handle method.
+    # Registers a handler for this Request type using the given lambda as the handle method.
     #
+    # @param [Lambda] lmbda the block that will handle the request
     # @param [Mediate::Mediator] mediator the instance to register the handler on
-    # @param [Proc] &proc the block that will handle the request
     #
-    # @raises [ArgumentError] if no block is given
+    # @raises [ArgumentError] if no lambda is given
+    # @raises [RequestHandlerAlreadyExistsError] if handler already defined for this class
     #
-    # @example When a request of this type is dispatched, the handle_with block will run
+    # @example When a request of this type is dispatched, the handle_with lambda will run
     #   class MyRequest < Mediate::Request
-    #     handle_with do |request|
+    #     handle_with lambda do |request|
     #       ## do something with request...
     #     end
     #   end
-    def self.handle_with(mediator = Mediate.mediator, &proc)
-      raise ArgumentError, "expected block to be passed to #handle_with." unless proc
+    def self.handle_with(lmbda, mediator = Mediate.mediator)
+      raise ArgumentError, "expected lambda to be passed to #handle_with." if lmbda.nil?
 
-      if implicit_handler_defined?
-        raise "#{name}::#{IMPLICIT_HANDLER_CLASS_NAME} is already defined. Cannot create implicit handler."
-      end
-
-      handler_class = define_handler(proc)
+      handler_class = define_handler(lmbda)
+      undefine_implicit_handler # remove any previous definition (this will do nothing if it doesn't exist)
       const_set(IMPLICIT_HANDLER_CLASS_NAME, handler_class)
       mediator.register_request_handler(handler_class, self)
     end
@@ -57,17 +55,14 @@ module Mediate
       remove_const(IMPLICIT_HANDLER_CLASS_NAME)
     end
 
-    def self.define_handler(proc)
+    def self.define_handler(lmbda)
       Class.new(RequestHandler) do
-        @@handle_proc = proc # rubocop:disable Style/ClassVars
-        def handle(request)
-          @@handle_proc.call(request)
-        end
+        define_method(:handle, lmbda)
       end
     end
 
     def self.implicit_handler_defined?
-      const_defined?(IMPLICIT_HANDLER_CLASS_NAME)
+      const_defined?(IMPLICIT_HANDLER_CLASS_NAME, false) # do not check ancestors
     end
 
     private_constant :IMPLICIT_HANDLER_CLASS_NAME

data/lib/mediate/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mediate
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

data/lib/mediate.rb

@@ -33,7 +33,7 @@ module Mediate
   end
 
   #
-  # Sends a notification to all register handlers for the given notification's type.
+  # Sends a notification to all registered handlers for the given notification's type.
   #
   # @param [Mediate::Notification] notification
   #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mediate
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Ryan Ferguson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-08-02 00:00:00.000000000 Z
+date: 2022-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby