rapns_rails_2 3.4.3

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ODdlNDhlOTIzODkyMDZiODdiNzIwYjAyNDJlNjkzZDYyMmYyZDhjNQ==
+  data.tar.gz: !binary |-
+    NDlhMWY3NGRmOTUwMmQ1NGRjMjg2MjE2ZDY5NmYwNWE5NjgyZWM1MA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    MTkzNDAxZTZmNWM4YTg3OTEzYWJhM2Q1YmE3MzBhZjg0YjUxYWJmMjAwYWMz
+    NGZmMGM0Mzk4MDM1MGU3OTFjZWVlNThhZTg1MDhiMmRmNDFhZjk3ZjcxYTA4
+    OTllMzFjM2NkZWRmYmVhZTlmOTkwYzlhMGI3NmVkZjQ1NjRiMTE=
+  data.tar.gz: !binary |-
+    YzQ3ZmMzMzU1MzFmYzczZGI4M2FlYWRjMTY3Y2NmNmJlOTY5Y2UxMWNhODUz
+    NTlmY2QwNTEyMmM0MWVkNGExNGJiNjdlYmViNjY3MzkyOWFhM2M3ZWUwY2Jm
+    M2Q0ODNlNmJiMmU1MDI2Mjc3ZGIzYjE1ZWQ1YjgxZmZiNGY3MzU=

data/CHANGELOG.md

@@ -0,0 +1,83 @@
+## 3.4.2 (unreleased)
+  * Fix sqlite3 support (#160).
+
+## 3.4.1 (Aug 30, 2013)
+  * Silence unintended airbrake_notify deprecation warning (#158).
+  * Add :dependent => :destroy to app notifications (#156).
+
+## 3.4.0 (Aug 28, 2013)
+  * Rails 4 support.
+  * Add apns_certificate_will_expire reflection.
+  * Perform storage update in batches where possible, to increase throughput.
+  * airbrake_notify is now deprecated, use the Reflection API instead.
+  * Fix calling the notification_delivered reflection twice (#149).
+
+## 3.3.2 (June 30, 2013)
+  * Fix Rails 3.0.x compatibility (#138) (@yoppi).
+  * Ensure Rails does not set a default value for text columns (#137).
+  * Fix error in down action for add_gcm migration (#135) (@alexperto).
+
+## 3.3.1 (June 2, 2013)
+  * Fix compatibility with postgres_ext (#104).
+  * Add ability to switch the logger (@maxsz).
+  * Do not validate presence of alert, badge or sound - not actually required by the APNs (#129) (@wilg).
+  * Catch IOError from an APNs connection. (@maxsz).
+  * Allow nested hashes in APNs notification attributes (@perezda).
+
+## 3.3.0 (April 21, 2013)
+  * GCM: collapse_key is no longer required to set expiry (time_to_live).
+  * Add reflection for GCM canonical IDs.
+  * Add Rapns::Daemon.store to decouple storage backend.
+
+## 3.2.0 (Apr 1, 2013)
+  * Rapns.apns_feedback for one time feedback retrieval. Rapns.push no longer checks for feedback (#117, #105).
+  * Lazily connect to the APNs only when a notification is to be delivered (#111).
+  * Ensure all notifications are sent when using Rapns.push (#107).
+  * Fix issue with running Rapns.push more than once in the same process (#106).
+
+## 3.1.0 (Jan 26, 2013)
+  * Rapns.reflect API for fine-grained introspection.
+  * Rapns.embed API for embedding Rapns into an existing process.
+  * Rapns.push API for using Rapns in scheduled jobs.
+  * Fix issue with integration with ActiveScaffold (#98) (@jeffarena).
+  * Fix content-available setter for APNs (#95) (@dup2).
+  * GCM validation fixes (#96) (@DianthuDia).
+
+## 3.0.1 (Dec 16, 2012)
+  * Fix compatibility with Rails 3.0.x. Fixes #89.
+
+## 3.0.0 (Dec 15, 2012)
+  * Add support for Google Cloud Messaging.
+  * Fix Heroku logging issue.
+
+##  2.0.5 (Nov 4, 2012) ##
+  * Support content-available (#68).
+  * Append to log files.
+  * Fire a callback when Feedback is received.
+
+## 2.0.5.rc1 (Oct 5, 2012) ##
+  * Release db connections back into the pool after use (#72).
+  * Continue to start daemon if a connection cannot be made during startup (#62) (@mattconnolly).
+
+## 2.0.4 (Aug 6, 2012) ##
+  * Don't exit when there aren't any Rapns::App instances, just warn (#55).
+
+## 2.0.3 (July 26, 2012) ##
+  * JRuby support.
+  * Explicitly list all attributes instead of calling column_names (#53).
+
+## 2.0.2 (July 25, 2012) ##
+  * Support MultiJson < 1.3.0.
+  * Make all model attributes accessible.
+
+## 2.0.1 (July 7, 2012) ##
+  * Fix delivery when using Ruby 1.8.
+  * MultiJson support.
+
+## 2.0.0 (June 19, 2012) ##
+
+  * Support for multiple apps.
+  * Hot Updates - add/remove apps without restart.
+  * MDM support.
+  * Removed rapns.yml in favour of command line options.
+  * Started the changelog!

data/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2012 Ian Leitch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,168 @@
+[![Build Status](https://secure.travis-ci.org/ileitch/rapns.png?branch=master)](http://travis-ci.org/ileitch/rapns)
+[![Code Climate](https://codeclimate.com/github/ileitch/rapns.png)](https://codeclimate.com/github/ileitch/rapns)
+
+### Rapns - Professional grade APNs and GCM for Ruby.
+
+* Supports both APNs (iOS) and GCM (Google Cloud Messaging, Android).
+* Seamless Rails (3, 4) integration.
+* Scalable - choose the number of persistent connections for each app.
+* Designed for uptime - signal -HUP to add, update apps.
+* Stable - reconnects database and network connections when lost.
+* Run as a daemon or inside an [existing processs](https://github.com/ileitch/rapns/wiki/Embedding-API).
+* Use in a scheduler for low-workload deployments ([Push API](https://github.com/ileitch/rapns/wiki/Push-API)).
+* Reflection API for fine-grained instrumentation and error handling ([Reflection API](https://github.com/ileitch/rapns/wiki/Reflection-API)).
+* Works with MRI, JRuby, Rubinius 1.8 and 1.9.
+* Built with love.
+
+### Who uses Rapns?
+
+[GateGuru](http://gateguruapp.com) and [Desk.com](http://desk.com), among others!
+
+*I'd love to hear if you use Rapns - @ileitch on twitter.*
+
+## Getting Started
+
+Add Rapns to your Gemfile:
+
+    gem 'rapns'
+
+Generate the migrations, rapns.yml and migrate:
+
+    rails g rapns
+    rake db:migrate
+
+## Create an App & Notification
+
+#### APNs
+
+If this is your first time using the APNs, you will need to generate SSL certificates. See [Generating Certificates](https://github.com/ileitch/rapns/wiki/Generating-Certificates) for instructions.
+
+```ruby
+app = Rapns::Apns::App.new
+app.name = "ios_app"
+app.certificate = File.read("/path/to/sandbox.pem")
+app.environment = "sandbox" # APNs environment.
+app.password = "certificate password"
+app.connections = 1
+app.save!
+```
+
+```ruby
+n = Rapns::Apns::Notification.new
+n.app = Rapns::Apns::App.find_by_name("ios_app")
+n.device_token = "..."
+n.alert = "hi mom!"
+n.attributes_for_device = {:foo => :bar}
+n.save!
+```
+
+You should also implement the [apns_certificate_will_expire](https://github.com/ileitch/rapns/wiki/Reflection-API) reflection to monitor when your certificate is due to expire.
+
+#### GCM
+
+```ruby
+app = Rapns::Gcm::App.new
+app.name = "android_app"
+app.auth_key = "..."
+app.connections = 1
+app.save!
+```
+
+```ruby
+n = Rapns::Gcm::Notification.new
+n.app = Rapns::Gcm::App.find_by_name("android_app")
+n.registration_ids = ["..."]
+n.data = {:message => "hi mom!"}
+n.save!
+```
+
+GCM also requires you to respond to [Canonical IDs](https://github.com/ileitch/rapns/wiki/Canonical-IDs).
+
+## Starting Rapns
+
+As a daemon:
+
+    cd /path/to/rails/app
+    rapns <Rails environment> [options]
+
+Inside an existing process (see [Embedding API](https://github.com/ileitch/rapns/wiki/Embedding-API)):
+
+```ruby
+Rapns.embed
+```
+
+*Please note that only ever a single instance of Rapns should be running.*
+
+In a scheduler (see [Push API](https://github.com/ileitch/rapns/wiki/Push-API)):
+
+```ruby
+Rapns.push
+Rapns.apns_feedback
+```
+
+See [Configuration](https://github.com/ileitch/rapns/wiki/Configuration) for a list of options, or run `rapns --help`.
+
+## Updating Rapns
+
+After updating you should run `rails g rapns` to check for any new migrations.
+
+## Wiki
+
+### General
+* [Configuration](https://github.com/ileitch/rapns/wiki/Configuration)
+* [Upgrading from 2.x to 3.0](https://github.com/ileitch/rapns/wiki/Upgrading-from-version-2.x-to-3.0)
+* [Deploying to Heroku](https://github.com/ileitch/rapns/wiki/Heroku)
+* [Hot App Updates](https://github.com/ileitch/rapns/wiki/Hot-App-Updates)
+* [Signals](https://github.com/ileitch/rapns/wiki/Signals)
+* [Reflection API](https://github.com/ileitch/rapns/wiki/Reflection-API)
+* [Push API](https://github.com/ileitch/rapns/wiki/Push-API)
+* [Embedding API](https://github.com/ileitch/rapns/wiki/Embedding-API)
+* [Implementing your own storage backend](https://github.com/ileitch/rapns/wiki/Implementing-your-own-storage-backend)
+
+### APNs
+* [Generating Certificates](https://github.com/ileitch/rapns/wiki/Generating-Certificates)
+* [Advanced APNs Features](https://github.com/ileitch/rapns/wiki/Advanced-APNs-Features)
+* [APNs Delivery Failure Handling](https://github.com/ileitch/rapns/wiki/APNs-Delivery-Failure-Handling)
+* [Why open multiple connections to the APNs?](https://github.com/ileitch/rapns/wiki/Why-open-multiple-connections-to-the-APNs%3F)
+* [Silent failures might be dropped connections](https://github.com/ileitch/rapns/wiki/Dropped-connections)
+
+### GCM
+* [Notification Options](https://github.com/ileitch/rapns/wiki//GCM-Notification-Options)
+* [Canonical IDs](https://github.com/ileitch/rapns/wiki/Canonical-IDs)
+* [Delivery Failures & Retries](https://github.com/ileitch/rapns/wiki/Delivery-Failures-&-Retries)
+
+## Contributing
+
+Fork as usual and go crazy!
+
+When running specs, please note that the ActiveRecord adapter can be changed by setting the `ADAPTER` environment variable. For example: `ADAPTER=postgresql rake`.
+
+Available adapters for testing are `mysql`, `mysql2` and `postgresql`.
+
+Note that the database username is changed at runtime to be the currently logged in user's name. So if you're testing
+with mysql and you're using a user named 'bob', you will need to grant a mysql user 'bob' access to the 'rapns_test'
+mysql database.
+
+### Contributors
+
+Thank you to the following wonderful people for contributing:
+
+* [@blakewatters](https://github.com/blakewatters)
+* [@forresty](https://github.com/forresty)
+* [@sjmadsen](https://github.com/sjmadsen)
+* [@ivanyv](https://github.com/ivanyv)
+* [@taybenlor](https://github.com/taybenlor)
+* [@tompesman](https://github.com/tompesman)
+* [@EpicDraws](https://github.com/EpicDraws)
+* [@dei79](https://github.com/dei79)
+* [@adorr](https://github.com/adorr)
+* [@mattconnolly](https://github.com/mattconnolly)
+* [@emeitch](https://github.com/emeitch)
+* [@jeffarena](https://github.com/jeffarena)
+* [@DianthuDia](https://github.com/DianthuDia)
+* [@dup2](https://github.com/dup2)
+* [@maxsz](https://github.com/maxsz)
+* [@wilg](https://github.com/wilg)
+* [@perezda](https://github.com/perezda)
+* [@alexperto](https://github.com/alexperto)
+* [@yoppi](https://github.com/yoppi)

data/bin/rapns

@@ -0,0 +1,37 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'rapns_rails_2'
+
+environment = ARGV[0]
+
+config = Rapns::ConfigurationWithoutDefaults.new
+
+options = ARGV.options do |opts|
+  opts.banner = 'Usage: rapns <Rails environment> [options]'
+  opts.on('-f', '--foreground', 'Run in the foreground.') { config.foreground = true }
+  opts.on('-P N', '--db-poll N', Integer, "Frequency in seconds to check for new notifications.") { |n| config.push_poll = n }
+  opts.on('-F N', '--feedback-poll N', Integer, "Frequency in seconds to check for feedback.") { |n| config.feedback_poll = n }
+  opts.on('-e', '--no-error-checks', 'Disable APNs error checking after notification delivery.') { config.check_for_errors = false }
+  opts.on('-n', '--no-airbrake-notify', 'Disables error notifications via Airbrake.') { config.airbrake_notify = false }
+  opts.on('-p PATH', '--pid-file PATH', String, 'Path to write PID file. Relative to Rails root unless absolute.') { |path| config.pid_file = path }
+  opts.on('-b N', '--batch-size N', Integer, 'Storage backend notification batch size.') { |n| config.batch_size = n }
+  opts.on('-B', '--[no-]batch-storage-updates', 'Perform storage updates in batches.') { |v| config.batch_storage_updates = v }
+  opts.on('-v', '--version', 'Print the version.') { puts "rapns #{Rapns::VERSION}"; exit }
+  opts.on('-h', '--help', 'You\'re looking at it.') { puts opts; exit }
+end
+
+if environment.nil? || environment =~ /^-/
+  puts options.to_s
+  exit 1
+end
+
+options.parse!
+
+ENV['RAILS_ENV'] = environment
+load 'config/environment.rb'
+load 'config/initializers/rapns.rb' if File.exist?('config/initializers/rapns.rb')
+
+Rapns.config.update(config)
+Rapns.require_for_daemon
+Rapns::Daemon.start

data/config/database.yml

@@ -0,0 +1,44 @@
+# postgresql is the default if no ADAPTER environment variable is set when running specs.
+
+postgresql:
+  adapter: postgresql
+  database: rapns_test
+  host: localhost
+  username: postgres
+  password: ""
+
+jdbcpostgresql:
+  adapter: jdbcpostgresql
+  database: rapns_test
+  host: localhost
+  username: postgres
+  password: ""
+
+mysql2:
+  adapter: mysql
+  database: rapns_test
+  host: localhost
+  username: rapns_test
+  password: ""
+  encoding: utf8
+
+jdbcmysql:
+  adapter: jdbcmysql
+  database: rapns_test
+  host: localhost
+  username: rapns_test
+  password: ""
+  encoding: utf8
+
+jdbch2:
+  adapter: h2
+  url: jdbc:h2:file:/tmp/rapns_test;AUTO_SERVER=TRUE
+  username: rapns_test
+  password: ""
+  pool: 128
+  timeout: 5000
+  encoding: utf8
+
+sqlite3:
+  adapter: sqlite3
+  database: spec/tmp/rapns_test.sqlite3

data/lib/generators/rapns_generator.rb

@@ -0,0 +1,25 @@
+class RapnsGenerator < Rails::Generator::Base
+
+  def manifest
+    record do |m|
+
+      puts m.class
+
+      m.file 'rapns.rb', 'config/initializers/rapns.rb'
+
+      create_migration m, "create_rapns_notifications"
+      create_migration m, "create_rapns_feedback"
+      create_migration m, "add_alert_is_json_to_rapns_notifications"
+      create_migration m, "add_app_to_rapns"
+      create_migration m, "create_rapns_apps"
+      create_migration m, "add_gcm"
+
+    end
+
+  end
+
+  def create_migration(m, filename)
+    m.migration_template "#{filename}.rb", "db/migrate", :migration_file_name => filename
+  end
+
+end

data/lib/generators/templates/add_alert_is_json_to_rapns_notifications.rb

@@ -0,0 +1,9 @@
+class AddAlertIsJsonToRapnsNotifications < ActiveRecord::Migration
+  def self.up
+    add_column :rapns_notifications, :alert_is_json, :boolean, :null => true, :default => false
+  end
+
+  def self.down
+    remove_column :rapns_notifications, :alert_is_json
+  end
+end

data/lib/generators/templates/add_app_to_rapns.rb

@@ -0,0 +1,11 @@
+class AddAppToRapns < ActiveRecord::Migration
+  def self.up
+    add_column :rapns_notifications, :app, :string, :null => true
+    add_column :rapns_feedback, :app, :string, :null => true
+  end
+
+  def self.down
+    remove_column :rapns_notifications, :app
+    remove_column :rapns_feedback, :app
+  end
+end

data/lib/generators/templates/add_gcm.rb

@@ -0,0 +1,95 @@
+class AddGcm < ActiveRecord::Migration
+  module Rapns
+    class App < ActiveRecord::Base
+      self.table_name = 'rapns_apps'
+    end
+
+    class Notification < ActiveRecord::Base
+      belongs_to :app
+      self.table_name = 'rapns_notifications'
+    end
+  end
+
+  def self.up
+    add_column :rapns_notifications, :type, :string, :null => true
+    add_column :rapns_apps, :type, :string, :null => true
+
+    AddGcm::Rapns::Notification.update_all :type => 'Rapns::Apns::Notification'
+    AddGcm::Rapns::App.update_all :type => 'Rapns::Apns::App'
+
+    change_column :rapns_notifications, :type, :string, :null => false
+    change_column :rapns_apps, :type, :string, :null => false
+    change_column :rapns_notifications, :device_token, :string, { :null => true, :limit => 64 }
+    change_column :rapns_notifications, :expiry, :integer, { :null => true, :default => 1.day.to_i }
+    change_column :rapns_apps, :environment, :string, :null => true
+    change_column :rapns_apps, :certificate, :text, :null => true, :default => nil
+
+    change_column :rapns_notifications, :error_description, :text, :null => true, :default => nil
+    change_column :rapns_notifications, :sound, :string, :default => 'default'
+
+    rename_column :rapns_notifications, :attributes_for_device, :data
+    rename_column :rapns_apps, :key, :name
+
+    add_column :rapns_apps, :auth_key, :string, :null => true
+
+    add_column :rapns_notifications, :collapse_key, :string, :null => true
+    add_column :rapns_notifications, :delay_while_idle, :boolean, :null => false, :default => false
+
+    reg_ids_type = ActiveRecord::Base.connection.adapter_name.include?('Mysql') ? :mediumtext : :text
+    add_column :rapns_notifications, :registration_ids, reg_ids_type, :null => true
+    add_column :rapns_notifications, :app_id, :integer, :null => true
+    add_column :rapns_notifications, :retries, :integer, :null => true, :default => 0
+
+    Rapns::Notification.reset_column_information
+    Rapns::App.reset_column_information
+
+    Rapns::App.all.each do |app|
+      Rapns::Notification.update_all(['app_id = ?', app.id], ['app = ?', app.name])
+    end
+
+    change_column :rapns_notifications, :app_id, :integer, :null => false
+    remove_column :rapns_notifications, :app
+
+    remove_index :rapns_notifications, :name => "index_rapns_notifications_multi"
+    add_index :rapns_notifications, [:app_id, :delivered, :failed, :deliver_after], :name => "index_rapns_notifications_multi"
+  end
+
+  def self.down
+    AddGcm::Rapns::Notification.deleta_all(:type => 'Rapns::Gcm::Notification')
+
+    remove_column :rapns_notifications, :type
+    remove_column :rapns_apps, :type
+
+    change_column :rapns_notifications, :device_token, :string, { :null => false, :limit => 64 }
+    change_column :rapns_notifications, :expiry, :integer, { :null => false, :default => 1.day.to_i }
+    change_column :rapns_apps, :environment, :string, :null => false
+    change_column :rapns_apps, :certificate, :text, :null => false
+
+    change_column :rapns_notifications, :error_description, :string, :null => true, :default => nil
+    change_column :rapns_notifications, :sound, :string, :default => '1.aiff'
+
+    rename_column :rapns_notifications, :data, :attributes_for_device
+    rename_column :rapns_apps, :name, :key
+
+    remove_column :rapns_apps, :auth_key
+
+    remove_column :rapns_notifications, :collapse_key
+    remove_column :rapns_notifications, :delay_while_idle
+    remove_column :rapns_notifications, :registration_ids
+    remove_column :rapns_notifications, :retries
+
+    add_column :rapns_notifications, :app, :string, :null => true
+
+    Rapns::Notification.reset_column_information
+    Rapns::App.reset_column_information
+
+    Rapns::App.all.each do |app|
+      Rapns::Notification.update_all(['app = ?', app.key], ['app_id = ?', app.id])
+    end
+
+    remove_column :rapns_notifications, :app_id
+
+    remove_index :rapns_notifications, :name => "index_rapns_notifications_multi"
+    add_index :rapns_notifications, [:delivered, :failed, :deliver_after], :name => "index_rapns_notifications_multi"
+  end
+end

data/lib/generators/templates/create_rapns_apps.rb

@@ -0,0 +1,16 @@
+class CreateRapnsApps < ActiveRecord::Migration
+  def self.up
+    create_table :rapns_apps do |t|
+      t.string    :key,             :null => false
+      t.string    :environment,     :null => false
+      t.text      :certificate,     :null => false
+      t.string    :password,        :null => true
+      t.integer   :connections,     :null => false, :default => 1
+      t.timestamps
+    end
+  end
+
+  def self.down
+    drop_table :rapns_apps
+  end
+end

data/lib/generators/templates/create_rapns_feedback.rb

@@ -0,0 +1,15 @@
+class CreateRapnsFeedback < ActiveRecord::Migration
+  def self.up
+    create_table :rapns_feedback do |t|
+      t.string    :device_token,          :null => false, :limit => 64
+      t.timestamp :failed_at,             :null => false
+      t.timestamps
+    end
+
+    add_index :rapns_feedback, :device_token
+  end
+
+  def self.down
+    drop_table :rapns_feedback
+  end
+end

data/lib/generators/templates/create_rapns_notifications.rb

@@ -0,0 +1,26 @@
+class CreateRapnsNotifications < ActiveRecord::Migration
+  def self.up
+    create_table :rapns_notifications do |t|
+      t.integer   :badge,                 :null => true
+      t.string    :device_token,          :null => false, :limit => 64
+      t.string    :sound,                 :null => true,  :default => "1.aiff"
+      t.string    :alert,                 :null => true
+      t.text      :attributes_for_device, :null => true
+      t.integer   :expiry,                :null => false, :default => 1.day.to_i
+      t.boolean   :delivered,             :null => false, :default => false
+      t.timestamp :delivered_at,          :null => true
+      t.boolean   :failed,                :null => false, :default => false
+      t.timestamp :failed_at,             :null => true
+      t.integer   :error_code,            :null => true
+      t.string    :error_description,     :null => true
+      t.timestamp :deliver_after,         :null => true
+      t.timestamps
+    end
+
+    add_index :rapns_notifications, [:delivered, :failed, :deliver_after], :name => "index_rapns_notifications_multi"
+  end
+
+  def self.down
+    drop_table :rapns_notifications
+  end
+end

data/lib/generators/templates/rapns.rb

@@ -0,0 +1,87 @@
+# Rapns configuration. Options set here are overridden by command-line options.
+
+ Rapns.configure do |config|
+
+  # Run in the foreground?
+  # config.foreground = false
+
+  # Frequency in seconds to check for new notifications.
+  # config.push_poll = 2
+
+  # Frequency in seconds to check for feedback
+  # config.feedback_poll = 60
+
+  # Disable APNs error checking after notification delivery.
+  # config.check_for_errors = true
+
+  # ActiveRecord notifications batch size.
+  # config.batch_size = 5000
+
+  # Perform updates to the storage backend in batches to reduce IO.
+  # config.batch_storage_updates = true
+
+  # Path to write PID file. Relative to Rails root unless absolute.
+  # config.pid_file = '/path/to/rapns.pid'
+
+  # Define a custom logger.
+  # config.logger = MyLogger.new
+
+ end
+
+Rapns.reflect do |on|
+
+  # Called with a Rapns::Apns::Feedback instance when feedback is received
+  # from the APNs that a notification has failed to be delivered.
+  # Further notifications should not be sent to the device.
+  # on.apns_feedback do |feedback|
+  # end
+
+  # Called when a notification is queued internally for delivery.
+  # The internal queue for each app runner can be inspected:
+  #
+  # Rapns::Daemon::AppRunner.runners.each do |app_id, runner|
+  #   runner.app
+  #   runner.queue_size
+  # end
+  #
+  # on.notification_enqueued do |notification|
+  # end
+
+  # Called when a notification is successfully delivered.
+  # on.notification_delivered do |notification|
+  # end
+
+  # Called when notification delivery failed.
+  # Call 'error_code' and 'error_description' on the notification for the cause.
+  # on.notification_failed do |notification|
+  # end
+
+  # Called when a notification will be retried at a later date.
+  # Call 'deliver_after' on the notification for the next delivery date
+  # and 'retries' for the number of times this notification has been retried.
+  # on.notification_will_retry do |notification|
+  # end
+
+  # Called when an APNs connection is lost and will be reconnected.
+  # on.apns_connection_lost do |app, error|
+  # end
+
+  # Called when the GCM returns a canonical registration ID.
+  # You will need to replace old_id with canonical_id in your records.
+  # on.gcm_canonical_id do |old_id, canonical_id|
+  # end
+
+  # Called when the GCM returns a failure that indicates an invalid tegistration id.
+  # You will need to delete the registration_id from your records.
+  # on.gcm_invalid_registration_id do |app, error, registration_id|
+  # end
+
+  # Called when an APNs certificate will expire within 1 month.
+  # Implement on.error to catch errors raised when the certificate expires.
+  # on.apns_certificate_will_expire do |app, expiration_time|
+  # end
+
+  # Called when an exception is raised.
+  # on.error do |error|
+  # end
+end

data/lib/rapns/TODO

@@ -0,0 +1,3 @@
+* Should internal errors mark a notification as failed?
+* Check cert expiry when connected.
+* Lazy connect on socket write? - would allow to catch initial expiry error and mark on notification.