rapnd

rapnd is an easy-to-use daemon that opens a persistent connection to the Apple Push Notification servers and sends notifications you specify to Apple.

It intentionally has very little in the way of model-level assumptions: this daemon is intended only to send notifications and does almost nothing to validate the content of the notifications (besides ensuring that the length is correct and a device_token is provided). Your models should validate that the messages they send to rapnd conform to the behavior you expect.

Each rapnd daemon operates on a separate resque queue, and multiple daemons can service one queue. Thus you can use rapnd with multiple Apple certs (if you have multiple applications you’re trying to send notifications for) and, if you expect a lot of traffic, you can even have multiple daemons servicing one queue.

Daemon usage

Usage: rapnd start [options]
        --cert=MANDATORY             Location of the cert pem file
        --password=OPTIONAL          Password for the cert pem file
        --redis_host=OPTIONAL        Redis hostname
        --redis_port=OPTIONAL        Redis port
        --environment=OPTIONAL       Specify sandbox or production
        --queue=OPTIONAL             Name of the redis queue
        --foreground                 Run in the foreground
        --dir=OPTIONAL               Directory to start in
        --help                       Show help

You can use rapnd stop instead of start in order to kill a running daemon with the options you provide.

Client usage

require 'rapnd'

Rapnd.configure do |config|
  config.redis_host = 'localhost'
  config.redis_port = 6379
end

message = {:badge => 1, :alert => 'This is a test from rapnd!', :sound => 'flash.caf', :custom_properties => {:test_id => 1234, :happiness => true}}
queue_name = 'rapnd_queue'

Rapnd.queue(queue_name, message)

Contributing to rapnd

Copyright © 2012 Josh Symonds. See LICENSE.txt for further details.