pwwka 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c195d91e8fc1f10c07a903840900b6e4fc1907ec
-  data.tar.gz: 7d429e0e5d3431f214ac8985299afc3884e3e82e
+  metadata.gz: 65628463d1a49c21c4d625717b05aee5867b0b0b
+  data.tar.gz: 8bc5ab193a6ddee8b94118d443c4b88d38e7a11f
 SHA512:
-  metadata.gz: 6ac4140dff8b136fc8b432625c787ce4132c4ce85057678e59acd57ef0475dcf3f676808c62d7c446770b52b732e524dcccbcaa4b6423f1d7f215272da547f47
-  data.tar.gz: fcdfbe94f023dd4a471301636acca4d61b182324b8ea521cc6f2175467c78cd7795785abecdb1036e496b2d2b37f02c99dab91f5ba47b18e3a62bc8a4dd78b93
+  metadata.gz: 14a4657dd79e421d4a9b61f382da7d827042b98a4a0d91f63eb54e24a66ee5803bde96114ec52f7b48e8a0c77fc8777f07e67de2ae72c8f813e19b635cf0cb7b
+  data.tar.gz: ba321ef6cbf41a02e4052cb978b86c9293e24e5868f577b41c16875c0781b7dc9e8cf11f3272f8bee73a6f4aeaa4a8bd2413ea787ab59f1c36060cf8061942a9

data/CONTRIBUTING.md

@@ -0,0 +1,15 @@
+
+## Contributing
+
+We're actively using Pwwka in production here at [Stitch Fix](http://technology.stitchfix.com/) and look forward to seeing Pwwka grow and improve with your help. Contributions are warmly welcomed.
+
+To contribute, 
+1. make a fork of the project
+2. write some code (with tests please!) 
+3. open a Pull Request	
+4. bask in the warm fuzzy Open Source hug from us
+
+## Testing
+<a name="testing"></a>
+
+You must be running RabbitMQ locally on the default port in order for the tests to work.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    pwwka (0.3.0)
+    pwwka (0.3.1)
       activemodel
       activesupport
       bunny

data/README.md

@@ -1,3 +1,13 @@
+# Pwwka
+
+
+Pronounced "Poo-ka" |ˈpo͞okə|
+
+![Pwwka Bunny Bus](http://res.cloudinary.com/stitch-fix/image/upload/c_scale,w_317/v1408570794/bunny-bus_ba72ou.png)
+
+---
+
+
 This gem connects to a topic exchange on a RabbitMQ server. It gives any app using it the ability to do two things:
 
 * Transmit messages to the exchange
@@ -154,9 +164,10 @@ The available wildcards are as follows
 
 __A note on re-queuing:__ At the moment messages that raise an error on receipt are marked 'not acknowledged, don't resend', and the failure message is logged. All unacknowledged messages will be resent when the worker is restarted. The next iteration of this gem will allow for a specified number of resends without requiring a restart.
 
-__Spinning up some new dynos to handle the load:__ Since each named queue will receive each message only once you can spin up multiple process using the *same named queue* and they will share the messages between them. If you spin up three processes each will receive roughly one third of the messages, but each message will still only be received once.
+__Spinning up some more handlers to handle the load:__ Since each named queue will receive each message only once you can spin up multiple process using the *same named queue* and they will share the messages between them. If you spin up three processes each will receive roughly one third of the messages, but each message will still only be received once.
 
 ### Handlers
+
 Handlers are simple classes that must respond to `self.handle!`. The receiver will send the handler three arguments:
 
 * `delivery_info` - [a bunch of stuff](http://rubybunny.info/articles/queues.html#accessing_message_delivery_information)
@@ -168,7 +179,6 @@ Here is an example:
 ```ruby
 class ClientIndexMessageHandler
   
-  attr_reader :payload
   def initialize(payload)
     @payload = payload
   end
@@ -189,19 +199,25 @@ end
 ```
 
 ## Monitoring
+
 RabbitMQ has a good API that should make it easy to set up some simple monitoring. In the meantime there is logging and manual monitoring.
 
 ### Logging
+
 The receiver logs details of any exception raised in message handling:
+
 ```ruby
 error "Error Processing Message on #{queue_name} -> #{payload}, #{delivery_info.routing_key}: #{e}"
 ```
-.The transmitter will likewise log an error if you use the `_safely` methods:
+
+The transmitter will likewise log an error if you use the `_safely` methods:
+
 ```ruby
 error "Error Transmitting Message on #{routing_key} -> #{payload}: #{e}"
 ```
 
 ### Manual monitoring
+
 RabbitMQ has a web interface for checking out the health of connections, channels, exchanges and queues. Access it via the Heroku add-ons page for Enigma.
 
 ![RabbitMQ Management 1](docs/images/RabbitMQ_Management.png)
@@ -251,8 +267,19 @@ describe "my integration test" do
 end
 ```
 
-## TODO
-* automated monitoring
-* forking
-* resending
-* handling messages from inside transactions properly
+The pwwka gem has tests for all its functionality, so testing your app is best done with mocks on this gem. 
+
+However, if you want to test the message bus end-to-end in your app you can use some helpers in `lib/pwwka/test_handler.rb`. See this gem's specs for examples of how to use them.
+
+[See CONTRIBUTING.md for details on testing this gem](CONTRIBUTING.md#testing)
+
+## Contributing
+
+We're actively using Pwwka in production here at [Stitch Fix](http://technology.stitchfix.com/) and look forward to seeing Pwwka grow and improve with your help. Contributions are warmly welcomed.
+
+[See CONTRIBUTING.md for details](CONTRIBUTING.md)
+
+## Licence
+
+Pwwka is released under the [MIT License](http://www.opensource.org/licenses/MIT).
+

data/lib/pwwka/test_handler.rb

@@ -65,8 +65,10 @@ module Pwwka
       test_queue.delete
       channel_connector.topic_exchange.delete
       # delayed messages
-      channel_connector.delayed_queue.delete
-      channel_connector.delayed_exchange.delete
+      unless Pwwka.configuration.allow_delayed?
+        channel_connector.delayed_queue.delete
+        channel_connector.delayed_exchange.delete
+      end
 
       channel_connector.connection_close 
     end

data/lib/pwwka/version.rb

@@ -1,3 +1,3 @@
 module Pwwka
-  VERSION = '0.3.0'
+  VERSION = '0.3.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pwwka
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Stitch Fix Engineering
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-24 00:00:00.000000000 Z
+date: 2014-10-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bunny
@@ -107,6 +107,7 @@ files:
 - ".gitignore"
 - ".ruby-gemset"
 - ".ruby-version"
+- CONTRIBUTING.md
 - Gemfile
 - Gemfile.lock
 - README.md
@@ -151,7 +152,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.0
+rubygems_version: 2.2.0.rc.1
 signing_key: 
 specification_version: 4
 summary: Send and receive messages via RabbitMQ