observe 0.1.0 → 0.2.0

data/.rbenv-version

@@ -0,0 +1 @@
+1.9.2-p290

data/README.md

@@ -26,6 +26,32 @@ __DIFFERENCES__
     If you want to notify observers, go ahead & use `notify_observers`.   
     If there is state that needs to be true before observers can be notified, you can use `if(…)`.
 
+__FULL DISCLOSURE__
+
+  It can help to know what methods and state is introduced by Observe so your class or module can 
+  avoid stepping on the toes of Observe by accident.   
+  When you include Observe into a class or module it adds four methods to your class/module:
+
+
+  * add\_observer  
+    Adds an observer for the including class/module.
+
+  * notify\_observers   
+    Notify  observers registered for the including class/module.
+
+  * destroy\_observers  
+    Destroy observers registered for the incluing class/module.
+
+  * observers  
+    You shouldn't need to use this method.  
+    It is used internally by the above methods.
+
+
+  It adds the following instance variable:
+  
+  * @observers  
+    Nothing special, a list of observers used by the 'observers' method.
+
 __EXAMPLE__
 
     class Car

data/lib/observe.rb

@@ -22,9 +22,9 @@ module Observe
   #
   def add_observer group, observer=nil, &block
     if block_given?
-      observers << Observe.observer.new(group.to_sym, block)
+      observers[group.to_sym] << Observe.observer.new(group.to_sym, block)
     elsif observer
-      observers << Observe.observer.new(group.to_sym, observer) 
+      observers[group.to_sym] << Observe.observer.new(group.to_sym, observer) 
     else
       raise ArgumentError, "A block or object is expected, but none given." 
     end
@@ -43,10 +43,8 @@ module Observe
   # @return [void]
   #
   def notify_observers group, *args
-    observers.each do |observer|
-      if observer.group == group.to_sym 
-        observer.object.call(*args)
-      end
+    observers[group.to_sym].each do |observer|
+      observer.object.call(*args)
     end
   end
   private :notify_observers
@@ -67,15 +65,19 @@ module Observe
     if group.nil?
       observers.clear
     else
-      observers.delete_if do |observer|
-        observer.group == group.to_sym
-      end
+      observers.delete(group.to_sym)
     end
   end
   private :destroy_observers
 
+  #
+  # A list of observers registered for a including class or module.  
+  # There's no need to use this method directly.
+  #
+  # @return [Hash<Symbol, Array>]
+  #
   def observers
-    @observers = @observers || []
+    @observers = @observers || Hash.new { |h,k| h[k] = [] }
   end
   private :observers
 

data/observe.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name        = "observe"
-  s.version     = "0.1.0"
+  s.version     = "0.2.0"
   s.authors     = ["Rob Gleeson"]
   s.email       = ["rob@flowof.info"]
   s.homepage    = "https://github.com/robgleeson/observe"

data/test/observe_test.rb

@@ -24,7 +24,7 @@ describe Observe do
       @subject.add_observer(:group)  { }
       @subject.add_observer(:fail) { }
 
-      @subject.observers.select { |o| o.group == :group }.size.must_equal(2)
+      @subject.observers[:group].size.must_equal(2)
     end
 
     it 'must raise an ArgumentError if no block or object is given.' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: observe
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-10-21 00:00:00.000000000 Z
+date: 2011-11-02 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
-  requirement: &70221281267820 !ruby/object:Gem::Requirement
+  requirement: &70196288545480 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: '2.5'
   type: :development
   prerelease: false
-  version_requirements: *70221281267820
+  version_requirements: *70196288545480
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70221281267300 !ruby/object:Gem::Requirement
+  requirement: &70196288544800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,7 +32,7 @@ dependencies:
         version: 0.9.2
   type: :development
   prerelease: false
-  version_requirements: *70221281267300
+  version_requirements: *70196288544800
 description: A simple interface for adding observers to any class.
 email:
 - rob@flowof.info
@@ -41,6 +41,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .rbenv-version
 - .travis.yml
 - .yardopts
 - Gemfile
@@ -65,7 +66,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -3874655113757391792
+      hash: 2329257265388588306
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -74,10 +75,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -3874655113757391792
+      hash: 2329257265388588306
 requirements: []
 rubyforge_project: observe
-rubygems_version: 1.8.10
+rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
 summary: A simple interface for adding observers to any class.