insque 0.5.1 → 0.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: db352d3e0afe2bfd0243f0e9cd15a905226ae4fe
-  data.tar.gz: 9ea0abcc665e264a0c51d1be4a20a9ba3e8d1ce7
+  metadata.gz: 01104bacbddad2fd85675e9f242aea346d3101c9
+  data.tar.gz: a3debfd746d82c059abf4f6423f1aa9bb2f6baf4
 SHA512:
-  metadata.gz: cf57b0954f22ce0f5628df247942a732af6b4e61fab2b85667651107408091703f7ec733eaed175cd9f54911ca665a5c6d9dffebb55c06beb7c0de9a6c129970
-  data.tar.gz: 2c2d5ae8ba1839d06b2f50519754c38ec2476178a88805570b099f32c63c95edcd4d3e91be05c30e4ed183edd862052b1b64cc8593281021419372b7dcd53663
+  metadata.gz: 8d2e64b82459b0268286ec5c9d2e9dd5209f58e99dbd8ac70f0bb734886e7f607b6cd0c4a2e3e40efd79552629e2791193fda349432f26c9cd0267f72b418a1c
+  data.tar.gz: 4240f9fb0a74cae2a5bf7b416b8ecc506d8fad44bf83562af008ecbc97d1c51bb505c4436dbf882c02f9edfc8cd31d3e9de5cc8ed42be999c3ca3d7ed0642246

data/README.md

@@ -41,29 +41,66 @@ There is an easy way to use insque as background jobs processing. You can use `s
 To start recieving messages you need to:
 
 1. Create handler method in Insque module. First part of handler name is the name of the message sender.
-```ruby
-def somesender_message_name message
-  #TODO: Handle message somehow
-end
-```
+    ```ruby
+    def somesender_message_name message
+      #TODO: Handle message somehow
+    end
+    ```
 
 2. Call `listen` method in some background process or rake task:
-```ruby
-Insque.listen
-```
+    ```ruby
+    Insque.listen
+    ```
 
    or just run `bundle exec rake insque:listener` from your console.
 
 3. Call `janitor` method in some background process or rake task. Janitor will reissue failed messages or report error if message fails again. Janitor treats message as failed if it was not processed for an hour after broadcast or reissue.
+    ```ruby
+    Insque.janitor
+    ```
+
+   or just run `bundle exec rake insque:janitor` from your console.
+
+### Slow Queue and send_later
+
+Insque can be used for processing slow tasks in background. Slow tasks created with send_later method call of any ActiveRecord model:
 ```ruby
-Insque.janitor
+User.send_later :some_slow_method
 ```
+and processed by a special slow listener:
+```ruby
+Insque.slow_listen
+```
+there is matching slow janitor as well:
+```ruby
+Insque.slow_janitor
+```
+### insque:run
 
-   or just run `bundle exec rake insque:janitor` from your console.
+There is a simple way to run all insque workers, both regular and slow in a single multi-threaded process:
+```ruby
+bundle exec rake insque:run
+```
+
+### RedisCluster support
+
+To make insque run on Redis Cluster add this line to your application's `Gemfile`:
+
+    gem 'redis_cluster'
+    
+and change `redis.yml` file accordingly:
+
+    production:
+    - host: cluster_host1
+      port: 1234
+    - host: cluster_host2
+      port: 1234
+    - host: cluster_host3
+      port: 1234
 
 ### Daemonizing
 
-If you want to run insque listener as a daemon consider using [foreman](https://github.com/ddollar/foreman) for this. 
+If you want to run insque as a daemon consider using [foreman](https://github.com/ddollar/foreman) for this. 
 
 If you deploy with capistrano you may want to try a version of foreman with build in capistrano support.
 
@@ -78,8 +115,8 @@ Install it:
 
 Create `Procfile`:
 
-    listener: bundle exec rake insque:listener
-    janitor: bundle exec rake insque:janitor
+    insque: bundle exec rake insque:run
+
 
 Run foreman from your console:
     
@@ -88,7 +125,7 @@ Run foreman from your console:
 For production use modify your capistrano deploy script somewhat like this:
     
     set :default_environment, {'PATH' => "/sbin:$PATH"}  # Optional. Useful if you get errors because start or restart command not found
-    set :foreman_concurrency, "\"listener=2,janitor=1\"" # How many processes of each type do you want
+    set :foreman_concurrency, "\"insque=1\"" # How many processes of each type do you want
     require 'foreman/capistrano'
     
     after "deploy", "foreman:export"  # Export Procfile as a set of upstart jobs

data/lib/generators/insque/templates/insque.erb

@@ -1,4 +1,4 @@
 Insque.sender = '<%= sender_name %>'
 REDIS_CONFIG = YAML.load(File.open("#{Rails.root}/config/redis.yml"))[Rails.env]
-Insque.redis_config = { :host => REDIS_CONFIG["host"], :port => REDIS_CONFIG["port"] }
+Insque.redis_config = REDIS_CONFIG
 Insque.debug = true

data/lib/insque/version.rb

@@ -1,3 +1,3 @@
 module Insque
-  VERSION = "0.5.1"
+  VERSION = "0.5.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: insque
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.5.2
 platform: ruby
 authors:
 - gropher