sentinel 0.2.0 → 0.3.0

data/README.textile

@@ -16,7 +16,7 @@ $ [sudo] gem install sentinel
 
 Then, add it as a dependency in your code using your favorite way (a simple require or mechanisms like the bundler gem).
 
-To use it, first you'll need an observer class that responds to a class method called *_notify_*. All the observed method's arguments will be passed to this method, hence the _args_ splat.
+To use it, first you'll need an observer class that responds to a class method called *_notify_* by default. All the observed method's arguments will be passed to this method, hence the _args_ splat.
 
 <pre>
 class MyObserver
@@ -55,7 +55,21 @@ class MyClass
 end
 </pre>
 
-And... that's it! Every time the observed method is called, the _notify_ method from the defined _observer class_ will be called *before* it, then it will run normally.
+And... that's it! Every time the observed method is called, by default the _notify_ method from the defined _observer class_ will be called *before* it, then it will run normally.
+
+You can also choose another method to call when the observed method is called, instead of the default _notify_ method:
+
+<pre>
+class MyObserver
+  include Sentinel
+
+  observe MyClass, :instance_method, :method_to_notify => :my_notifier
+
+  def self.my_notifier(*args)
+    puts "Do your thing!"
+  end
+end
+</pre>
 
 h2. Note on Patches/Pull Requests
 

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.3.0

data/lib/sentinel.rb

@@ -9,9 +9,13 @@ module Sentinel
     def observe(class_name, method_name, options = {})
       sentinel = self
 
+      options = {
+        :method_to_notify => :notify
+      }.merge(options)
+
       body = <<-CODE
         define_method "#{method_name}_with_observer" do |*args|
-          sentinel.notify(*args)
+          sentinel.send("#{options[:method_to_notify]}", *args)
           self.send("#{method_name}_without_observer", *args)
         end
 

data/sentinel.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{sentinel}
-  s.version = "0.2.0"
+  s.version = "0.3.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Lucas H\303\272ngaro"]
-  s.date = %q{2010-03-02}
+  s.date = %q{2010-03-26}
   s.description = %q{Transparent (unobtrusive) Observers for your Ruby code}
   s.email = %q{lucashungaro@gmail.com}
   s.extra_rdoc_files = [

data/spec/fixtures/my_observer.rb

@@ -2,4 +2,8 @@ class MyObserver
   def self.notify(*args)
     "Observing!"
   end
+
+  def self.another_method(*args)
+    "Observing!"
+  end
 end

data/spec/fixtures/sentinel_subject.rb

@@ -2,23 +2,27 @@ class SentinelSubject
   def instance_method
     "hi from instance method!"
   end
-  
+
+  def new_method
+    "hi from new method!"
+  end
+
   def self.class_method
     "hi from class method!"
   end
-  
+
   def instance_method_with_params(*params)
     "hi from instance method with params!"
   end
-  
+
   def self.class_method_with_params(*params)
     "hi from class method with params!"
   end
-  
+
   def instance_returning_something
     42
   end
-  
+
   def self.class_returning_something
     42
   end

data/spec/sentinel_spec.rb

@@ -6,7 +6,7 @@ describe Sentinel, "defining an observer for a method" do
   before(:all) do
     MyObserver.send(:include, Sentinel)
   end
-  
+
   context "with the minimum required options" do
     it "should notify the specified Observer when calling a class method" do
       MyObserver.send(:observe, SentinelSubject, :instance_method)
@@ -14,24 +14,24 @@ describe Sentinel, "defining an observer for a method" do
 
       SentinelSubject.new.instance_method
     end
-    
+
     it "should notify the specified Observer when calling an instance method" do
       MyObserver.send(:observe, SentinelSubject, :class_method, :class_method => true)
       MyObserver.expects(:notify)
-      
+
       SentinelSubject.class_method
     end
-    
+
     it "should not modify the observed methods output" do
       MyObserver.send(:observe, SentinelSubject, :class_returning_something, :class_method => true)
       MyObserver.send(:observe, SentinelSubject, :instance_returning_something)
-      
+
       MyObserver.expects(:notify).twice
 
       SentinelSubject.class_returning_something.should == 42
       SentinelSubject.new.instance_returning_something.should == 42
     end
-    
+
     context "observing methods with parameters" do
       it "should pass all parameters of the observed methods to the Observer" do
         MyObserver.send(:observe, SentinelSubject, :class_method_with_params, :class_method => true)
@@ -43,20 +43,29 @@ describe Sentinel, "defining an observer for a method" do
         SentinelSubject.new.instance_method_with_params("texto", 1)
       end
     end
+
+    context "observing methods using a different Observer method" do
+      it "should call the specified method in the observe call" do
+        MyObserver.send(:observe, SentinelSubject, :new_method, :method_to_notify => :another_method)
+        MyObserver.expects(:another_method)
+
+        SentinelSubject.new.new_method
+      end
+    end
   end
-  
+
   context "without the minimum required options" do
     it "should raise ArgumentError when the observer of an instance method is not defined" do
       MyObserver.expects(:notify).never
       SentinelSubject.expects(:observe).raises(ArgumentError)
-      
+
       SentinelSubject.send(:observe, :instance_method) rescue nil
     end
 
     it "should raise ArgumentError when the observer of a class method is not defined" do
       MyObserver.expects(:notify).never
       SentinelSubject.expects(:observe).raises(ArgumentError)
-      
+
       SentinelSubject.send(:observe, :class_method, :class_method => true) rescue nil
     end
   end

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 2
+  - 3
   - 0
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors: 
 - "Lucas H\xC3\xBAngaro"
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-02 00:00:00 -03:00
+date: 2010-03-26 00:00:00 -03:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency