apnd 0.0.1

data/README.markdown

@@ -0,0 +1,97 @@
+# APND
+
+APND (Apple Push Notification Daemon) is a ruby library to send Apple Push
+Notifications (APNs) to iPhones.
+
+Apple recommends application developers create one connection to their
+upstream push notification server, rather than creating one per notification.
+
+APND acts as an intermediary between your application and Apple (see **APND
+Daemon** below). Your application's notifications are queued to APND, which
+are then sent to Apple over a single connection.
+
+Within ruby applications, `APND::Notification` can be used to send
+notifications to a running APND instance (see **APND Notification** below) or
+directly to Apple. A command line utility, `apnd-push`, can be used to send
+single notifications for testing purposes (see **APND Client** below).
+
+
+## General Usage
+
+### APND Daemon
+
+APND receives push notifications from your application and relays them to
+Apple over a single connection as explained above. The `apnd` command line
+utility is used to start APND.
+
+    Usage:
+      apnd [OPTIONS] --apple-cert </path/to/cert>
+
+    Required Arguments:
+            --apple-cert      [PATH]     PATH to APN certificate from Apple
+
+    Optional Arguments:
+            --apple-host      [HOST]     Connect to Apple at HOST (default is gateway.sandbox.push.apple.com)
+            --apple-port      [PORT]     Connect to Apple on PORT (default is 2195)
+            --apple-cert-pass [PASSWORD] PASSWORD for APN certificate from Apple
+            --daemon-port     [PORT]     Run APND on PORT (default is 22195)
+            --daemon-bind     [ADDRESS]  Bind APND to ADDRESS (default is 0.0.0.0)
+            --daemon-log-file [PATH]     PATH to APND log file (default is /var/log/apnd.log)
+            --foreground                 Run APND in foreground without daemonizing
+
+    Help:
+            --version                    Show version
+            --help                       Show this message
+
+
+### APND Client
+
+APND includes a command line utility, `apnd-push`, which can be used to send
+notifications to a running APND instance, or Apple directly. It is only
+recommended to send notifications directly to Apple for testing purposes.
+
+    Usage:
+      apnd-push [OPTIONS] --token <token> --alert <alert>
+
+    Required Arguments:
+            --token  [TOKEN]             Set Notification's iPhone token to TOKEN
+            --alert  [MESSAGE]           Set Notification's alert to MESSAGE
+
+    Optional Arguments:
+            --sound  [SOUND]             Set Notification's sound to SOUND (default is 'default')
+            --badge  [NUMBER]            Set Notification's badge number to NUMBER
+            --custom [JSON]              Set Notification's custom data to JSON
+            --host   [HOST]              Send Notification to HOST, usually the one running APND (default is 'localhost')
+            --port   [PORT]              Send Notification on PORT (default is 22195)
+
+    Help:
+            --version                    Show version
+            --help                       Show this message
+
+
+### APND Notification
+
+The `APND::Notification` class can be used within your application to send
+push notifications to APND.
+
+    require 'apnd'
+
+    # Set the host/port APND is running on
+    # (not needed if you're using localhost:22195)
+
+    APND::Notification.upstream_host = 'localhost'
+    APND::Notification.upstream_port = 22195
+
+    notification = APND::Notification.create(
+      :alert  => 'Alert!',
+      :token  => 'fe15a27d5df3c34778defb1f4f3880265cc52c0c047682223be59fb68500a9a2',
+      :badge  => 99
+    )
+
+
+## Credit
+
+APND is based on [apnserver](http://github.com/bpoweski/apnserver) and
+[apn_on_rails](http://github.com/PRX/apn_on_rails). Either worked just how I
+wanted, so I rolled my own using theirs as starting points. If APND doesn't
+suit you, check them out instead.

data/Rakefile

@@ -0,0 +1,13 @@
+require 'rubygems'
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test' << '.'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -r ./lib/apnd.rb -I ./lib"
+end

data/bin/apnd

@@ -0,0 +1,107 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), *%w[.. lib])
+
+require 'apnd'
+
+require 'daemons'
+require 'optparse'
+
+help = <<HELP
+Usage:
+  apnd [OPTIONS] --apple-cert </path/to/cert>
+
+HELP
+
+options = {}
+
+opts = OptionParser.new do |opt|
+  opt.banner = help
+
+  opt.separator "Required Arguments:\n"
+
+  opt.on('--apple-cert      [PATH]', 'PATH to APN certificate from Apple') do |cert|
+    options[:apple_cert] = cert
+  end
+
+  opt.separator "\nOptional Arguments:\n"
+
+  opt.on('--apple-host      [HOST]', "Connect to Apple at HOST (default is gateway.sandbox.push.apple.com)") do |host|
+    options[:apple_host] = host
+  end
+
+  opt.on('--apple-port      [PORT]', 'Connect to Apple on PORT (default is 2195)') do |port|
+    options[:apple_port] = port.to_i
+  end
+
+  opt.on('--apple-cert-pass [PASSWORD]', 'PASSWORD for APN certificate from Apple') do |pass|
+    options[:apple_cert_pass] = pass
+  end
+
+  opt.on('--daemon-port     [PORT]', 'Run APND on PORT (default is 22195)') do |port|
+    options[:daemon_port] = port.to_i
+  end
+
+  opt.on('--daemon-bind     [ADDRESS]', 'Bind APND to ADDRESS (default is 0.0.0.0)') do |bind|
+    options[:daemon_bind] = bind
+  end
+
+  opt.on('--daemon-log-file [PATH]', 'PATH to APND log file (default is /var/log/apnd.log)') do |log|
+    options[:daemon_log_file] = log
+  end
+
+  opt.on('--foreground', 'Run APND in foreground without daemonizing') do
+    options[:foreground] = true
+  end
+
+  opt.separator "\nHelp:\n"
+
+  opt.on('--version', 'Show version') do
+    puts "APND #{APND::Version}"
+    exit
+  end
+
+  opt.on('--help', 'Show this message') do
+    puts opt
+    exit
+  end
+end
+
+begin
+  opts.parse!
+  if options.empty?
+    puts opts
+    exit
+  end
+
+  unless options[:apple_cert]
+    raise OptionParser::MissingArgument, "must specify --apple-cert"
+  end
+rescue OptionParser::InvalidOption, OptionParser::MissingArgument
+  puts "#{$0}: #{$!.message}"
+  puts "#{$0}: try '#{$0} --help' for more information"
+  exit
+end
+
+APND.configure do |config|
+  # Setup AppleConnection
+  config.apple.cert      = options[:apple_cert]      if options[:apple_cert]
+  config.apple.cert_pass = options[:apple_cert_pass] if options[:apple_cert_pass]
+  config.apple.host      = options[:apple_host]      if options[:apple_host]
+  config.apple.port      = options[:apple_port]      if options[:apple_port]
+
+  # Setup Daemon
+  config.daemon.bind     = options[:daemon_bind]     if options[:daemon_bind]
+  config.daemon.port     = options[:daemon_port]     if options[:daemon_port]
+  config.daemon.log_file = options[:daemon_log_file] if options[:daemon_log_file]
+end
+
+if APND.settings.apple.cert.nil?
+  puts opts
+  exit
+else
+  unless options[:foreground]
+    Daemonize.daemonize(APND.settings.daemon.log_file, 'apnd')
+  end
+  APND::Daemon.run!
+end

data/bin/apnd-push

@@ -0,0 +1,90 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), *%w[.. lib])
+
+require 'apnd'
+
+require 'optparse'
+
+help = <<HELP
+Usage:
+  apnd-push [OPTIONS] --token <token> --alert <alert>
+
+HELP
+
+options = {}
+
+opts = OptionParser.new do |opt|
+  opt.banner = help
+
+  opt.separator "Required Arguments:\n"
+
+  opt.on('--token  [TOKEN]', "Set Notification's iPhone token to TOKEN") do |token|
+    options[:token] = token
+  end
+
+  opt.on('--alert  [MESSAGE]', "Set Notification's alert to MESSAGE") do |alert|
+    options[:alert] = alert
+  end
+
+  opt.separator "\nOptional Arguments:\n"
+  
+  opt.on('--sound  [SOUND]', "Set Notification's sound to SOUND (default is 'default')") do |sound|
+    options[:sound] = sound
+  end
+
+  opt.on('--badge  [NUMBER]', "Set Notification's badge number to NUMBER") do |badge|
+    options[:badge] = badge.to_i
+  end
+
+  opt.on('--custom [JSON]', "Set Notification's custom data to JSON") do |custom|
+    begin
+      options[:custom] = JSON.parse(custom)
+    rescue JSON::ParserError => e
+      puts "Invalid JSON: #{e}"
+      exit -1
+    end
+  end
+
+  opt.on('--host   [HOST]', "Send Notification to HOST, usually the one running APND (default is 'localhost')") do |host|
+    options[:host] = host
+  end
+
+  opt.on('--port   [PORT]', 'Send Notification on PORT (default is 22195)') do |port|
+    options[:port] = port.to_i
+  end
+
+  opt.separator "\nHelp:\n"
+
+  opt.on('--version', 'Show version') do
+    puts "APND #{APND::Version}"
+    exit
+  end
+
+  opt.on('--help', 'Show this message') do
+    puts opt
+    exit
+  end
+end
+
+begin
+  opts.parse!
+  if options.empty?
+    puts opts
+    exit
+  end
+
+  unless options[:token] && options[:alert]
+    raise OptionParser::MissingArgument, "must specify --token and --alert"
+  end
+rescue OptionParser::InvalidOption, OptionParser::MissingArgument
+  puts "#{$0}: #{$!.message}"
+  puts "#{$0}: try '#{$0} --help' for more information"
+  exit
+end
+
+# Configure Notification upstream host/port
+APND::Notification.upstream_host = options.delete(:host) if options[:host]
+APND::Notification.upstream_port = options.delete(:port) if options[:port]
+
+APND::Notification.create(options)

data/lib/apnd.rb

@@ -0,0 +1,28 @@
+require 'json'
+
+module APND
+  autoload :Version,      'apnd/version'
+  autoload :Errors,       'apnd/errors'
+  autoload :Settings,     'apnd/settings'
+  autoload :Daemon,       'apnd/daemon'
+  autoload :Notification, 'apnd/notification'
+
+  #
+  # APND Settings
+  #
+  def self.settings
+    @@settings ||= Settings.new
+  end
+
+  #
+  # Yields APND Settings
+  #
+  def self.configure
+    yield settings
+  end
+
+end
+
+def ohai(message)
+  puts "[%s] %s" % [Time.now.strftime("%Y-%m-%d %H:%M:%S"), message]
+end

data/lib/apnd/daemon.rb

@@ -0,0 +1,65 @@
+require 'eventmachine'
+
+module APND
+  #
+  # The APND::Daemon maintains a persistent secure connection with Apple,
+  # (APND::Daemon::AppleConnection). Notifications are queued and periodically
+  # writen to the AppleConnection
+  #
+  class Daemon
+    autoload :Protocol,        'apnd/daemon/protocol'
+    autoload :AppleConnection, 'apnd/daemon/apple_connection'
+
+    #
+    # Create a new Daemon and run it
+    #
+    def self.run!
+      server = APND::Daemon.new
+      server.run!
+    end
+
+    #
+    # Create a connection to Apple and a new EM queue
+    #
+    def initialize
+      @queue = EM::Queue.new
+      @apple = APND::Daemon::AppleConnection.new
+      @bind  = APND.settings.daemon.bind
+      @port  = APND.settings.daemon.port
+      @timer = APND.settings.daemon.timer
+    end
+
+    #
+    # Run the daemon
+    #
+    def run!
+      EventMachine::run do
+        ohai "Starting APND Daemon on #{@bind}:#{@port}"
+        EventMachine::start_server(@bind, @port, APND::Daemon::Protocol) do |server|
+          server.queue = @queue
+        end
+
+        EventMachine::PeriodicTimer.new(@timer) do
+          count = @queue.size
+          if count > 0
+            ohai "Queue has #{count} item#{count == 1 ? '' : 's'}"
+            count.times do
+              @queue.pop do |notification|
+                begin
+                  ohai "Sending notification"
+                  @apple.write(notification.to_bytes)
+                rescue Errno::EPIPE, OpenSSL::SSL::SSLError
+                  ohai "Error, notification has been added back to the queue"
+                  @queue.push(notification)
+                rescue RuntimeError => error
+                  ohai "Error: #{error}"
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/apnd/daemon/apple_connection.rb

@@ -0,0 +1,76 @@
+require 'openssl'
+require 'socket'
+
+module APND
+  #
+  # Daemon::AppleConnection handles the persistent connection between
+  # APND and Apple
+  #
+  class Daemon::AppleConnection
+    attr_reader :ssl, :sock
+
+    #
+    # Setup a new connection
+    #
+    def initialize(params = {})
+      @options = {
+        :cert      => APND.settings.apple.cert,
+        :cert_pass => APND.settings.apple.cert_pass,
+        :host      => APND.settings.apple.host,
+        :port      => APND.settings.apple.port.to_i
+      }.merge(params)
+    end
+
+    #
+    # Returns true if the connection to Apple is open
+    #
+    def connected?
+      ! @ssl.nil?
+    end
+
+    #
+    # Connect to Apple over SSL
+    #
+    def connect!
+      cert         = File.read(@options[:cert])
+      context      = OpenSSL::SSL::SSLContext.new
+      context.key  = OpenSSL::PKey::RSA.new(cert, @options[:cert_pass])
+      context.cert = OpenSSL::X509::Certificate.new(cert)
+
+      @sock = TCPSocket.new(@options[:host], @options[:port])
+      @ssl  = OpenSSL::SSL::SSLSocket.new(@sock, context)
+      @ssl.sync = true
+      @ssl.connect
+    end
+
+    #
+    # Close connection
+    #
+    def disconnect!
+      @ssl.close
+      @sock.close
+      @ssl = nil
+      @sock = nil
+    end
+
+    #
+    # Establishes a connection if needed and yields it
+    #
+    # Ex: open { |conn| conn.write('write to socket) }
+    #
+    def open(&block)
+      unless connected?
+        connect!
+      end
+
+      yield @ssl
+    end
+
+    #
+    # Write to the connection socket
+    #
+    def write(raw)
+      open { |conn| conn.write(raw) }
+    end
+  end
+end

data/lib/apnd/daemon/protocol.rb

@@ -0,0 +1,30 @@
+module APND
+  #
+  # Daemon::Protocol handles incoming APNs
+  #
+  class Daemon::Protocol < ::EventMachine::Connection
+    attr_accessor :queue
+
+    def post_init
+      @address = Socket.unpack_sockaddr_in(self.get_peername)
+      ohai "#{@address.last}:#{@address.first} opened connection"
+    end
+
+    def unbind
+      ohai "#{@address.last}:#{@address.first} closed connection"
+    end
+
+    #
+    # Add incoming notification to the queue if it is valid
+    #
+    def receive_data(data)
+      (@buffer ||= "") << data
+      if notification = APND::Notification.valid?(@buffer)
+        ohai "#{@address.last}:#{@address.first} added new Notification to queue"
+        queue.push(notification)
+      else
+        ohai "#{@address.last}:#{@address.first} submitted invalid Notification"
+      end
+    end
+  end
+end

data/lib/apnd/errors.rb

@@ -0,0 +1,13 @@
+module APND
+  module Errors
+
+    #
+    # Raised if APN payload is larger than 256 bytes
+    #
+    class InvalidPayload < StandardError
+      def initialize(message)
+        super("Payload is larger than 256 bytes: '#{message}'")
+      end
+    end
+  end
+end

data/lib/apnd/notification.rb

@@ -0,0 +1,139 @@
+require 'socket'
+
+module APND
+  #
+  # APND::Notification is the base class for creating new push notifications.
+  #
+  class Notification
+
+    class << self
+      attr_accessor :upstream_host
+      attr_accessor :upstream_port
+    end
+
+    self.upstream_host = APND.settings.notification.host
+    self.upstream_port = APND.settings.notification.port.to_i
+
+    attr_accessor :token, :alert, :badge, :sound, :custom
+
+    #
+    # Create a new APN
+    #
+    def self.create(params = {}, push = true)
+      notification = Notification.new(params)
+      notification.push! if push
+      notification
+    end
+
+    #
+    # Try to create a new Notification from raw data
+    # Used by Daemon::Protocol to validate incoming data
+    #
+    def self.valid?(data)
+      parse(data)
+    rescue
+      false
+    end
+
+    #
+    # Parse raw data into a new Notification
+    #
+    def self.parse(data)
+      buffer = data.dup
+      notification = Notification.new
+
+      header = buffer.slice!(0, 3).unpack('ccc')
+
+      if header[0] != 0
+        raise RuntimeError, "Invalid Notification header: #{header.inspect}"
+      end
+
+      notification.token = buffer.slice!(0, 32).unpack('H*').first
+
+      json_length = buffer.slice!(0, 2).unpack('CC')
+
+      json = buffer.slice!(0, json_length.last)
+
+      payload = JSON.parse(json)
+
+      %w[alert sound badge].each do |key|
+        if payload['aps'] && payload['aps'][key]
+          notification.send("#{key}=", payload['aps'][key])
+        end
+      end
+
+      payload.delete('aps')
+
+      unless payload.empty?
+        notification.custom = payload
+      end
+
+      notification
+    end
+
+    #
+    # Create a new Notification object from a hash
+    #
+    def initialize(params = {})
+      @token  = params[:token]
+      @alert  = params[:alert]
+      @badge  = params[:badge]
+      @sound  = params[:sound] || 'default'
+      @custom = params[:custom]
+    end
+
+    #
+    # Token in hex format
+    #
+    def hex_token
+      [self.token.delete(' ')].pack('H*')
+    end
+
+    #
+    # aps hash sent to Apple
+    #
+    def aps
+      aps = {}
+      aps['alert'] = self.alert      if self.alert
+      aps['badge'] = self.badge.to_i if self.badge
+      aps['sound'] = self.sound      if self.sound
+
+      output = { 'aps' => aps }
+
+      if self.custom
+        self.custom.each do |key, value|
+          output[key.to_s] = value
+        end
+      end
+      output
+    end
+
+    #
+    # Pushes notification to upstream host:port (default is localhost:22195)
+    #
+    def push!
+      socket = TCPSocket.new(self.class.upstream_host, self.class.upstream_port)
+      socket.write(to_bytes)
+      socket.close
+    end
+
+    #
+    # Returns the Notification's aps hash as json
+    #
+    def payload
+      return @payload if @payload
+      json = aps.to_json
+      raise APND::InvalidPayload.new(json) if json.size > 256
+      @payload = json
+    end
+
+    #
+    # Format the notification as a string for submission
+    # to Apple
+    #
+    def to_bytes
+      @bytes ||= "\0\0 %s\0%s%s" % [hex_token, payload.length.chr, payload]
+    end
+
+  end
+end

data/lib/apnd/settings.rb

@@ -0,0 +1,128 @@
+module APND
+  #
+  # Settings for APND
+  #
+  class Settings
+
+    #
+    # Settings for APND::Daemon::AppleConnection
+    #
+    class AppleConnection
+
+      #
+      # Host used to connect to Apple
+      #
+      #   Development: gateway.sandbox.push.apple.com
+      #   Production: gateway.push.apple.com
+      #
+      attr_accessor :host
+
+      #
+      # Port used to connect to Apple
+      #
+      attr_accessor :port
+
+      #
+      # Path to APN cert for your application
+      #
+      attr_accessor :cert
+
+      #
+      # Password for APN cert, optional
+      #
+      attr_accessor :cert_pass
+
+      def initialize
+        @host = 'gateway.sandbox.push.apple.com'
+        @port = 2195
+      end
+    end
+
+    #
+    # Settings for APND::Daemon
+    #
+    class Daemon
+
+      #
+      # IP to bind APND::Daemon to
+      #
+      #   Default: '0.0.0.0'
+      #
+      attr_accessor :bind
+
+      #
+      # Port APND::Daemon will run on
+      #
+      #   Default: 22195
+      #
+      attr_accessor :port
+
+      #
+      # Path to APND::Daemon log
+      #
+      #   Default: /var/log/apnd.log
+      #
+      attr_accessor :log_file
+
+      #
+      # Interval (in seconds) the queue will be processed
+      #
+      #   Default: 30
+      #
+      attr_accessor :timer
+
+      def initialize
+        @timer    = 30
+        @bind     = '0.0.0.0'
+        @port     = 22195
+        @log_file = '/var/log/apnd.log'
+      end
+    end
+
+    #
+    # Settings for APND::Notification
+    #
+    class Notification
+
+      #
+      # Host to send notification to, usually the one running APND::Daemon
+      #
+      #   Default: localhost
+      #
+      attr_accessor :host
+
+      #
+      # Port to send notifications to
+      #
+      #   Default: 22195
+      #
+      attr_accessor :port
+
+      def initialize
+        @host = 'localhost'
+        @port = 22195
+      end
+    end
+
+    #
+    # Returns the AppleConnection settings
+    #
+    def apple
+      @apple ||= APND::Settings::AppleConnection.new
+    end
+
+    #
+    # Returns the Daemon settings
+    #
+    def daemon
+      @daemon ||= APND::Settings::Daemon.new
+    end
+
+    #
+    # Returns the Notification settings
+    #
+    def notification
+      @notification ||= APND::Settings::Notification.new
+    end
+  end
+end

data/lib/apnd/version.rb

@@ -0,0 +1,11 @@
+module APND
+  class Version
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 1
+
+    def self.to_s
+      [MAJOR, MINOR, TINY].join('.')
+    end
+  end
+end

data/test/daemon_test.rb

@@ -0,0 +1,5 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+context "APND Daemon" do
+
+end

data/test/notification_test.rb

@@ -0,0 +1,5 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+context "APND Notification" do
+
+end

data/test/test_helper.rb

@@ -0,0 +1,28 @@
+require 'rubygems'
+require 'test/unit'
+
+dir = File.dirname(File.expand_path(__FILE__))
+$LOAD_PATH.unshift(File.join(dir, '..', 'lib'))
+$LOAD_PATH.unshift(dir)
+
+require 'apnd'
+
+##
+# test/spec/mini 3
+# http://gist.github.com/25455
+# chris@ozmm.org
+#
+def context(*args, &block)
+  return super unless (name = args.first) && block
+  require 'test/unit'
+  klass = Class.new(defined?(ActiveSupport::TestCase) ? ActiveSupport::TestCase : Test::Unit::TestCase) do
+    def self.test(name, &block)
+      define_method("test_#{name.gsub(/\W/,'_')}", &block) if block
+    end
+    def self.xtest(*args) end
+    def self.setup(&block) define_method(:setup, &block) end
+    def self.teardown(&block) define_method(:teardown, &block) end
+  end
+  (class << klass; self end).send(:define_method, :name) { name.gsub(/\W/,'_') }
+  klass.class_eval &block
+end

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification 
+name: apnd
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Joshua Priddle
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-29 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: eventmachine
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: daemons
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+description: |
+  
+      # APND
+  
+      APND (Apple Push Notification Daemon) is a ruby library to send Apple Push
+      Notifications (APNs) to iPhones.
+  
+      Apple recommends application developers create one connection to their
+      upstream push notification server, rather than creating one per notification.
+  
+      APND acts as an intermediary between your application and Apple. Your
+      application's notifications are queued to APND, which are then sent to
+      Apple over a single connection.
+  
+      Within ruby applications, `APND::Notification` can be used to send
+      notifications to a running APND instance or directly to Apple. A command
+      line utility, `apnd-push`, can be used to send single notifications for
+      testing purposes.
+
+email: jpriddle@nevercraft.net
+executables: 
+- apnd
+- apnd-push
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- Rakefile
+- README.markdown
+- bin/apnd
+- bin/apnd-push
+- lib/apnd/daemon/apple_connection.rb
+- lib/apnd/daemon/protocol.rb
+- lib/apnd/daemon.rb
+- lib/apnd/errors.rb
+- lib/apnd/notification.rb
+- lib/apnd/settings.rb
+- lib/apnd/version.rb
+- lib/apnd.rb
+- test/daemon_test.rb
+- test/notification_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/itspriddle/apnd
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: "APND: Apple Push Notification Daemon sends Apple Push Notifications to iPhones"
+test_files: []
+