audible 0.2.0 → 0.4.0

data/spec/{examples → unit.tests/examples}/a_notifying_shell_spec.rb

@@ -1,28 +1,28 @@
-require "spec_helper"
-
-class Shell
-  require "audible"; extend Audible
-  
-  class << self
-    def exec(what)
-      require "open3"
-      Open3.popen2(what, :err => [:child, :out]) do |i,o,t|
-        o.each_line {|line| notify :progress, line}
-      end
-    end
-  end
-end
-
-describe "An audible shell" do
-  it "notifies for each line of output" do
-    result = StringIO.new
-
-    Shell.on :progress do |e, args|
-      result.puts args.first
-    end
-
-    Shell.exec "ls -a"
-
-    result.length.must be > 0
-  end
-end
+require "spec_helper"
+
+class Shell
+  require "audible"; extend Audible
+  
+  class << self
+    def exec(what)
+      require "open3"
+      Open3.popen2(what, :err => [:child, :out]) do |i,o,t|
+        o.each_line {|line| notify :progress, line}
+      end
+    end
+  end
+end
+
+describe "An audible shell" do
+  it "notifies for each line of output" do
+    result = StringIO.new
+
+    Shell.on :progress do |e, args|
+      result.puts args.first
+    end
+
+    Shell.exec "ls -a"
+
+    result.length.must be > 0
+  end
+end

data/spec/{examples → unit.tests/examples}/logging_as_notifications_spec.rb

@@ -1,51 +1,51 @@
-require "spec_helper"
-
-class BusyBody
-  require "audible"; include Audible
-  
-  def go
-    step_one
-    step_two
-    step_three
-  end
-  
-  private
-
-  %w{one two three}.each do |name|
-    full_name = "step_#{name}".to_sym
-
-    define_method(full_name){ notify full_name }
-  end 
-end
-
-class LogSpy
-  attr_reader :messages
-
-  def initialize(what)
-    @messages = []
-
-    what.on :step_one do
-      @messages << "Step 1"
-    end
-
-    what.on :step_two do
-      @messages << "Step 2"
-    end
-
-    what.on :step_three do
-      @messages << "Step 3"
-    end
-  end
-end
-
-describe BusyBody, "and notifying instead of logging" do
-  it "attach the log by notification rather than as dependency" do
-    busy_body = BusyBody.new
-    
-    log = LogSpy.new busy_body
-
-    busy_body.go
-
-    log.messages.must == ["Step 1", "Step 2", "Step 3"]
-  end
-end
+require "spec_helper"
+
+class BusyBody
+  require "audible"; include Audible
+  
+  def go
+    step_one
+    step_two
+    step_three
+  end
+  
+  private
+
+  %w{one two three}.each do |name|
+    full_name = "step_#{name}".to_sym
+
+    define_method(full_name){ notify full_name }
+  end 
+end
+
+class LogSpy
+  attr_reader :messages
+
+  def initialize(what)
+    @messages = []
+
+    what.on :step_one do
+      @messages << "Step 1"
+    end
+
+    what.on :step_two do
+      @messages << "Step 2"
+    end
+
+    what.on :step_three do
+      @messages << "Step 3"
+    end
+  end
+end
+
+describe BusyBody, "and notifying instead of logging" do
+  it "attach the log by notification rather than as dependency" do
+    busy_body = BusyBody.new
+    
+    log = LogSpy.new busy_body
+
+    busy_body.go
+
+    log.messages.must == ["Step 1", "Step 2", "Step 3"]
+  end
+end

data/spec/unit.tests/it_notifies_despite_errors_spec.rb

@@ -0,0 +1,30 @@
+require "spec_helper"
+
+describe "You always get notified, even when another listener fails" do 
+  let(:an_audible_object) do
+     Class.new do
+      require "audible"; include Audible
+
+      def poke; notify :poked; end
+    end.new
+  end
+    
+  it "notifies despite prior error, AND raises the error" do 
+    notified = false
+    
+    an_audible_object.on(:poked){|e,args| fail "This is supposed to fail" }
+    an_audible_object.on(:poked){|e,args| notified = true }
+   
+    expect{an_audible_object.poke}.to raise_error /fail/
+    
+    expect(notified).to be_true
+  end 
+  
+  it "only raises the first error" do
+    an_audible_object.on(:poked){|e,args| fail "ERROR A" }
+    an_audible_object.on(:poked){|e,args| fail "ERROR B" }
+    an_audible_object.on(:poked){|e,args| fail "ERROR C" }
+   
+    expect{an_audible_object.poke}.to raise_error /A/
+  end
+end

data/spec/{listening_spec.rb → unit.tests/listening_spec.rb}

@@ -1,53 +1,53 @@
-require "spec_helper"
-
-describe "An audible object" do
-  let(:an_audible_object) do
-     an_audible_class = Class.new do
-      require "audible"; include Audible
-
-      def poke; notify :poked ; end
-      def tap ; notify :tapped; end
-
-      protected
-
-      def accepts?(e);
-        [:poked,:tapped].include? e
-      end
-    end.new
-  end
-
-  it "notifies of the event I ask for" do
-    notified = false
-
-    an_audible_object.on :poked do
-      notified = true
-    end
-
-    an_audible_object.poke
-
-    notified.must be_true
-  end
-
-  it "fails if the event does not match a supported one" do
-    expect{an_audible_object.on(:xxx_does_not_exist_xxx){}}.to raise_error /Event .+ not supported/
-  end
-
-  it "fails without a block" do
-    expect{an_audible_object.on :tapped}.to raise_error /No block supplied. How will I notify you?/
-  end
-
-  it "you can subscribe to multiple events at once and receive multiple notifications" do
-    notifications = 0
-    
-    an_audible_object.on(:poked, :tapped) do
-      notifications += 1
-    end
-
-    an_audible_object.poke
-    an_audible_object.tap
-
-    notifications.must === 2
-  end
-
-  # TEST: what about notification order?
-end
+require "spec_helper"
+
+describe "An audible object" do
+  let(:an_audible_object) do
+     an_audible_class = Class.new do
+      require "audible"; include Audible
+
+      def poke; notify :poked ; end
+      def tap ; notify :tapped; end
+
+      protected
+
+      def accepts?(e);
+        [:poked,:tapped].include? e
+      end
+    end.new
+  end
+
+  it "notifies of the event I ask for" do
+    notified = false
+
+    an_audible_object.on :poked do
+      notified = true
+    end
+
+    an_audible_object.poke
+
+    notified.must be_true
+  end
+
+  it "fails if the event does not match a supported one" do
+    expect{an_audible_object.on(:xxx_does_not_exist_xxx){}}.to raise_error /Event .+ not supported/
+  end
+
+  it "fails without a block" do
+    expect{an_audible_object.on :tapped}.to raise_error /No block supplied. How will I notify you?/
+  end
+
+  it "you can subscribe to multiple events at once and receive multiple notifications" do
+    notifications = 0
+    
+    an_audible_object.on(:poked, :tapped) do
+      notifications += 1
+    end
+
+    an_audible_object.poke
+    an_audible_object.tap
+
+    notifications.must === 2
+  end
+
+  # TEST: what about notification order?
+end

data/spec/{relaying_notifications → unit.tests/relaying_notifications}/about_the_notifications_spec.rb

@@ -1,69 +1,69 @@
-require "spec_helper"
-
-describe "The relayed notifications" do
-  before :all do
-    an_audible_object = Class.new do
-      require "audible"; include Audible
-
-      def poke; notify :poked, {:a => "1", :b => "2"}; end
-    end.new
-
-    a_relaying_class = Class.new do
-      require "audible"; include Audible
-      
-      def initialize(inner)
-        @inner = inner
-        relay @inner, :poked
-      end 
-    end
-
-    a_relaying_object = a_relaying_class.new(an_audible_object)
-
-    a_relaying_object.on :poked do |e,args| 
-      @relayed_notification,@relayed_args = e,args
-    end
-
-    an_audible_object.poke
-  end
-
-  it ("notifies with the same name")      { expect(@relayed_notification).to eql :poked }
-  it ("notifies with the same arguments") { expect(@relayed_args.first).to eql({:a => "1", :b => "2"}) }
-end
-
-describe "You can rename the relayed notification to something else" do
-  let :an_audible_object do 
-    Class.new do
-      require "audible"; include Audible
-
-      def poke; notify :poked; end
-    end.new
-  end
-  
-  before do
-    a_relaying_class = Class.new do
-      require "audible"; include Audible
-      
-      def initialize(inner)
-        relay inner, :poked, :as => :any_new_name
-      end 
-    end
-
-    @a_relaying_object = a_relaying_class.new(an_audible_object)
-  end
-
-  it "notifies with the new name and suppresses the original" do
-    @a_relaying_object.on :poked do |e,args| 
-      fail "Expected the <:poked> notification to be suppressed"
-    end
-
-    @a_relaying_object.on :any_new_name do |e,args| 
-      notified = true
-    end
-
-    notified = false
-
-    an_audible_object.poke
-    
-    expect(:notified).to be_true, "Expected to be notified with <#{:any_new_name}>"
-  end
-end
+require "spec_helper"
+
+describe "The relayed notifications" do
+  before :all do
+    an_audible_object = Class.new do
+      require "audible"; include Audible
+
+      def poke; notify :poked, {:a => "1", :b => "2"}; end
+    end.new
+
+    a_relaying_class = Class.new do
+      require "audible"; include Audible
+      
+      def initialize(inner)
+        @inner = inner
+        relay @inner, :poked
+      end 
+    end
+
+    a_relaying_object = a_relaying_class.new(an_audible_object)
+
+    a_relaying_object.on :poked do |e,args| 
+      @relayed_notification,@relayed_args = e,args
+    end
+
+    an_audible_object.poke
+  end
+
+  it ("notifies with the same name")      { expect(@relayed_notification).to eql :poked }
+  it ("notifies with the same arguments") { expect(@relayed_args.first).to eql({:a => "1", :b => "2"}) }
+end
+
+describe "You can rename the relayed notification to something else" do
+  let :an_audible_object do 
+    Class.new do
+      require "audible"; include Audible
+
+      def poke; notify :poked; end
+    end.new
+  end
+  
+  before do
+    a_relaying_class = Class.new do
+      require "audible"; include Audible
+      
+      def initialize(inner)
+        relay inner, :poked, :as => :any_new_name
+      end 
+    end
+
+    @a_relaying_object = a_relaying_class.new(an_audible_object)
+  end
+
+  it "notifies with the new name and suppresses the original" do
+    @a_relaying_object.on :poked do |e,args| 
+      fail "Expected the <:poked> notification to be suppressed"
+    end
+
+    @a_relaying_object.on :any_new_name do |e,args| 
+      notified = true
+    end
+
+    notified = false
+
+    an_audible_object.poke
+    
+    expect(:notified).to be_true, "Expected to be notified with <#{:any_new_name}>"
+  end
+end

data/spec/{relaying_notifications → unit.tests/relaying_notifications}/can_relay_notifications_spec.rb

@@ -1,43 +1,43 @@
-require "spec_helper"
-
-describe "Relaying notifications" do
-  let(:an_audible_object) do
-     an_audible_class = Class.new do
-      require "audible"; include Audible
-
-      def poke; notify :poked ; end
-      def tap ; notify :tapped; end
-
-      protected
-
-      def accepts?(e);
-        [:poked,:tapped].include? e
-      end
-    end.new
-  end
-
-  let(:a_relaying_class) do
-    Class.new do
-      require "audible"; include Audible
-      
-      def initialize(inner)
-        @inner = inner
-        relay @inner, :poked
-      end 
-    end
-  end
-
-  it "can be asked to relay requests" do
-    notified = false
-
-    a_relaying_object = a_relaying_class.new(an_audible_object)
-
-    a_relaying_object.on(:poked){ notified = true } 
-
-    an_audible_object.poke
-
-    expect(notified).to be_true, "Expected the notification to have been relayed"
-  end
-
-  it "can be asked to rename the notification to something else"
-end
+require "spec_helper"
+
+describe "Relaying notifications" do
+  let(:an_audible_object) do
+     an_audible_class = Class.new do
+      require "audible"; include Audible
+
+      def poke; notify :poked ; end
+      def tap ; notify :tapped; end
+
+      protected
+
+      def accepts?(e);
+        [:poked,:tapped].include? e
+      end
+    end.new
+  end
+
+  let(:a_relaying_class) do
+    Class.new do
+      require "audible"; include Audible
+      
+      def initialize(inner)
+        @inner = inner
+        relay @inner, :poked
+      end 
+    end
+  end
+
+  it "can be asked to relay requests" do
+    notified = false
+
+    a_relaying_object = a_relaying_class.new(an_audible_object)
+
+    a_relaying_object.on(:poked){ notified = true } 
+
+    an_audible_object.poke
+
+    expect(notified).to be_true, "Expected the notification to have been relayed"
+  end
+
+  it "can be asked to rename the notification to something else"
+end