rabbit_feed 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8ada150cba6130fe7df806147c44d20e72027c95
-  data.tar.gz: 4ca751e89bf9e476fb622e6db31660b59faeca53
+  metadata.gz: c8b4cfaedb7bc8c46cdd3e688e2e056433bd890f
+  data.tar.gz: 70f7da80ecb2066defee294ddd9268769306045d
 SHA512:
-  metadata.gz: 807446c806430a173ef49307e3a4ca7a1afc22f9bc041e724ec17f208dbd638fb38f0fb85b83d853e3f75fb5f1dd2126ced965f795b9fb849c06f39ffe774ebc
-  data.tar.gz: cd35aefc408cebbe6e7094335d9d113c7fabbedb11420878a78782748ba6ab01f7c17649c15ef975571ef7964221959478a4c4a607d1eade1310a2f9fe6f761b
+  metadata.gz: 441226227941a4caf225cdf2ba70cae72d0dfbcbf0bf0460fc42920ab2384b79a94bf218e344d10eaa177260a9058f4f3e5896d617dcbcb757e72a1e6b41c31e
+  data.tar.gz: 310e32a94ebde5f1d6cac89841d677099e6f7705af33a11a7252ae74587d55d545448a320db546adabdfa0c897106e0e668b0c436f4d003accaf75f915ff3c85

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rabbit_feed (2.0.0)
+    rabbit_feed (2.1.0)
       activemodel (>= 3.2.0, < 5.0.0)
       activesupport (>= 3.2.0, < 5.0.0)
       avro (>= 1.5.4, < 1.8.0)

data/README.md

@@ -308,6 +308,26 @@ When the consumer is started, it will create its queue named using this pattern:
 
 _Note: The consumer queues will automatically expire (delete) after 7 days without any consumer connections. This is to prevent unused queues from hanging around once their associated consumer has been terminated._
 
+### Wildcards
+
+Applications that wish to handle events from any application or wish to handle any event can achieve this using the `:any` key.
+
+For example, the following would consume any event published by RabbitFeed:
+
+```ruby
+EventRouting do
+  accept_from(:any) do
+    event(:any) do |event|
+      puts event.payload
+    end
+  end
+end
+```
+
+In this example, the consumer queue will bind to the specified exchange on the following routing keys:
+
+    environment.*.*
+
 ## Delivery Semantics
 
 RabbitFeed provides 'at least once' delivery semantics. There are two use-cases where an event may be delivered more than once:

data/example/non_rails_app/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ../../
   specs:
-    rabbit_feed (2.0.0)
+    rabbit_feed (2.1.0)
       activemodel (>= 3.2.0, < 5.0.0)
       activesupport (>= 3.2.0, < 5.0.0)
       avro (>= 1.5.4, < 1.8.0)

data/example/rails_app/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ../../
   specs:
-    rabbit_feed (2.0.0)
+    rabbit_feed (2.1.0)
       activemodel (>= 3.2.0, < 5.0.0)
       activesupport (>= 3.2.0, < 5.0.0)
       avro (>= 1.5.4, < 1.8.0)

data/lib/rabbit_feed/event_routing.rb

@@ -33,39 +33,66 @@ module RabbitFeed
     class Application
       include ActiveModel::Validations
 
-      attr_reader :events, :name
+      attr_reader :named_events, :catch_all_event, :name
       validates_presence_of :name
 
       def initialize name
-        @name    = name
-        @events  = {}
+        @name         = name
+        @named_events = {}
 
         validate!
       end
 
       def event name, &block
-        event = (Event.new name, block)
-        events[event.name] = event
+        if name == :any
+          accept_any_event &block
+        else
+          accept_named_event name, &block
+        end
       end
 
       def accepted_routes
-        events.values.map do |event|
+        all_events.map do |event|
           "#{RabbitFeed.environment}.#{name}.#{event.name}"
         end
       end
 
       def handle_event event
-        event_rule = events[event.name]
+        event_rule = find_event event
         event_rule.handle_event event
       end
 
       def handles_event? event
-        events.has_key? event.name
+        (find_event event).present?
       end
 
+      private
+
       def validate!
         raise ConfigurationError.new "Bad application specification for #{name}: #{errors.messages}" if invalid?
       end
+
+      def accept_named_event name, &block
+        raise ConfigurationError.new "Routing has already been defined for the event with name: #{name} in application: #{self.name}" if (named_events.has_key? name)
+        event = (Event.new name, block)
+        named_events[event.name] = event
+      end
+
+      def accept_any_event &block
+        raise ConfigurationError.new "Routing has already been defined for the event catch-all: :any in application: #{name}" if catch_all_event.present?
+        event = (Event.new '*', block)
+        @catch_all_event = event
+      end
+
+      def find_event event
+        [named_events[event.name], catch_all_event].compact.first
+      end
+
+      def all_events
+        events = named_events.values
+        events << catch_all_event if catch_all_event.present?
+        events
+      end
     end
 
     attr_reader :named_applications, :catch_all_application

data/lib/rabbit_feed/version.rb

@@ -1,3 +1,3 @@
 module RabbitFeed
-  VERSION = '2.0.0'
+  VERSION = '2.1.0'
 end

data/spec/lib/rabbit_feed/event_routing_spec.rb

@@ -25,6 +25,11 @@ module RabbitFeed
             event.payload
           end
         end
+        accept_from('dummy_3') do
+          event(:any) do |event|
+            event.payload
+          end
+        end
       end
     end
 
@@ -36,6 +41,7 @@ module RabbitFeed
         test.dummy_2.event_3
         test.*.event_3
         test.*.event_4
+        test.dummy_3.*
       }
     end
 
@@ -46,6 +52,8 @@ module RabbitFeed
         Event.new({application: 'dummy_1', name: 'event_4'}, {payload: 4}),
         Event.new({application: 'dummy_2', name: 'event_3'}, {payload: 3}),
         Event.new({application: 'none',    name: 'event_4'}, {payload: 4}),
+        Event.new({application: 'dummy_3', name: 'event_1'}, {payload: 1}),
+        Event.new({application: 'dummy_3', name: 'event_2'}, {payload: 2}),
       ]
       events.each do |event|
         (RabbitFeed::Consumer.event_routing.handle_event event).should eq event.payload
@@ -112,7 +120,7 @@ module RabbitFeed
     context 'testing cumulative routing definitions' do
       before do
         EventRouting do
-          accept_from('dummy_3') do
+          accept_from('dummy_4') do
             event('event_4') do |event|
               event.payload
             end
@@ -125,9 +133,10 @@ module RabbitFeed
           test.dummy_1.event_1
           test.dummy_1.event_2
           test.dummy_2.event_3
-          test.dummy_3.event_4
+          test.dummy_4.event_4
           test.*.event_3
           test.*.event_4
+          test.dummy_3.*
         }
       end
     end
@@ -143,7 +152,7 @@ module RabbitFeed
               end
             end
           end
-        end.to raise_error ConfigurationError
+        end.to raise_error 'Routing has already been defined for the application with name: dummy_2'
       end
 
       it 'raises an exception for the catch-all application' do
@@ -155,7 +164,40 @@ module RabbitFeed
               end
             end
           end
-        end.to raise_error ConfigurationError
+        end.to raise_error 'Routing has already been defined for the application catch-all: :any'
+      end
+    end
+
+    context 'defining the same event twice' do
+
+      it 'raises an exception for a named event' do
+        expect do
+          EventRouting do
+            accept_from('dummy_5') do
+              event('event_3') do |event|
+                event.payload
+              end
+              event('event_3') do |event|
+                event.payload
+              end
+            end
+          end
+        end.to raise_error 'Routing has already been defined for the event with name: event_3 in application: dummy_5'
+      end
+
+      it 'raises an exception for the catch-all event' do
+        expect do
+          EventRouting do
+            accept_from('dummy_5') do
+              event(:any) do |event|
+                event.payload
+              end
+              event(:any) do |event|
+                event.payload
+              end
+            end
+          end
+        end.to raise_error 'Routing has already been defined for the event catch-all: :any in application: dummy_5'
       end
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rabbit_feed
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - Simply Business
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-03 00:00:00.000000000 Z
+date: 2015-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bunny