message_channel 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e76774a75506f2c670888b319bf69ee3abf09fa5ed509e56549d8bccda8ea26
-  data.tar.gz: b1bbe6889b83970a86a7405d7ce3ee6a1e95438445fa1bad7539c0bcb15162ef
+  metadata.gz: e8dc94c4562b42f2714eda4846834fc1751a8d023aa0e2279e384e1084c37f82
+  data.tar.gz: e339c8ce08b1e8ba82a93e746808c5b5251bffa6ee794d3ad6d61ed51bca08bd
 SHA512:
-  metadata.gz: f793f863eccdde06bed75405f2268159aeaa286bd4d612fc82e656dfacb4b23917030978ce153613499dcc0f17760246b7a6d916b50b749243f8b274213dee03
-  data.tar.gz: fadae6f9289d7307cf939f0818db11008f1aa4270dff733d7639aa12e5703fe0be7f41030c988faa561bb9c10f824cbd923a91bc27a84b5e1edb65d8c3b83aec
+  metadata.gz: 78ba1bb8386cea8cb9e2909f49c6745d9f9710d3b37c8a9870faa83fe09d177af62e963b915457d77a12ce08a5aba3c98a3085ff1c360829fe32d9eabad41518
+  data.tar.gz: bd995e964b92d39ff297953ec4d7eedf6ddabc45b5c1f3b1f7533c3704b6dab53a4e79a5fe94f2304c4ac9e2d7334275d3cdee8f4c8e158f2a4ac94a848cbfd8

data/README.adoc

@@ -1,14 +1,14 @@
 = MessageChannel
 
-Yet another observer pattern library via Observable, DRb, MQTT, Redis and Mongo.
+Yet another observer pattern library via Observable, DRb, MQTT, Redis.
 
 == Features
 
 * Thread based observer pattern library.
-* Implemented as a wrapper for Obserbable, DRb, MQTT, Redis and Mongo.
+* Implemented as a wrapper for Obserbable, DRb, MQTT, Redis.
 * Observer can communicate without using sockets.
 * DRb can communicate between processes without using an external server.
-* MQTT, Redis, and Mongo can create apps that can communicate in other languages.
+* MQTT and Redis can create apps that can communicate in other languages.
 * Distribute topic as a character string and data as a JSON-encoded character string.
 
 == Installation
@@ -89,7 +89,7 @@ sleep
 
 [source,ruby]
 ----
-MessageChannel.new( uri = nil, type: nil, host: nil, port: nil, db: nil, size: nil, name: nil )
+MessageChannel.new( uri = nil, type: nil, host: nil, port: nil, db: nil )
 ----
 
 * Result:
@@ -101,18 +101,14 @@ MessageChannel.new( uri = nil, type: nil, host: nil, port: nil, db: nil, size: n
     *** "druby://127.0.0.1:8787"
     *** "mqtt://127.0.0.1:1883"
     *** "redis://127.0.0.1:6379/0"
-    *** "mongodb://127.0.0.1:27017/test?size=4000&name=_event_queue"
   ** type: Channel type. (default: "observer")
     *** "observer"
     *** "druby"
     *** "mqtt"
     *** "redis"
-    *** "mongodb"
   ** host: Service host. (default: nil)
   ** port: Service port. (default: nil)
-  ** db: Database name. (default: "test")
-  ** size: Queue Size. (default: 4000)
-  ** name: Queue Name. (default: "_event_queue")
+  ** db: Database. (default: nil)
 
 === Notify through the channel.
 
@@ -122,7 +118,6 @@ MessageChannel::Observer#notify( topic, **items )
 MessageChannel::Druby#notify( topic, **items )
 MessageChannel::Mqtt#notify( topic, **items )
 MessageChannel::Redis#notify( topic, **items )
-MessageChannel::Mongodb#notify( topic, **items )
 ----
 
 * Result:
@@ -136,26 +131,32 @@ MessageChannel::Mongodb#notify( topic, **items )
 
 [source,ruby]
 ----
-MessageChannel::Observer#listen( *patterns, &block )
-MessageChannel::Druby#listen( *patterns, &block )
-MessageChannel::Mqtt#listen( *patterns, &block )
-MessageChannel::Redis#listen( *patterns, &block )
-MessageChannel::Mongodb#listen( *patterns, &block )
+MessageChannel::Observer#listen( *patterns, timeout: nil, &block )
+MessageChannel::Druby#listen( *patterns, timeout: nil, &block )
+MessageChannel::Mqtt#listen( *patterns, timeout: nil, &block )
+MessageChannel::Redis#listen( *patterns, timeout: nil, &block )
 ----
 
-* Result:
-  ** with block: (Non-blocing Mode)
+* with block: (async)
+  ** Result:
     *** nil.
-  ** without block: (Blocking Mode)
+
+  ** Parameter:
+    *** patterns: mask patterns.
+
+* without block: (await)
+  ** Result:
+    return nil if timeout.
     *** topic: a notified topic.
     *** items: notified items.
 
-* Parameter:
-  ** patterns: mask patterns.
+  ** Parameter:
+    *** patterns: mask patterns.
+    *** timeout: nil or wait second.
 
-* Block Parameter:
-  ** topic: a notified topic.
-  ** items: notified items.
+  ** Block Parameter:
+    *** topic: a notified topic.
+    *** items: notified items.
 
 === Unlisten to notification.
 
@@ -165,7 +166,6 @@ MessageChannel::Observer#unlisten( *patterns )
 MessageChannel::Druby#unlisten( *patterns )
 MessageChannel::Mqtt#unlisten( *patterns )
 MessageChannel::Redis#unlisten( *patterns )
-MessageChannel::Mongodb#unlisten( *patterns )
 ----
 
 * Result:

data/README.ja.adoc

@@ -1,14 +1,14 @@
 = MessageChannel
 
-オブザーバパターンライブラリのひとつ. Observable, DRb, MQTT, Redis, Mongo を用いる.  
+オブザーバパターンライブラリのひとつ. Observable, DRb, MQTT, Redis を用いる.
 
 == 特徴
 
 * スレッドベースのオブザーバパターンライブラリ.
-* Obserbable, DRb, MQTT, Redis および Mongo のラッパーとして実装.
+* Obserbable, DRb, MQTT, Redis のラッパーとして実装.
 * Observer はソケットを使わずに通信できる.
 * DRb は外部サーバを使わずにプロセス間通信できる.
-* MQTT, Redis, Mongo は通信できるアプリを他言語でも作成できる.
+* MQTT と Redis は通信できるアプリを他言語でも作成できる.
 * トピックは文字列として、データは JSON 化した文字列として配信する.
 
 == 導入
@@ -89,7 +89,7 @@ sleep
 
 [source,ruby]
 ----
-MessageChannel.new( uri = nil, type: nil, host: nil, port: nil, db: nil, size: nil, name: nil )
+MessageChannel.new( uri = nil, type: nil, host: nil, port: nil, db: nil )
 ----
 
 * Result:
@@ -101,18 +101,14 @@ MessageChannel.new( uri = nil, type: nil, host: nil, port: nil, db: nil, size: n
     *** "druby://127.0.0.1:8787"
     *** "mqtt://127.0.0.1:1883"
     *** "redis://127.0.0.1:6379/0"
-    *** "mongodb://127.0.0.1:27017/test?size=4000&name=_event_queue"
   ** type: Channel type. (default: "observer")
     *** "observer"
     *** "druby"
     *** "mqtt"
     *** "redis"
-    *** "mongodb"
   ** host: サービスホスト. (default: nil)
   ** port: サービスポート. (default: nil)
-  ** db: データベース名. (default: "test")
-  ** size: キューサイズ. (default: 4000)
-  ** name: キュー名. (default: "_event_queue")
+  ** db: データベース. (default: nil)
 
 === チャネル経由で通知.
 
@@ -122,7 +118,6 @@ MessageChannel::Observer#notify( topic, **items )
 MessageChannel::Druby#notify( topic, **items )
 MessageChannel::Mqtt#notify( topic, **items )
 MessageChannel::Redis#notify( topic, **items )
-MessageChannel::Mongodb#notify( topic, **items )
 ----
 
 * Result:
@@ -136,26 +131,32 @@ MessageChannel::Mongodb#notify( topic, **items )
 
 [source,ruby]
 ----
-MessageChannel::Observer#listen( *patterns, &block )
-MessageChannel::Druby#listen( *patterns, &block )
-MessageChannel::Mqtt#listen( *patterns, &block )
-MessageChannel::Redis#listen( *patterns, &block )
-MessageChannel::Mongodb#listen( *patterns, &block )
+MessageChannel::Observer#listen( *patterns, timeout: nil, &block )
+MessageChannel::Druby#listen( *patterns, timeout: nil, &block )
+MessageChannel::Mqtt#listen( *patterns, timeout: nil, &block )
+MessageChannel::Redis#listen( *patterns, timeout: nil, &block )
 ----
 
-* Result:
-  ** ブロック引数あり: (Non-blocing Mode)
+* ブロック引数あり: (非同期)
+  ** Result:
     *** nil.
-  ** ブロック引数なし: (Blocking Mode)
+
+  ** Parameter:
+    *** patterns: マスクパターンの配列.
+
+* ブロック引数なし: (待機)
+  ** Result:
+    タイムアウトなら nil を返す.
     *** topic: 通知トピック.
     *** items: 通知アイテム.
 
-* Parameter:
-  ** patterns: マスクパターンの配列.
+  ** Parameter:
+    *** patterns: マスクパターンの配列.
+    *** timeout: nil または待機秒数.
 
-* Block Parameter:
-  ** topic: 通知トピック.
-  ** items: 通知アイテム.
+  ** Block Parameter:
+    *** topic: 通知トピック.
+    *** items: 通知アイテム.
 
 === 通知待機を解除.
 
@@ -165,7 +166,6 @@ MessageChannel::Observer#unlisten( *patterns )
 MessageChannel::Druby#unlisten( *patterns )
 MessageChannel::Mqtt#unlisten( *patterns )
 MessageChannel::Redis#unlisten( *patterns )
-MessageChannel::Mongodb#unlisten( *patterns )
 ----
 
 * Result:

data/lib/message_channel.rb

@@ -13,6 +13,5 @@ module MessageChannel
   autoload  :Druby, "message_channel/druby"
   autoload  :Mqtt, "message_channel/mqtt"
   autoload  :Redis, "message_channel/redis"
-  autoload  :Mongodb, "message_channel/mongodb"
 end
 

data/lib/message_channel/base.rb

@@ -6,9 +6,8 @@ module MessageChannel
     #  "druby://127.0.0.1:8787"
     #  "mqtt://127.0.0.1:1883"
     #  "redis://127.0.0.1:6379/0"
-    #  "mongodb://127.0.0.1:27017/test?size=4000&name=_event_queue"
 
-    def new( uri = nil, type: nil, host: nil, port: nil, db: nil, size: nil, name: nil )
+    def new( uri = nil, type: nil, host: nil, port: nil, db: nil )
       if  uri
         uris  =  URI.parse( uri )
         if  uris.scheme.nil?  &&  uris.host.nil?  &&  uris.port.nil?  &&  uris.path
@@ -20,8 +19,6 @@ module MessageChannel
           port  =  uris.port  ||  port
           params  =  uris.path.gsub(/^\//, "").split('/')
           query  =  Hash[ URI::decode_www_form(uris.query) ]  rescue  {}
-          size  =  query[:size]  ||  size
-          name  =  query[:name]  ||  name
         end
       else
         parans  =  []
@@ -39,11 +36,6 @@ module MessageChannel
       when  "redis"
         options[:db]  =  params.shift  ||  db
         MessageChannel::Redis.new( **options )
-      when  "mongodb"
-        options[:db]  =  params.shift  ||  db
-        options[:size]  =  size
-        options[:name]  =  name
-        MessageChannel::Mongodb.new( **options )
       end
     end
 

data/lib/message_channel/druby.rb

@@ -1,5 +1,6 @@
 require  "drb/drb"
 require  "json"
+require  "timeout"
 
 module MessageChannel
 
@@ -155,17 +156,27 @@ module MessageChannel
       end
     end
 
-    def listen( *patterns, &block )
-      if block.nil?
-        listen_once( *patterns )
-      else
+    def listen( *patterns, timeout: nil, &block )
+      if block_given?
         listen_each( *patterns ) do |topic, items|
           block.call( topic, items )
         end
+        return  nil
+      end
+      if timeout.nil? || ( timeout.is_a?( Numeric ) && timeout >= 0 )
+        begin
+          Timeout.timeout( timeout ) do
+            listen_once( *patterns )
+          end
+        rescue  Timeout::Error
+          return  nil
+        end
+      else
+        raise  ArgumentError, "timeout: %s" % timeout
       end
     end
 
-    def unlisten( **patterns )
+    def unlisten( *patterns )
       patterns.each do |pattern|
         @agent.unlisten( pattern )
         @threads.delete( pattern )

data/lib/message_channel/mqtt.rb

@@ -1,5 +1,6 @@
 require  "mqtt"
 require  "json"
+require  "timeout"
 
 module MessageChannel
   class Mqtt
@@ -53,17 +54,27 @@ module MessageChannel
       end
     end
 
-    def listen( *patterns, &block )
-      if block.nil?
-        listen_once( *patterns )
-      else
+    def listen( *patterns, timeout: nil, &block )
+      if block_given?
         listen_each( *patterns ) do |topic, items|
           block.call( topic, items )
         end
+        return  nil
+      end
+      if timeout.nil? || ( timeout.is_a?( Numeric ) && timeout >= 0 )
+        begin
+          Timeout.timeout( timeout ) do
+            listen_once( *patterns )
+          end
+        rescue  Timeout::Error
+          return  nil
+        end
+      else
+        raise  ArgumentError, "timeout: %s" % timeout
       end
     end
 
-    def unlisten( **patterns )
+    def unlisten( *patterns )
       patterns.each do |pattern|
         @threads[pattern].kill    rescue  nil
         @threads.delete( pattern )    rescue  nil

data/lib/message_channel/observer.rb

@@ -1,5 +1,6 @@
 require  "observer"
 require  "json"
+require  "timeout"
 
 module MessageChannel
 
@@ -54,17 +55,27 @@ module MessageChannel
       end
     end
 
-    def listen( *patterns, &block )
-      if block.nil?
-        listen_once( *patterns )
-      else
+    def listen( *patterns, timeout: nil, &block )
+      if block_given?
         listen_each( *patterns ) do |topic, items|
           block.call( topic, items )
         end
+        return  nil
+      end
+      if timeout.nil? || ( timeout.is_a?( Numeric ) && timeout >= 0 )
+        begin
+          Timeout.timeout( timeout ) do
+            listen_once( *patterns )
+          end
+        rescue  Timeout::Error
+          return  nil
+        end
+      else
+        raise  ArgumentError, "timeout: %s" % timeout
       end
     end
 
-    def unlisten( **patterns )
+    def unlisten( *patterns )
       patterns.each do |pattern|
         if ( action  =  @asyncs[pattern] )
           @asyncs.delete( pattern )

data/lib/message_channel/redis.rb

@@ -1,5 +1,6 @@
 require  "redis"
 require  "json"
+require  "timeout"
 
 module MessageChannel
   class Redis
@@ -62,17 +63,27 @@ module MessageChannel
       end
     end
 
-    def listen( *patterns, &block )
-      if block.nil?
-        listen_once( *patterns )
-      else
+    def listen( *patterns, timeout: nil, &block )
+      if block_given?
         listen_each( *patterns ) do |topic, items|
           block.call( topic, items )
         end
+        return  nil
+      end
+      if timeout.nil? || ( timeout.is_a?( Numeric ) && timeout >= 0 )
+        begin
+          Timeout.timeout( timeout ) do
+            listen_once( *patterns )
+          end
+        rescue  Timeout::Error
+          return  nil
+        end
+      else
+        raise  ArgumentError, "timeout: %s" % timeout
       end
     end
 
-    def unlisten( **patterns )
+    def unlisten( *patterns )
       patterns.each do |pattern|
         @threads[pattern].kill    rescue  nil
         @threads.delete( pattern )    rescue  nil

data/lib/message_channel/version.rb

@@ -1,3 +1,3 @@
 module MessageChannel
-  VERSION = "1.0.1"
+  VERSION = "1.1.0"
 end

data/message_channel.gemspec

@@ -7,7 +7,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["arima.yasuhiro@gmail.com"]
 
   spec.summary       = %q{ Wrapper library for publish/subscribe pattern. }
-  spec.description   = %q{ Yet another observer pattern wrapper library via Observable, DRb, MQTT, Redis or Mongo. }
+  spec.description   = %q{ Yet another observer pattern wrapper library via Observable, DRb, MQTT, Redis. }
   spec.homepage      = "https://github.com/arimay/message_channel"
   spec.license       = "MIT"
 
@@ -23,7 +23,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "mqtt"
   spec.add_development_dependency "redis"
   spec.add_development_dependency "msgpack"
-  spec.add_development_dependency "mongo"
 
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"

data/sample/all_1.rb

@@ -4,7 +4,6 @@ ObserverChannel  =  MessageChannel.new( "observer" )
 DrubyChannel     =  MessageChannel.new( "druby" )
 MqttChannel      =  MessageChannel.new( "mqtt" )
 RedisChannel     =  MessageChannel.new( "redis" )
-MongodbChannel   =  MessageChannel.new( "mongodb" )
 
 Signal.trap( :INT ) do
   exit
@@ -30,11 +29,6 @@ RedisChannel.listen( mask4 ) do |topic, items|
   p [:redis___, mask4, topic, items]
 end
 
-mask5  =  "mongodb_/*" 
-MongodbChannel.listen( mask5 ) do |topic, items|
-  p [:mongodb_, mask5, topic, items]
-end
-
 i  =  0
 while  true
   sleep  1
@@ -44,5 +38,4 @@ while  true
   DrubyChannel.notify     "druby___/#{i}",  at: now
   MqttChannel.notify      "mqtt____/#{i}",  at: now
   RedisChannel.notify     "redis___/#{i}",  at: now
-  MongodbChannel.notify   "mongodb_/#{i}",  at: now
 end

data/sample/sample.txt

@@ -21,11 +21,3 @@ URI defailt params for message_channel.
   "redis://127.0.0.1:6379"
   "redis://127.0.0.1:6379/1"
 
-  "mongodb"
-  "mongodb://127.0.0.1"
-  "mongodb://127.0.0.1:27017"
-  "mongodb://127.0.0.1:27017/test"
-  "mongodb://127.0.0.1:27017/test?size=8000"
-  "mongodb://127.0.0.1:27017/test?name=_event_queue"
-  "mongodb://127.0.0.1:27017/test?size=8000&name=_event_queue"
-

data/sample/sample_4.rb

@@ -0,0 +1,31 @@
+require  "message_channel"
+
+p uri  =  ARGV.shift
+p Channel  =  MessageChannel.new( uri )
+
+Signal.trap( :INT ) do
+  exit
+end
+
+Channel.listen( "hello", "world" ) do |topic, items|
+  p [:async, topic, items]
+end
+
+Thread.start do
+  while  true
+    topic, items  =  Channel.listen( "hello", "world", timeout: rand )
+    p [:await, topic, items]
+  end
+end
+
+Thread.start do
+  while  true
+    Channel.notify( "hello",  at: Time.now.to_s )
+    sleep  1
+    Channel.notify( "world",  at: Time.now.to_s )
+    sleep  1
+  end
+end
+
+sleep
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: message_channel
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - arimay
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-02-03 00:00:00.000000000 Z
+date: 2021-03-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mqtt
@@ -52,20 +52,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: mongo
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -95,7 +81,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 description: " Yet another observer pattern wrapper library via Observable, DRb, MQTT,
-  Redis or Mongo. "
+  Redis. "
 email:
 - arima.yasuhiro@gmail.com
 executables: []
@@ -105,7 +91,6 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
-- ".travis.yml"
 - Gemfile
 - README.adoc
 - README.ja.adoc
@@ -115,7 +100,6 @@ files:
 - lib/message_channel.rb
 - lib/message_channel/base.rb
 - lib/message_channel/druby.rb
-- lib/message_channel/mongodb.rb
 - lib/message_channel/mqtt.rb
 - lib/message_channel/observer.rb
 - lib/message_channel/redis.rb
@@ -126,6 +110,7 @@ files:
 - sample/sample_1.rb
 - sample/sample_2.rb
 - sample/sample_3.rb
+- sample/sample_4.rb
 homepage: https://github.com/arimay/message_channel
 licenses:
 - MIT

data/.travis.yml

@@ -1,6 +0,0 @@
----
-language: ruby
-cache: bundler
-rvm:
-  - 2.7.1
-before_install: gem install bundler -v 2.1.4

data/lib/message_channel/mongodb.rb

@@ -1,133 +0,0 @@
-require  "mongo"
-require  "json"
-
-::Mongo::Logger.logger.level  =  Logger::ERROR
-
-module MessageChannel
-  class Mongodb
-    SIZE  =  8000
-    NAME  =  "_event_queue"
-
-    def initialize( host: nil, port: nil, db: nil, size: nil, name: nil )
-      @host  =  host  ||  "127.0.0.1"
-      @port  =  ( port  ||  27017 ).to_i
-      @db    =  db  ||  "test"
-      @size  =  ( size  ||  SIZE ).to_i
-      @name  =  name  ||  NAME
-
-      @url   =  "mongodb://#{ @host }:#{ @port }/#{ @db }"
-      @client  =  ::Mongo::Client.new( @url )
-
-      @threads  =  {}
-      @mutex  =  Mutex.new
-
-      @event_queue  =  get_event_queue
-    end
-
-    def get_event_queue
-      event_queue  =  @mutex.synchronize do
-        if  @client.database.collection_names.include?( @name )
-          event_queue  =  @client[ @name ]
-        else
-          event_queue  =  @client[ @name, capped: true, size: @size ]
-          event_queue.create
-          now  =  Time.now
-          doc  =  {
-            topic: "reset",
-            at: now.strftime("%Y%m%d.%H%M%S.%6L"),
-          }
-          event_queue.insert_one( doc )
-          event_queue
-        end
-      end
-    end
-
-    def get_event_tail( event_queue )
-      filter  =  {}
-      if ( enum  =  event_queue.find( {}, { sort: { "$natural" => -1 } } ).to_enum )
-        if ( doc  =  enum.next    rescue  nil )
-          filter  =  { "_id"=>{ "$gt"=>doc["_id"] } }
-        end
-      end
-      event_tail  =  event_queue.find( filter, { cursor_type: :tailable_await } ).to_enum
-    end
-
-    def listen_once( *patterns )
-      queue  =  Queue.new
-      threads  =  {}
-      patterns.each do |pattern|
-        threads[pattern]  =  ::Thread.start( pattern ) do |pttrn|
-          event_queue  =  get_event_queue
-          event_tail  =  get_event_tail( event_queue )
-          begin
-            while ( doc  =  event_tail.next )
-              items  =  JSON.parse( doc.to_json, symbolize_names: true )
-              topic  =  items[:topic]
-              if File.fnmatch( pttrn, topic, File::FNM_PATHNAME )
-                items.delete( :_id )
-                items.delete( :topic )
-                queue.push  [topic, items]
-              end
-            end
-          rescue => e
-            nil
-          end
-        end
-      end
-
-      topic, items  =  queue.pop
-      patterns.each do |pattern|
-        threads[pattern].kill    rescue  nil
-        threads.delete( pattern )    rescue  nil
-      end
-      [topic, items]
-    end
-
-    def listen_each( *patterns, &block )
-      patterns.each do |pattern|
-        @threads[pattern]  =  ::Thread.start( pattern ) do |pttrn|
-          begin
-            event_queue  =  get_event_queue
-            event_tail  =  get_event_tail( event_queue )
-            while ( doc  =  event_tail.next )
-              items  =  JSON.parse( doc.to_json, symbolize_names: true )
-              topic  =  items[:topic]
-              if File.fnmatch( pttrn, topic, File::FNM_PATHNAME )
-                items.delete( :_id )
-                items.delete( :topic )
-                block.call( topic, items )
-              end
-            end
-          rescue => e
-            nil
-          end
-        end
-      end
-    end
-
-    def listen( *patterns, &block )
-      if block.nil?
-        listen_once( *patterns )
-      else
-        listen_each( *patterns ) do |topic, items|
-          block.call( topic, items )
-        end
-      end
-    end
-
-    def unlisten( **patterns )
-      patterns.each do |pattern|
-        @threads[pattern].kill    rescue  nil
-        @threads.delete( pattern )    rescue  nil
-      end
-    end
-
-    def notify( topic, **items )
-      items[:topic]  =  topic
-      @event_queue.insert_one( items )
-    end
-
-  end
-
-end
-