action_subscriber 3.0.0.pre2 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f453f7e59eee1009c949b5e395359dc59b637c5f
-  data.tar.gz: 426ef40b324f3770306f790b3f03673905670a23
+  metadata.gz: 52c0f3db37ebe4b428841306b9adba37f2f39a58
+  data.tar.gz: c02900ab22466a4cd485a39530379cd215aae0e5
 SHA512:
-  metadata.gz: b644cb531eacde80a9f7878fcfeb3c50925b70dc5bafdf3d753462a505883645e7bf81220e727aac99b399a82e9951df276676e9a12d20e903a22dd72132df65
-  data.tar.gz: 410c264a22022b14a2fe4a7a44674c184b982dcd9562b5e2966def02b12043ee3fe6f27387b139820f32e5cdd1e53edcc3d4af42b954d3e8a139c9ce5cad6af2
+  metadata.gz: 3859b7e0dded455b94130370401011037f7a9d1cfad814aedca554134bc33a0272fa9c87d3a070c5a6336e81451aaddf5a8c8a2046bf8784c9335980b047da37
+  data.tar.gz: d39b119f253a6bbee3f3150d0936e8f5ddacb71f02df0641304c084ca1d8a1b6e3d3ae0d3bc2f69f370e8793199f8305adfd7295f46645d3ebaecb39427e26ec

data/README.md

@@ -24,8 +24,6 @@ A subscriber is set up by creating a class that inherits from ActionSubscriber::
 
 ```ruby
 class UserSubscriber < ::ActionSubscriber::Base
-  publisher :user_hq
-
   def created
     # do something when a user is created
   end
@@ -36,35 +34,29 @@ checkout the examples dir for more detailed examples.
 
 Usage
 -----------------
-ActionSubscriber is inspired by rails observers, and if you are familiar with rails
-observers the ActionSubscriber DSL should make you feel right at home!
-
-First, create a subscriber the inherits from ActionSubscriber::Base
 
-Then, when your app starts up, you will need to load your subscriber code and then do
+In your application setup you will draw your subscription routes. In a rails app this is usually done in `config/initializers/action_subscriber.rb`.
 
 ```ruby
-ActionSubscriber.start_subscribers
-while true
-  sleep 1.0
+::ActionSubscriber.draw_routes do
+  # you can define routes one-by-one for fine-grained controled
+  route UserSubscriber, :created
+
+  # or you can setup default routes for all the public methods in a subscriber
+  default_routes_for UserSubscriber
 end
 ```
 
-or
+Now you can start your subscriber process with:
 
-```ruby
-::ActionSubscriber.start_queues
-while true
-  ::ActionSubscriber.auto_pop!
-  sleep 1.0
-end
+
+```
+$ bundle exec action_subscriber start --mode=subscribe
 ```
 
-Any public methods on your subscriber will be registered as queues with rabbit with
-routing keys named intelligently.
+This will start your subscribers in a mode where they connect to rabbitmq and let the broker push messages down to them.
 
-Once ActionSubscriber receives a message, it will call the associated method and the
-parameter you recieve will be a decoded message.
+You can also start in `--mode=pop` where your process will poll the broker for messages.
 
 Configuration
 -----------------
@@ -80,11 +72,11 @@ In an initializer, you can set the host and the port like this :
 Other configuration options include :
 
 * config.add_decoder - add a custom decoder for a custom content type
-* config.allow_low_priority_methods - subscribe to queues for methods suffixed with "_low"
 * config.default_exchange - set the default exchange that your queues will use, using the default RabbitMQ exchange is not recommended
 * config.error_handler - handle error like you want to handle them!
 * config.heartbeat - number of seconds between hearbeats (default 5) [see bunny documentation for more details](http://rubybunny.info/articles/connecting.html)
-* config.hosts - an array of hostnames in your cluster
+* config.hosts - an array of hostnames in your cluster (ie `["rabbit1.myapp.com", "rabbit2.myapp.com"]`)
+* config.pop_interval - how long to wait between polling for messages in `--mode=pop`. It should be a number of milliseconds
 * config.threadpool_size - set the number of threads availiable to action_subscriber
 * config.timeout - how many seconds to allow rabbit to respond before timing out
 * config.times_to_pop - when using RabbitMQ's pull API, the number of messages we will grab each time we pool the broker

data/lib/action_subscriber/version.rb

@@ -1,3 +1,3 @@
 module ActionSubscriber
-  VERSION = "3.0.0.pre2"
+  VERSION = "3.0.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: action_subscriber
 version: !ruby/object:Gem::Version
-  version: 3.0.0.pre2
+  version: 3.0.0
 platform: ruby
 authors:
 - Brian Stien
@@ -12,7 +12,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-20 00:00:00.000000000 Z
+date: 2016-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -280,9 +280,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.6.6