mimi-messaging 1.1.1 → 1.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f4392d50097d139e224851c8d8609a7f3e092772
-  data.tar.gz: 587ba9c7a31e84d732e377c02df969dcecd2a296
+  metadata.gz: 100b84c9fb56887c8eec1e80249ffbb67f064253
+  data.tar.gz: 57a5fa1bf3163053777ce68b0d2a6224bbc127ba
 SHA512:
-  metadata.gz: c07418b84dc02e2e5d33cdf3c4b836b2aef84710ae6f53c539a99e918c3f5f488ee6efcd30e36b668dc81559808fed04baa9a6841cb5ebe8a5c9bc2d61c29c56
-  data.tar.gz: 8c7a7441e4b5eed3b2013daf7450f52cf9127449257b692508d8d3f6c580d4a695aa1a360b2cb3faa737b6680e3d4ed3298f5ab76fcb4189c2dfc3d82ee967a8
+  metadata.gz: c85f6047982af4c061e422c7bbbb6713b3bf9039b14ac0eef18e9f745e97f3b27737eb90c513a301e056404a1d4f026fb8571076c95ccddbad8d3cf369264270
+  data.tar.gz: f372f54633f37e4ef98879c1c307cee0c3846d295213ee7a1b5ab68017e688957affcc61ef409cb41bb51817abb9fe665d8bb51ddf96de302dbb963e6a007887

data/README.md

@@ -57,7 +57,7 @@ there are several available adapters:
 * [Kafka](https://github.com/kukushkin/mimi-messaging-kafka)
 * RabbitMQ (TBD)
 * NATS (TBD)
-* Amazon SQS/SNS
+* [Amazon SQS/SNS](https://github.com/kukushkin/mimi-messaging-sqs_sns)
 * in-memory (single process)
 
 ## Designing apps
@@ -65,10 +65,11 @@ there are several available adapters:
 
 There are only two hard problems in distributed systems:
 
+```
 2. Exactly-once delivery
 1. Guaranteed order of messages
 2. Exactly-once delivery
-
+```
 
 ## License
 

data/lib/mimi/messaging.rb

@@ -14,14 +14,25 @@ module Mimi
   # Usage: [TBD]
   #
   module Messaging
-    # Target validation pattern:
-    # "[<name>.][...]<name>/<name>"
-    # Where <name> consists of valid identifier characters: A-Za-z0-9_
+    # Request target validation pattern:
+    # "[<name>.][...]<name>/<identifier>"
+    # Where <name> consists of characters: A-Za-z0-9_-
+    # and <method_name> can be any of: A-Za-z0-9_
     #
     # Example:
     # "shop.orders/list"
     #
-    TARGET_REGEX = %r{^((\w+)\.)*(\w+)\/(\w+)$}.freeze
+    REQUEST_TARGET_REGEX = %r{^([\w\-]+\.)*([\w\-]+)\/(\w+)$}.freeze
+
+    # Event target validation pattern:
+    # "[<name>.][...]<name>#<identifier>"
+    # Where <name> consists of characters: A-Za-z0-9_-
+    # and <method_name> can be any of: A-Za-z0-9_
+    #
+    # Example:
+    # "shop.orders#created"
+    #
+    EVENT_TARGET_REGEX = %r{^([\w\-]+\.)*([\w\-]+)\#(\w+)$}.freeze
 
     # By default Mimi::Messaging logs at given level
     DEFAULT_LOG_AT_LEVEL = :info
@@ -185,7 +196,7 @@ module Mimi
     # @return nil
     #
     def self.command(target, message = {}, opts = {})
-      raise ArgumentError, "Invalid target argument" unless TARGET_REGEX.match(target)
+      raise ArgumentError, "Invalid target argument" unless REQUEST_TARGET_REGEX.match(target)
       raise ArgumentError, "Invalid message, Hash or Message is expected" unless message.is_a?(Hash)
       raise Error, "Failed to send command, adapter is not started" unless started?(:adapter)
 
@@ -206,7 +217,7 @@ module Mimi
     # @return [Hash]
     #
     def self.query(target, message = {}, opts = {})
-      raise ArgumentError, "Invalid target argument" unless TARGET_REGEX.match(target)
+      raise ArgumentError, "Invalid target argument" unless REQUEST_TARGET_REGEX.match(target)
       raise ArgumentError, "Invalid message, Hash or Message is expected" unless message.is_a?(Hash)
       raise Error, "Failed to send query, adapter is not started" unless started?(:adapter)
 
@@ -215,12 +226,12 @@ module Mimi
 
     # Broadcasts the event with the given target
     #
-    # @param target [String] "<topic>/<event_type>", e.g. "customers/created"
+    # @param target [String] "<topic>#<event_type>", e.g. "customers#created"
     # @param message [Hash,Mimi::Messaging::Message]
     # @param opts [Hash] additional options
     #
     def self.event(target, message = {}, opts = {})
-      raise ArgumentError, "Invalid target argument" unless TARGET_REGEX.match(target)
+      raise ArgumentError, "Invalid target argument" unless EVENT_TARGET_REGEX.match(target)
       raise ArgumentError, "Invalid message, Hash or Message is expected" unless message.is_a?(Hash)
       raise Error, "Failed to broadcast event, adapter is not started" unless started?(:adapter)
 
@@ -339,7 +350,7 @@ module Mimi
       end
 
       message_processor_params = {
-        type: :event,
+        type: :event_with_queue,
         topic_name: topic_name,
         queue_name: queue_name,
         processor: processor,
@@ -441,24 +452,27 @@ module Mimi
     end
     private_class_method :start_message_processor
 
-    # Starts (registers) all message processors
+    # Starts all registered message processors at the adapter
     #
     def self.start_all_message_processors
       message_processors.each { |p| start_message_processor(p) }
     end
     private_class_method :start_all_message_processors
 
-    # Stops (deregisters) all message processors
+    # Stops all registered message processors at the adapter
     #
     def self.stop_all_processors
       log "#{self} stopping all message processors"
       adapter.stop_all_processors
+      message_processors.each { |p| p[:started] = false }
     end
     private_class_method :stop_all_processors
 
-    # Resets the internal state, private
+    # Deregisters all message processors
     #
-    def self.reset
+    def self.unregister_all_processors
+      stop_all_processors
+      message_processors.replace([])
     end
   end # module Messaging
 end # module Mimi

data/lib/mimi/messaging/adapters/base.rb

@@ -88,7 +88,7 @@ module Mimi
 
         # Broadcasts the event with the given target
         #
-        # @param target [String] "<topic>/<event_type>", e.g. "customers/created"
+        # @param target [String] "<topic>#<event_type>", e.g. "customers#created"
         # @param message [Mimi::Messaging::Message]
         # @param opts [Hash] additional options
         #

data/lib/mimi/messaging/adapters/memory.rb

@@ -23,21 +23,39 @@ module Mimi
         def stop
         end
 
+        # Sends COMMAND to target
+        #
+        # @param target [String]
+        # @param message [Mimi::Messaging::Message]
+        # @param opts [Hash]
+        #
         def command(target, message, opts = {})
-          message_serialized = serialize(message)
-          dispatch_command(target, message_serialized, opts)
+          raise ArgumentError, "Message is expected" unless message.is_a?(Mimi::Messaging::Message)
+          dispatch_command(target, message, opts)
           nil
         end
 
+        # Sends QUERY to target
+        #
+        # @param target [String]
+        # @param message [Mimi::Messaging::Message]
+        # @param opts [Hash]
+        #
         def query(target, message, opts = {})
-          message_serialized = serialize(message)
-          response_serialized = dispatch_query(target, message_serialized, opts)
+          raise ArgumentError, "Message is expected" unless message.is_a?(Mimi::Messaging::Message)
+          response_serialized = dispatch_query(target, message, opts)
           deserialize(response_serialized)
         end
 
+        # Sends EVENT to target
+        #
+        # @param target [String]
+        # @param message [Mimi::Messaging::Message]
+        # @param opts [Hash]
+        #
         def event(target, message, opts = {})
-          message_serialized = serialize(message)
-          dispatch_event(target, message_serialized, opts)
+          raise ArgumentError, "Message is expected" unless message.is_a?(Mimi::Messaging::Message)
+          dispatch_event(target, message, opts)
         end
 
         def start_request_processor(queue_name, processor, _opts = {})
@@ -67,38 +85,48 @@ module Mimi
 
         private
 
-        def dispatch_command(target, message_serialized, _opts = {})
+        # Simulates a transmitted message, following serialization/deserialization:
+        #   message out -> message in
+        #
+        # @param message [Mimi::Messaging::Message]
+        # @return [Mimi::Messaging::Message]
+        #
+        def transmitted_message(message)
+          Mimi::Messaging::Message.new(
+            deserialize(serialize(message)),
+            message.headers
+          )
+        end
+
+        def dispatch_command(target, message, _opts = {})
           queue_name, method_name = target.split("/")
-          message = deserialize(message_serialized)
           return unless request_processors[queue_name]
 
           # pick random processor serving the target
           processor = request_processors[queue_name].sample
-          processor.call_command(method_name, message, {})
+          processor.call_command(method_name, transmitted_message(message), {})
         end
 
-        def dispatch_query(target, message_serialized, _opts = {})
+        def dispatch_query(target, message, _opts = {})
           queue_name, method_name = target.split("/")
-          message = deserialize(message_serialized)
           raise Timeout::Error unless request_processors[queue_name]
 
           # pick random processor serving the target
           processor = request_processors[queue_name].sample
-          response = processor.call_query(method_name, message, {})
+          response = processor.call_query(method_name, transmitted_message(message), {})
           serialize(response)
         end
 
         def dispatch_event(target, message_serialized, _opts = {})
-          topic_name, event_type = target.split("/")
+          topic_name, event_type = target.split("#")
           processors = event_processors[topic_name] || []
           processor_queues = event_processors_with_queue[topic_name] || {}
           processor_queues.values.each do |same_queue_processors|
             processors << same_queue_processors.sample
           end
 
-          message = deserialize(message_serialized)
           processors.each do |processor|
-            processor.call_event(event_type, message, {})
+            processor.call_event(event_type, transmitted_message(message), {})
           end
         end
 

data/lib/mimi/messaging/version.rb

@@ -2,6 +2,6 @@
 
 module Mimi
   module Messaging
-    VERSION = "1.1.1"
+    VERSION = "1.2.6"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mimi-messaging
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.6
 platform: ruby
 authors:
 - Alex Kukushkin
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-10-08 00:00:00.000000000 Z
+date: 2019-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mimi-core