apns2 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0ac0c780f0cde30860df46c813c72aeb7609384d
+  data.tar.gz: b868ddb5134f4413338de61d1798a163d06987a8
+SHA512:
+  metadata.gz: 4885e71a0cfef0a0facda6dbf69ebbf56d03451864b1942e0ab93c1d26b4eeb7f2060ed309b76d83af874e7ca3b3a3ccfa54e5ea98758c60ff78264e43735588
+  data.tar.gz: 7a356b6994a0c66e9b7675d0f13da6876621078d119d08e03e55df9101ca8a2543b397192d1474119d8507a18d31c82c2826145393f603db1d537d7db7630048

data/.gitignore

@@ -0,0 +1 @@
+/nbproject/

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2009 James Pozdena, 2015 Jordi Cazorla, Oliver Valls
+ 
+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.textile

@@ -0,0 +1,135 @@
+h1. APNS
+
+A gem for the Apple Push Notification Service, based on apns popular gem (https://github.com/jpoz/APNS) but with optimizations for big batches connection failure tolerance.
+
+h2. Install
+
+sudo gem install apns
+
+h2. Setup:
+
+Convert your certificate
+
+In Keychain access export your certificate as a p12. Then run the following command to convert it to a .pem
+
+<pre>
+  <code>
+    openssl pkcs12 -in cert.p12 -out cert.pem -nodes -clcerts
+  </code>
+</pre>
+
+After you have your .pem file. Set what host, port, certificate file location on the APNS class:
+
+<pre>
+  <code>
+    APNS.host = 'gateway.push.apple.com' 
+    # gateway.sandbox.push.apple.com is default
+
+    APNS.pem  = '/path/to/pem/file'
+    # this is the file you just created
+    
+    APNS.port = 2195 
+    # this is also the default. Shouldn't ever have to set this, but just in case Apple goes crazy, you can.
+  </code>
+</pre>
+
+h2. Example (Single notification):
+
+Then to send a push notification you can either just send a string as the alert or give it a hash for the alert, badge and sound.
+
+<pre>
+  <code>
+    device_token = '123abc456def'
+
+    APNS.send_notification(device_token, 'Hello iPhone!' )
+
+    APNS.send_notification(device_token, :alert => 'Hello iPhone!', :badge => 1, :sound => 'default')
+  </code>
+</pre>
+
+h2. Example (Multiple notifications):
+
+You can also send multiple notifications using the same connection to Apple:
+
+<pre>
+  <code>
+    device_token = '123abc456def'
+
+    n1 = APNS::Notification.new(device_token, 'Hello iPhone!' )
+
+    n2 = APNS::Notification.new(device_token, :alert => 'Hello iPhone!', :badge => 1, :sound => 'default')
+    
+    APNS.send_notifications([n1, n2])
+  </code>
+</pre>
+
+
+h2. Send other info along with aps
+
+You can send other application specific information as well.
+
+<pre>
+  <code>
+    APNS.send_notification(device_token, :alert => 'Hello iPhone!', :badge => 1, :sound => 'default',
+                                         :other => {:sent => 'with apns gem'})
+  </code>
+</pre>
+
+This will add the other hash to the same level as the aps hash:
+
+<pre>
+  <code>
+    {"aps":{"alert":"Hello iPhone!","badge":1,"sound":"default"},"sent":"with apns gem"}
+  </code>
+</pre>
+
+
+h2. Getting your iPhone's device token
+
+After you setup push notification for your application with Apple. You need to ask Apple for you application specific device token.
+
+h3. ApplicationAppDelegate.m
+
+<pre>
+  <code>
+    - (void)applicationDidFinishLaunching:(UIApplication *)application 
+    {    
+        // Register with apple that this app will use push notification
+        [[UIApplication sharedApplication] registerForRemoteNotificationTypes:(UIRemoteNotificationTypeAlert | 
+          UIRemoteNotificationTypeSound | UIRemoteNotificationTypeBadge)];
+
+        // Your app startup logic...
+        return YES;
+    }
+
+    - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken 
+    {
+        // Convert the binary data token into an NSString (see below for the implementation of this function)
+        NSString *deviceTokenAsString = stringFromDeviceTokenData(deviceToken);
+
+        // Show the device token obtained from apple to the log
+        NSLog(@"deviceToken: %@", deviceTokenAsString);
+    }
+  </code>
+</pre>
+
+h3. stringFromDeviceTokenData function
+
+This snippet comes from "this stackoverflow post's anwser":http://stackoverflow.com/a/1990880/855846.
+<pre>
+  <code>
+    NSString* stringFromDeviceTokenData(NSData *deviceToken)
+    {
+      const char *data = [deviceToken bytes];
+      NSMutableString* token = [NSMutableString string];
+      
+      for (int i = 0; i < [deviceToken length]; i++) {
+        [token appendFormat:@"%02.2hhX", data[i]];
+      }
+      
+      return [[token copy] autorelease];
+    }
+  </code>
+</pre>
+
+For more information on Apple Push Notifications you can see Apple Developer Documentation "here":http://developer.apple.com/library/mac/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/IPhoneOSClientImp/IPhoneOSClientImp.html#//apple_ref/doc/uid/TP40008194-CH103-SW2.

data/Rakefile

@@ -0,0 +1,53 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'rubygems/specification'
+require 'date'
+require 'spec/rake/spectask'
+ 
+GEM = 'apns'
+GEM_NAME = 'apns'
+GEM_VERSION = '0.9.0'
+AUTHORS = ['James Pozdena']
+EMAIL = "jpoz@jpoz.net"
+HOMEPAGE = "http://github.com/jpoz/apns"
+SUMMARY = "Simple Apple push notification service gem"
+ 
+spec = Gem::Specification.new do |s|
+  s.name = GEM
+  s.version = GEM_VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["MIT-LICENSE"]
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.authors = AUTHORS
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  s.require_path = 'lib'
+  s.autorequire = GEM
+  s.files = %w(MIT-LICENSE README.textile Rakefile) + Dir.glob("{lib}/**/*")
+end
+ 
+task :default => :spec
+ 
+desc "Run specs"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.spec_opts = %w(-fs --color)
+end
+ 
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+ 
+desc "install the gem locally"
+task :install => [:package] do
+  sh %{sudo gem install pkg/#{GEM}-#{GEM_VERSION}}
+end
+ 
+desc "create a gemspec file"
+task :make_spec do
+  File.open("#{GEM}.gemspec", "w") do |file|
+    file.puts spec.to_ruby
+  end
+end

data/apns2.gemspec

@@ -0,0 +1,20 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = 'apns2'
+  spec.version       = '0.0.1'
+  spec.authors       = ['jordi', 'oliver']
+  spec.email         = ['oliver.vh@coditramuntana.com', 'jordi.cr@coditramuntana.com']
+  spec.summary       = %q{Optimization to apns gem for big batches.}
+  spec.description   = %q{Supports failures during big batch sendings.}
+  spec.homepage      = 'https://github.com/tramuntanal/apns2'
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+end

data/lib/apns.rb

@@ -0,0 +1,2 @@
+require 'apns/core'
+require 'apns/notification'

data/lib/apns/core.rb

@@ -0,0 +1,91 @@
+module APNS
+  require 'socket'
+  require 'openssl'
+  require 'json'
+
+  @host = 'gateway.sandbox.push.apple.com'
+  @port = 2195
+  # openssl pkcs12 -in mycert.p12 -out client-cert.pem -nodes -clcerts
+  @pem = nil # this should be the path of the pem file not the contentes
+  @pass = nil
+
+  class << self
+    attr_accessor :host, :pem, :port, :pass
+  end
+
+  def self.send_notification(device_token, message)
+    n = APNS::Notification.new(device_token, message)
+    self.send_notifications([n])
+  end
+
+  def self.send_notifications(notifications)
+    sock, ssl = self.open_connection
+
+    notifications.each do |n|
+      sock, ssl= send_to_apns(sock, ssl, n)
+    end
+
+    ssl.close
+    sock.close
+  end
+
+  def self.feedback
+    sock, ssl = self.feedback_connection
+
+    apns_feedback = []
+
+    while message = ssl.read(38)
+      timestamp, token_size, token = message.unpack('N1n1H*')
+      apns_feedback << [Time.at(timestamp), token]
+    end
+
+    ssl.close
+    sock.close
+
+    return apns_feedback
+  end
+
+  protected
+
+  def self.open_connection
+    raise "The path to your pem file is not set. (APNS.pem = /path/to/cert.pem)" unless self.pem
+    raise "The path to your pem file does not exist!" unless File.exist?(self.pem)
+
+    context      = OpenSSL::SSL::SSLContext.new
+    context.cert = OpenSSL::X509::Certificate.new(File.read(self.pem))
+    context.key  = OpenSSL::PKey::RSA.new(File.read(self.pem), self.pass)
+
+    sock         = TCPSocket.new(self.host, self.port)
+    ssl          = OpenSSL::SSL::SSLSocket.new(sock,context)
+    ssl.connect
+
+    return sock, ssl
+  end
+
+  def self.feedback_connection
+    raise "The path to your pem file is not set. (APNS.pem = /path/to/cert.pem)" unless self.pem
+    raise "The path to your pem file does not exist!" unless File.exist?(self.pem)
+
+    context      = OpenSSL::SSL::SSLContext.new
+    context.cert = OpenSSL::X509::Certificate.new(File.read(self.pem))
+    context.key  = OpenSSL::PKey::RSA.new(File.read(self.pem), self.pass)
+
+    fhost = self.host.gsub('gateway','feedback')
+    puts fhost
+
+    sock         = TCPSocket.new(fhost, 2196)
+    ssl          = OpenSSL::SSL::SSLSocket.new(sock,context)
+    ssl.connect
+
+    return sock, ssl
+  end
+
+  def self.send_to_apns(sock, ssl, n, first_try=true)
+    ssl.write(n.packaged_notification)
+  rescue Exception => e
+    sock, ssl= self.open_connection unless ssl.closed?
+    sock, ssl= send_to_apns(sock, ssl, n, false) if first_try
+  ensure
+    return sock, ssl
+  end
+end

data/lib/apns/notification.rb

@@ -0,0 +1,39 @@
+module APNS
+  class Notification
+    attr_accessor :device_token, :alert, :badge, :sound, :other
+
+    def initialize(device_token, message)
+      self.device_token = device_token
+      if message.is_a?(Hash)
+        self.alert = message[:alert]
+        self.badge = message[:badge]
+        self.sound = message[:sound]
+        self.other = message[:other]
+      elsif message.is_a?(String)
+        self.alert = message
+      else
+        raise "Notification needs to have either a hash or string"
+      end
+    end
+
+    def packaged_notification
+      pt = self.packaged_token
+      pm = self.packaged_message
+      [0, 0, 32, pt, 0, pm.bytesize, pm].pack("ccca*cca*")
+    end
+
+    def packaged_token
+      [device_token.gsub(/[\s|<|>]/,'')].pack('H*')
+    end
+
+    def packaged_message
+      aps = {'aps'=> {} }
+      aps['aps']['alert'] = self.alert if self.alert
+      aps['aps']['badge'] = self.badge if self.badge
+      aps['aps']['sound'] = self.sound if self.sound
+      aps.merge!(self.other) if self.other
+      aps.to_json
+    end
+
+  end
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: apns2
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- jordi
+- oliver
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-06 00:00:00.000000000 Z
+dependencies: []
+description: Supports failures during big batch sendings.
+email:
+- oliver.vh@coditramuntana.com
+- jordi.cr@coditramuntana.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- MIT-LICENSE
+- README.textile
+- Rakefile
+- apns2.gemspec
+- lib/apns.rb
+- lib/apns/core.rb
+- lib/apns/notification.rb
+homepage: https://github.com/tramuntanal/apns2
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Optimization to apns gem for big batches.
+test_files: []