ElmerFudd 0.0.16 → 0.0.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b0a9e56b47b2a3224efee44e0894318ff7cb50db
-  data.tar.gz: 4c8376e193f1c4ed12520de23e62413e2c209d09
+  metadata.gz: f89c5aa3e2803b6edc3e45dd83d5ffc802cf9383
+  data.tar.gz: 6cd2713cfe25845a75b0ad6753d51eee8ce499e7
 SHA512:
-  metadata.gz: f322698221ab861fa282c3f1ab6067b2ac573d69c99f483385156917eb89d6bab5d6b3c239e0a3cac84268dc8891a37680ce9509384448bb4dd4a0b7d44d91d4
-  data.tar.gz: c2380012566f40b60988ea0051ff7626263fd05c4553f277f263415013bfa976517bb374ef73c1495e64e8e06ea34f88b752f7d0488b8962cf514d4798393e94
+  metadata.gz: 7009b94e28241492449ba49498c5e01f6cb6d55f2d3839cdd966cfcbfd976fe5e01bcea606a76ece1490fdd6139afaf3bad93794e562050a6687b2d9c699c48c
+  data.tar.gz: d4761b1312202cbe4359e980c3334fbdf4643cca6e0e16549cd03ad374f81a13a754584e95283c5f42aa8c677a93cab1e19e2327a7e61fc58a053e2dc6ba1d04

data/ElmerFudd.gemspec

@@ -18,7 +18,7 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "bunny"
+  spec.add_dependency "bunny", '>= 1.6.3'
   spec.add_development_dependency "bundler", "~> 1.5"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"

data/README.md

@@ -22,7 +22,83 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+### Consumer
+
+```ruby
+#!/usr/bin/env ruby
+# Example app/worker/test_worker.rb in rails
+
+require_relative "../../config/environment"
+
+class TestLogger
+  def initialize(stream)
+    @stream = stream
+  end
+
+  def call(_env, message)
+    @stream.puts "[#{Time.now}] received on #{message.delivery_info.routing_key} payload: #{message.payload.inspect}"
+  end
+end
+
+class TestWorker < ElmerFudd::Worker
+  default_filters(ElmerFudd::JsonFilter)
+
+  handle_cast(Route('test.print')) do |env, message|
+    puts "message: #{message.payload["text"]"
+  end
+
+  handle_call(Route('test.ping')) do |env, message|
+    "pong: #{message.payload["text"]"
+  end
+
+  handle_call(Route('test.ping')) do |env, message|
+    "pong: #{message.payload["text"]"
+  end
+
+  handle_event(Route('test.log', 'a_topic_exchange' => 'test.#'),
+               handler: TestLogger.new($stdout))
+end
+
+if $PROGRAM_NAME == __FILE__
+  trap("TERM", "DEFAULT") { exit 0 }
+  $connection = Bunny.new
+  TestWorker.new($connection, concurrency: 4).start
+  loop { sleep(1) }
+end
+```
+
+### Producer
+
+```ruby
+$connection = Bunny.new
+$rabbit = ElmerFudd::JsonPublisher.new($connection)
+
+$rabbit.cast('test.print', text: 'hello') # will print "message: hello"
+
+$rabbit.call('test.ping', text: 'echo') #=> "pong: echo"
+
+$rabbit.notify('a_topic_exchange', 'test.log.some.event', count: 1) # will print "[current time here] received on test.log.some.event payload: {count: 1}"
+```
+
+### Filters
+
+Filters allow to mutate an incoming message in consumer before it hits appropiate handler or to modify return value (or handle errors) after the handler finishes its job. You can define default filters which will be applied to all handlers in consumer or activate them on handler level by passing filters list as a param, i.e.:
+
+```ruby
+handle_cast(Route('math.divide')
+            filter: [DropFailedFilter.new(exception: ZeroDivisionError)]) do |env, message|
+    puts "#{payload['a'] / payload['b']}"
+end
+```
+
+#### Available filters
+
+* `JsonFilter` - deserializes incoming messages using json and serializes call responses to json
+* `DropFailedFilter.new(exception: Exception, exception_message_matches: /.*/)` - ignore the message if handler raises matching exception
+* `AirbrakeFilter` - notify airbrake if handler raises exception and reraises it in filter chain
+* `ActiveRecordConnectionPoolFilter` - allows to use worker with higher concurrency (takes a connection from pool for each message)
+* `RetryFilter.new(2, exception: Exception, exception_message_matches: /.*/)` - retries 2 times if handler raises a matching exception
+
 
 ## Contributing
 

data/lib/ElmerFudd/version.rb

@@ -1,3 +1,3 @@
 module ElmerFudd
-  VERSION = "0.0.16"
+  VERSION = "0.0.17"
 end

data/lib/ElmerFudd.rb

@@ -95,7 +95,7 @@ module ElmerFudd
 
     def start
       self.class.handlers.each do |handler|
-        handler.queue(@env).subscribe(ack: true, block: false) do |delivery_info, properties, payload|
+        handler.queue(@env).subscribe(manual_ack: true, block: false) do |delivery_info, properties, payload|
           message = Message.new(delivery_info, properties, payload, handler.route)
           begin
             handler.call(@env, message)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ElmerFudd
 version: !ruby/object:Gem::Version
-  version: 0.0.16
+  version: 0.0.17
 platform: ruby
 authors:
 - Andrzej Sliwa
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-04 00:00:00.000000000 Z
+date: 2014-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bunny
@@ -17,14 +17,14 @@ dependencies:
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.6.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.6.3
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -109,7 +109,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.2
 signing_key: 
 specification_version: 4
 summary: RabbitMQ in OTP way