pubsub 0.0.1 → 0.0.2

data/Gemfile

@@ -4,7 +4,7 @@ gem "ruby_events", ">=0"
 
 group :development do
   gem "shoulda", ">= 0"
-  gem "bundler", "~> 1.0.0"
+  gem "bundler", ">= 1.0.0"
   gem "jeweler", "~> 1.6.4"
   gem "rcov", ">= 0"
 

data/Gemfile.lock

@@ -0,0 +1,36 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    ZenTest (4.6.0)
+    autotest-growl (0.2.9)
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.9.2)
+    rcov (0.9.9)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    ruby_events (1.1.0)
+    shoulda (2.11.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  ZenTest
+  autotest-growl
+  bundler (>= 1.0.0)
+  jeweler (~> 1.6.4)
+  rcov
+  rspec
+  ruby_events
+  shoulda

data/README.rdoc

@@ -1,16 +1,139 @@
 = pubsub
 
-Description goes here.
-
-== Contributing to pubsub
- 
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
-* Fork the project
-* Start a feature/bugfix branch
-* Commit and push until you are happy with your contribution
-* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+== DESCRIPTION:
+
+Ruby PubSub pattern for objects. Allows to coordinate object (publisher/subscriber) communication.
+
+== FEATURES:
+
+* Support multithread pulisher/subscriber
+* Contains message queue and dispatcher.
+* Dispatcher work in main thread and sleep when message queue is empty
+
+== USAGE:
+Using pubsub is simple
+
+    require 'rubygems'
+    require 'ruby_events'
+
+Include pubsub module into class
+
+    class MyPublischer
+        include PubSub
+
+    end
+
+Run message queue dispatcher
+
+    PubSub.run
+
+Message in channel with subchannels (include '/') sending throw all subchannels, e.g. for channel 'system/info' message sending to subsribers of channel 'system/info', subchannel 'system' and global channel '*'
+
+Unsubscribe from all channels use unsubscribe method without params.
+
+    class MyPublischer
+        include PubSub
+        def initialize
+            subscribe "system/info", :log_info
+            subscribe "system/signout", :destroy
+        end
+
+        def destroy
+            unsubscribe
+        end
+    end
+
+Unsubscribe all listeners from one channel use unsubscribe method with channel name
+
+    class TextLogger
+        include PubSub
+        def initialize
+            subscribe "system/info", :log_info
+        end
+
+        def log_info
+            #log to text file
+        end
+    end
+
+    class ConsoleLogger
+        include PubSub
+        def initialize
+            subscribe "system/info", :log_info
+        end
+
+        def log_info
+            #log to console
+        end
+    end
+
+    class LoggerManager
+        include PubSub
+
+        def unsubscribe_all_logger
+            unsubscribe "system/info"
+        end
+    end
+
+Unsubscribe one listener from one channel use unsubscribe method with channel name and listener
+
+    class MyPublisher
+        include PubSub
+
+        def initialize
+            subscribe "system/info", :log_info
+        end
+
+        def destroy
+            unsubscribe "system/info", :log_info
+        end
+    end
+
+== EXAMPLES:
+
+Create object and subscribe it to channel "system/info"
+
+    class SystemLogger
+        include PubSub
+
+        def initialize
+            subscribe "system/info", :log_info
+        end
+
+        def destroy
+            unsubscribe
+        end
+
+        def log_info(message)
+            puts message
+
+            # stop pubsub dispatcher
+            PubSub.stop
+        end
+    end
+
+    class Publisher
+        include PubSub
+
+        def say_hello
+            publish "system/info", "Hello world!"
+        end
+    end
+
+    SystemLogger.new
+    publisher = Publisher.new
+    publisher.say_hello
+
+    # run pubsub dispatcher
+    PubSub.run
+
+== INSTALL:
+
+* gem install pubsub
+
+== DOCS:
+
+http://rubydoc.info/gems/pubsub
 
 == Copyright
 

data/VERSION

@@ -1 +1 @@
-0.0.1
+0.0.2

data/lib/pubsub/pubsub.rb

@@ -64,6 +64,7 @@ module PubSub
 
   def PubSub.stop
     @@stopped = true
+    PubSub.thread.wakeup if PubSub.thread.status == "sleep"
   end
 
   protected

metadata

@@ -1,116 +1,142 @@
 --- !ruby/object:Gem::Specification
 name: pubsub
 version: !ruby/object:Gem::Version
-  version: 0.0.1
-  prerelease: 
+  version: 0.0.2
+  segments:
+  - 0
+  - 0
+  - 2
+  prerelease: false
 platform: ruby
 authors:
 - Max Kazarin
-autorequire: 
+autorequire: !!null 
 bindir: bin
 cert_chain: []
-date: 2011-07-17 00:00:00.000000000 +04:00
-default_executable: 
+date: 2011-07-25 00:00:00.000000000 +04:00
+default_executable: !!null 
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby_events
-  requirement: &18948040 !ruby/object:Gem::Requirement
+  requirement: &24511080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+        segments:
+        - 0
   type: :runtime
   prerelease: false
-  version_requirements: *18948040
+  version_requirements: *24511080
 - !ruby/object:Gem::Dependency
   name: shoulda
-  requirement: &18946840 !ruby/object:Gem::Requirement
+  requirement: &24510180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+        segments:
+        - 0
   type: :development
   prerelease: false
-  version_requirements: *18946840
+  version_requirements: *24510180
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &18946080 !ruby/object:Gem::Requirement
+  requirement: &24494060 !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: 1.0.0
+        segments:
+        - 1
+        - 0
+        - 0
   type: :development
   prerelease: false
-  version_requirements: *18946080
+  version_requirements: *24494060
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &18945200 !ruby/object:Gem::Requirement
+  requirement: &24493280 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.6.4
+        segments:
+        - 1
+        - 6
+        - 4
   type: :development
   prerelease: false
-  version_requirements: *18945200
+  version_requirements: *24493280
 - !ruby/object:Gem::Dependency
   name: rcov
-  requirement: &18944220 !ruby/object:Gem::Requirement
+  requirement: &24492440 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+        segments:
+        - 0
   type: :development
   prerelease: false
-  version_requirements: *18944220
+  version_requirements: *24492440
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &18943460 !ruby/object:Gem::Requirement
+  requirement: &24491780 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+        segments:
+        - 0
   type: :development
   prerelease: false
-  version_requirements: *18943460
+  version_requirements: *24491780
 - !ruby/object:Gem::Dependency
   name: ZenTest
-  requirement: &18928680 !ruby/object:Gem::Requirement
+  requirement: &24491040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+        segments:
+        - 0
   type: :development
   prerelease: false
-  version_requirements: *18928680
+  version_requirements: *24491040
 - !ruby/object:Gem::Dependency
   name: autotest-growl
-  requirement: &18927540 !ruby/object:Gem::Requirement
+  requirement: &24490380 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+        segments:
+        - 0
   type: :development
   prerelease: false
-  version_requirements: *18927540
+  version_requirements: *24490380
 - !ruby/object:Gem::Dependency
   name: ruby_events
-  requirement: &18921320 !ruby/object:Gem::Requirement
+  requirement: &24489660 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+        segments:
+        - 0
   type: :runtime
   prerelease: false
-  version_requirements: *18921320
+  version_requirements: *24489660
 description: PubSub pattern
 email: maxkazargm@gmail.com
 executables: []
@@ -123,6 +149,7 @@ files:
 - .document
 - .rspec
 - Gemfile
+- Gemfile.lock
 - LICENSE.txt
 - README.rdoc
 - Rakefile
@@ -138,7 +165,7 @@ has_rdoc: true
 homepage: http://github.com/maxkazar/pubsub
 licenses:
 - MIT
-post_install_message: 
+post_install_message: !!null 
 rdoc_options: []
 require_paths:
 - lib
@@ -150,17 +177,19 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2541202216032154175
+      hash: -2395597313828472709
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.6.2
-signing_key: 
+rubyforge_project: !!null 
+rubygems_version: 1.3.7
+signing_key: !!null 
 specification_version: 3
 summary: PubSub pattern
 test_files: []