wisper_subscription 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 912d8f12cd963ba1e732752590ca8c86022fae28
-  data.tar.gz: 71b57abd56add0f8163f9757d17589893844fdcd
+  metadata.gz: cb3e3d3ee397931293ca4b2a84b98d8c49017048
+  data.tar.gz: b4cb1bb9c49d9c9adbeb6f144f8a8501d0458935
 SHA512:
-  metadata.gz: 5dc155254a0c2aebc81902f451be952d8d3cd2b4c4b54a3218be998dcd4bc6c1d5861fa36cd8669f8dee5556ebc979abdf329cf809f62ce43855362889e95580
-  data.tar.gz: 36759f7dad409e02d1d1713bf8f293603a60f11e1e01373885e92f02242802edcac2d6b115c215b39f6374ff6dbe1350c87ca991a4e4839627ce8e14700f3bc8
+  metadata.gz: d0c41b7a09ad91f941282bff92b75ad72f39226c2bf0d51c791660b4400235d38b0f6f654ee05663a9c13ab969cfd4f92e5d7758dc1a0a60ad4fd41f494c2f4b
+  data.tar.gz: 2d3d19cc13c6714b7bd754912e0610ab342671f0cd27a9f3d27d8898bebdbb938533ef9ac709adcf19a9cabe8830431bff1c4bdae3c12778e6528b02c7351712

data/README.md

@@ -54,21 +54,76 @@ describe SomeWisperPublishingClass do
   before :each do
     # some setup
     subscriber.define_message :success
-    subscriber.define_Message :failure
+    subscriber.define_message :failure
     command.subscribe subscriber
     command.do_something_that_broadcasts_a_success
   end
 
   it 'was successful' do
-    payload = subscriber.payload_for(:success).to_a.first
-    expect(payload).to be_a WhatYouExpectOnSuccess # as opposed to nil
+    payload = subscriber.payload_for(:success, 0)
+    expect(payload.first).to be_a WhatYouExpectOnSuccess # as opposed to nil
   end
 
   # ...
 end
 ```
 
-You get the idea. If not, open an issue or ask on our Gitter channel.
+You get the idea. If not, open an issue or ask on our
+[Gitter channel](https://gitter.im/jdickey/wisper_subscription).
+
+### Methods
+
+#### `initialize`
+
+Parameters: none.
+
+Initialises instance internal state.
+
+#### `define_message(message)`
+
+Parameters:
+
+1. `message` (a Symbol; e.g., `:bangbang`)
+
+Returns: `self`
+
+Defines a *listener method* (e.g., `#bangbang`) to receive events published by a
+[Wisper publisher](https://github.com/krisleech/wisper/#publishing) or similar
+mechaism. Any parameters a listener method is called with will be retreivaable
+by using the `#payload_for` or `#payloads_for` methods (see below).
+
+Defines a query method (e.g., `#bangbang?`) which returns `true` if payloads for
+the message have been received; `false` otherwise.
+
+#### `payloads_for(message)`
+
+Parameters:
+
+1. `message` (a Symbol, e.g., `:bangbang`)
+
+Returns: an Array
+
+Returns an Array of all *payloads* received by the listener method corresponding
+to the parameter. If no calls to the listener method have been made, *or* if the
+listener method has not been defined because `#define_message` has not been
+called using that `message`, then an empty Array is returned.
+
+#### `payload_for(message, index = 0)`
+
+Parameters:
+
+1. `message` (a Symbol, e.g., `:bangbang`)
+1. `index` (an integer, defaulting to 0)
+
+Returns: an Array or `nil`
+
+Returns an Array containing the *payload* received by the `index`th invocation
+of the listener method (zero-based). A *payload* is simply the set of (zero or)
+more) parameters sent to the listener method. If no calls to the listener method
+have been made, *or* if the listener method has not been defined because
+`#define_message` has not been called using that `message`, then this method
+returns `nil`. If the listener method *has* been defined but the specified index
+is outside the range of received payloads, then returns an empty Array.
 
 ## Contributing
 

data/lib/wisper_subscription.rb

@@ -1,6 +1,8 @@
 
 require 'wisper_subscription/version'
 
+require 'awesome_print'
+
 # Collects and reports on messages sent to an instance.
 class WisperSubscription
   def initialize
@@ -13,11 +15,16 @@ class WisperSubscription
     @message = message
     add_internals_entry
     add_query_method
-    add_responder_method
+    add_listener_method
     self
   end
 
-  def payload_for(message)
+  def payload_for(message, index = 0)
+    return nil unless @internals.key? message
+    payloads_for(message)[index]
+  end
+
+  def payloads_for(message)
     return empty_payload unless @internals.key? message
     @internals[message]
   end
@@ -49,7 +56,7 @@ class WisperSubscription
     self
   end
 
-  def add_responder_method
+  def add_listener_method
     message = @message
     define_singleton_method @message.to_sym do |*params|
       @internals[message].push params

data/lib/wisper_subscription/version.rb

@@ -1,5 +1,5 @@
 
 # Collects and reports on messages sent to an instance.
 class WisperSubscription
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

data/spec/spec_helper.rb

@@ -7,4 +7,7 @@ end
 
 $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
 
+require 'awesome_print'
+require 'pry'
+
 require 'wisper_subscription'

data/spec/wisper_subscription_spec.rb

@@ -69,8 +69,62 @@ describe WisperSubscription do
   end # describe '#define_message'
 
   describe '#payload_for' do
+    describe 'accepts two parameters, with' do
+      let(:method) { described_class.new.method :payload_for }
+
+      it 'the first, :message, being required' do
+        expect(method.parameters.count).to eq 2
+        expect(method.parameters.first).to eq [:req, :message]
+      end
+
+      it 'the second, :index, being optional' do
+        expect(method.parameters.last).to eq [:opt, :index]
+      end
+    end # describe 'accepts two parameters, with'
+
+    describe 'returns nil when' do
+      it 'no messages have been defined' do
+        expect(obj.payload_for message).to eq nil
+      end
+
+      it 'the specified message has been defined but not received' do
+        obj.define_message other_message
+        expect(obj.payload_for message).to eq nil
+      end
+
+      it 'the specified index exceeds the range of received messages' do
+        obj.define_message message
+        obj.send message, 'foo'
+        expect(obj.payload_for message, 52).to eq nil
+      end
+    end # describe 'returns nil when'
+
+    context 'when the message was received and the index is in range' do
+      before :each do
+        obj.define_message message
+      end
+
+      it 'returns an Array containing the specified payload when supplied' do
+        obj.send message, 'foo'
+        expect(obj.payload_for message, 0).to eq ['foo']
+      end
+
+      it 'returns an empty Array if no payload for the message was specified' do
+        obj.send message
+        expect(obj.payload_for message, 0).to eq []
+      end
+    end # context 'when the message was received and the index is in range'
+
+    fit 'uses zero as a default for the second (index) parameter' do
+      obj.define_message message
+      [:foo, :bar, :baz].each { |payload| obj.send message, payload }
+      expect(obj.payload_for message).to eq [:foo]
+    end
+  end # describe '#payload_for'
+
+  describe '#payloads_for' do
     it 'takes a single parameter' do
-      method = obj.method :payload_for
+      method = obj.method :payloads_for
       expect(method.arity).to eq 1
     end
 
@@ -78,7 +132,7 @@ describe WisperSubscription do
       let(:none_received) { [] }
 
       after :each do
-        expect(obj.payload_for message).to eq none_received
+        expect(obj.payloads_for message).to eq none_received
       end
 
       it 'no messages have been defined' do
@@ -94,14 +148,31 @@ describe WisperSubscription do
     end # describe 'returns a no-payloads-received indicator when'
 
     describe 'returns the payload(s) received for the specified message when' do
-      it 'payloads for that message have been stored' do
+      before :each do
         obj.define_message message
-        expected = 'testing'
-        obj.instance_variable_get(:@internals)[message].push expected
-        expect(obj.payload_for message).to eq Array.new([expected])
+      end
+
+      it 'a single payload for that message has been stored' do
+        expected = %w(This is a test.)
+        obj.send message, *expected
+        payloads = obj.payloads_for message
+        expect(payloads).to be_an Array
+        expect(payloads.count).to eq 1 # One payload has been delivered
+        payload = payloads.first
+        expect(payload.count).to eq expected.count
+        expect(payload).to eq expected
+      end
+
+      it 'multiple payloads for that message have been stored' do
+        obj.send message, 'one'
+        obj.send message, 'two', 'three'
+        payloads = obj.payloads_for message
+        expect(payloads.count).to eq 2 # Two payloads delivered
+        expect(payloads.first).to eq ['one']
+        expect(payloads.last).to eq %w(two three)
       end
     end # describe 'returns the payload(s) received for the ... message when'
-  end # describe '#payload_for'
+  end # describe '#payloads_for'
 
   describe '#respond_to?' do
     it 'returns true for any query method' do

data/wisper_subscription.gemspec

@@ -23,9 +23,9 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency 'rubocop', '>= 0.28.0'
   spec.add_development_dependency 'simplecov', '>= 0.9.1'
-  # spec.add_development_dependency 'awesome_print'
-  # spec.add_development_dependency 'pry-byebug'
-  # spec.add_development_dependency 'pry-doc'
+  spec.add_development_dependency 'awesome_print'
+  spec.add_development_dependency 'pry-byebug'
+  spec.add_development_dependency 'pry-doc'
 
   spec.description   = %q{May be used to subscribe to Wisper broadcasts, or other
 similar mechanisms. Define what messages you want an instance to respond to and,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: wisper_subscription
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Jeff Dickey
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-29 00:00:00.000000000 Z
+date: 2015-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -80,6 +80,48 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  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: pry-byebug
+  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: pry-doc
+  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'
 description: |-
   May be used to subscribe to Wisper broadcasts, or other
   similar mechanisms. Define what messages you want an instance to respond to and,
@@ -131,3 +173,4 @@ summary: Records and reports messages sent using Wisper conventions.
 test_files:
 - spec/spec_helper.rb
 - spec/wisper_subscription_spec.rb
+has_rdoc: