bmo 0.8.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 39304f792a910d0a9f4e7e1e50067919aa28ec67
+  data.tar.gz: 2a478f2e6fc7e7b0e80fc87a492bf63a024e7338
+SHA512:
+  metadata.gz: 2979469971ebf385203814428d3d7fe6e18a3bdae760f6994fef7c43eacb964bb160b00f41b179f4346540988fe036678a8e00b186f4847cbf98c99492048ee6
+  data.tar.gz: a41eedfd88a9f130fe2408ddc2c6894843792019badc9ed10df6fbd239b6860822cce989e97c1d6bd8975d2794be747f1e188f92d2133049143298104b5f2111

data/.gitignore

@@ -0,0 +1,2 @@
+
+tags

data/.rspec

@@ -0,0 +1,4 @@
+--color
+--format progress
+--warnings
+--order random

data/Gemfile

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in poleica.gemspec
+gemspec
+
+group :test do
+  gem 'rspec'
+  gem 'coveralls'
+  gem 'flay'
+  gem 'flog'
+  gem 'reek'
+  gem 'rubocop'
+  gem 'simplecov'
+end
+
+group :development do
+  gem 'jazz_hands'
+
+  # Guards
+  gem 'guard'
+  gem 'guard-bundler'
+  gem 'guard-rspec'
+  gem 'guard-rubocop'
+  gem 'guard-flay', github: 'pericles/guard-flay'
+  gem 'guard-reek', github: 'pericles/guard-reek'
+  gem 'guard-flog', github: 'antoinelyset/guard-flog'
+end
+
+group :darwin do
+  gem 'terminal-notifier-guard'
+end

data/Gemfile.lock

@@ -0,0 +1,237 @@
+GIT
+  remote: git://github.com/antoinelyset/guard-flog.git
+  revision: 40ea28590ae29349860901d3c9b8253b24c31588
+  specs:
+    guard-flog (0.0.1)
+      flog (~> 4.2.0)
+      guard (>= 1.8)
+
+GIT
+  remote: git://github.com/pericles/guard-flay.git
+  revision: 75b9be79c12394626af0064bcec1075959c3cbdd
+  specs:
+    guard-flay (0.0.1)
+      flay (~> 2.4.0)
+      flay-haml (~> 0.0.3)
+      guard (>= 1.8)
+
+GIT
+  remote: git://github.com/pericles/guard-reek.git
+  revision: febe7ac4f4c6f029a30a9213e92bc1ba44b4e2d4
+  specs:
+    guard-reek (0.0.1)
+      guard (>= 1.8)
+      reek (~> 1.3.2)
+
+PATH
+  remote: .
+  specs:
+    bmo (0.8.0)
+      equalizer (~> 0.0.0)
+      faraday (~> 0.8.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionpack (4.0.2)
+      activesupport (= 4.0.2)
+      builder (~> 3.1.0)
+      erubis (~> 2.7.0)
+      rack (~> 1.5.2)
+      rack-test (~> 0.6.2)
+    activesupport (4.0.2)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    ast (1.1.0)
+    atomic (1.1.14)
+    awesome_print (1.2.0)
+    binding_of_caller (0.7.2)
+      debug_inspector (>= 0.0.1)
+    builder (3.1.4)
+    celluloid (0.15.2)
+      timers (~> 1.1.0)
+    coderay (1.1.0)
+    columnize (0.3.6)
+    coolline (0.4.2)
+    coveralls (0.7.0)
+      multi_json (~> 1.3)
+      rest-client
+      simplecov (>= 0.7)
+      term-ansicolor
+      thor
+    debug_inspector (0.0.2)
+    debugger (1.6.3)
+      columnize (>= 0.3.1)
+      debugger-linecache (~> 1.2.0)
+      debugger-ruby_core_source (~> 1.2.4)
+    debugger-linecache (1.2.0)
+    debugger-ruby_core_source (1.2.4)
+    diff-lcs (1.2.5)
+    diffy (3.0.1)
+    docile (1.1.1)
+    equalizer (0.0.8)
+    erubis (2.7.0)
+    faraday (0.8.8)
+      multipart-post (~> 1.2.0)
+    ffi (1.9.3)
+    flay (2.4.0)
+      ruby_parser (~> 3.0)
+      sexp_processor (~> 4.0)
+    flay-haml (0.0.3)
+      flay (>= 1.2, < 3)
+      haml (>= 3, < 5)
+    flog (4.2.0)
+      ruby_parser (~> 3.1, > 3.1.0)
+      sexp_processor (~> 4.4)
+    formatador (0.2.4)
+    grit (2.5.0)
+      diff-lcs (~> 1.1)
+      mime-types (~> 1.15)
+      posix-spawn (~> 0.3.6)
+    guard (2.2.4)
+      formatador (>= 0.2.4)
+      listen (~> 2.1)
+      lumberjack (~> 1.0)
+      pry (>= 0.9.12)
+      thor (>= 0.18.1)
+    guard-bundler (2.0.0)
+      bundler (~> 1.0)
+      guard (~> 2.2)
+    guard-rspec (4.2.0)
+      guard (>= 2.1.1)
+      rspec (>= 2.14, < 4.0)
+    guard-rubocop (1.0.1)
+      guard (~> 2.0)
+      rubocop (~> 0.10)
+    haml (4.0.4)
+      tilt
+    hirb (0.7.1)
+    i18n (0.6.9)
+    jazz_hands (0.5.2)
+      awesome_print (~> 1.2)
+      coolline (>= 0.4.2)
+      hirb (~> 0.7.1)
+      pry (~> 0.9.12)
+      pry-debugger (~> 0.2.2)
+      pry-doc (~> 0.4.6)
+      pry-git (~> 0.2.3)
+      pry-rails (~> 0.3.2)
+      pry-remote (>= 0.1.7)
+      pry-stack_explorer (~> 0.4.9)
+      railties (>= 3.0, < 5.0)
+    listen (2.4.0)
+      celluloid (>= 0.15.2)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    lumberjack (1.0.4)
+    method_source (0.8.2)
+    mime-types (1.25.1)
+    minitest (4.7.5)
+    multi_json (1.8.2)
+    multipart-post (1.2.0)
+    parser (2.0.0)
+      ast (~> 1.1)
+      slop (~> 3.4, >= 3.4.5)
+    posix-spawn (0.3.8)
+    powerpack (0.0.9)
+    pry (0.9.12.4)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    pry-debugger (0.2.2)
+      debugger (~> 1.3)
+      pry (~> 0.9.10)
+    pry-doc (0.4.6)
+      pry (>= 0.9)
+      yard (>= 0.8)
+    pry-git (0.2.3)
+      diffy
+      grit
+      pry (>= 0.9.8)
+    pry-rails (0.3.2)
+      pry (>= 0.9.10)
+    pry-remote (0.1.7)
+      pry (~> 0.9)
+      slop (~> 3.0)
+    pry-stack_explorer (0.4.9.1)
+      binding_of_caller (>= 0.7)
+      pry (>= 0.9.11)
+    rack (1.5.2)
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    railties (4.0.2)
+      actionpack (= 4.0.2)
+      activesupport (= 4.0.2)
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rainbow (1.1.4)
+    rake (10.1.0)
+    rb-fsevent (0.9.3)
+    rb-inotify (0.9.2)
+      ffi (>= 0.5.0)
+    reek (1.3.4)
+      ruby2ruby (~> 2.0.2)
+      ruby_parser (~> 3.2)
+      sexp_processor
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.7)
+    rspec-expectations (2.14.4)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.4)
+    rubocop (0.15.0)
+      parser (~> 2.0)
+      powerpack (~> 0.0.6)
+      rainbow (>= 1.1.4)
+    ruby2ruby (2.0.6)
+      ruby_parser (~> 3.1)
+      sexp_processor (~> 4.0)
+    ruby_parser (3.2.2)
+      sexp_processor (~> 4.1)
+    sexp_processor (4.4.0)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    slop (3.4.7)
+    term-ansicolor (1.2.2)
+      tins (~> 0.8)
+    terminal-notifier-guard (1.5.3)
+    thor (0.18.1)
+    thread_safe (0.1.3)
+      atomic
+    tilt (2.0.0)
+    timers (1.1.0)
+    tins (0.13.1)
+    tzinfo (0.3.38)
+    yard (0.8.7.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bmo!
+  coveralls
+  flay
+  flog
+  guard
+  guard-bundler
+  guard-flay!
+  guard-flog!
+  guard-reek!
+  guard-rspec
+  guard-rubocop
+  jazz_hands
+  reek
+  rspec
+  rubocop
+  simplecov
+  terminal-notifier-guard

data/Guardfile

@@ -0,0 +1,27 @@
+guard 'bundler' do
+  watch('Gemfile')
+  watch(/^.+\.gemspec/)
+end
+
+guard :rspec do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+
+guard :rubocop do
+  watch(%r{.+\.rb$})
+  watch(%r{(?:.+/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
+end
+
+guard :flog do
+  watch(%r{^lib/(.+)\.rb$})
+end
+
+guard :reek do
+  watch(%r{^lib/(.+)\.rb$})
+end
+
+guard :flay do
+  watch(%r{^lib/(.+)\.rb$})
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Antoine Lyset
+
+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,88 @@
+<img src="https://raw.github.com/antoinelyset/bmo/master/bmo.png"
+     alt="BMO"
+     align="right"
+     width="150px"/>
+
+<br>
+<br>
+<br>
+
+# BMO (Beemo)
+
+BMO is a gem to Push Notifications to iOS (via APNS) and Android (via GCM)
+
+## Installation
+
+```
+gem install bmo
+```
+
+In Gemfile :
+
+```
+gem 'bmo'
+```
+
+## APNS
+
+### Usage
+
+```ruby
+token = "123456789" # The device token given to you by Apple
+data  = {aps: {alert: "Hello from BMO!"}}
+BMO.send_ios_notification(token, data)
+```
+
+The aps Hash content's is described here :
+
+[https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ApplePushService.html](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ApplePushService.html)
+
+### Configuration
+
+Default Params :
+
+```ruby
+BMO.configuration do |config|
+  config.apns.gateway_host  = 'gateway.push.apple.com'
+  config.apns.gateway_port  =  2195
+  config.apns.feedback_host =  'feedback.push.apple.com'
+  config.apns.feedback_port =  2196
+  config.apns.cert_path     =  nil
+  config.apns.cert_pass     =  nil
+end
+```
+
+If you set a cert_path option it will use a SSL encapsulation otherwise it will use Pure TCP.
+This option is particularly useful if you use a stunnel.
+
+## GCM
+
+### Usage
+
+```ruby
+token = "123456789" # The device token given to you by Apple
+data  = {message: "Hello from BMO!"}
+BMO.send_android_notification(token, data)
+```
+
+The data contennt is described here :
+
+[http://developer.android.com/google/gcm/server.html](http://developer.android.com/google/gcm/server.html)
+
+### Configuration
+
+Default Params :
+
+```ruby
+BMO.configuration do |config|
+  config.gcm.gateway_url  = 'https://android.googleapis.com/gcm/send'
+  config.gcm.api_key      = nil
+end
+```
+
+You should set the api_key.
+
+## License
+
+BMO is released under the [MIT
+License](http://www.opensource.org/licenses/MIT)

data/bmo.gemspec

@@ -0,0 +1,20 @@
+# encoding: utf-8
+
+require File.expand_path('../lib/bmo/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name          = 'bmo'
+  gem.summary       = 'Push notifications to iOS and Android devices'
+  gem.description   = gem.summary
+  gem.authors       = ['Antoine Lyset']
+  gem.email         = ['antoinelyset@gmail.com']
+  gem.homepage      = 'https://github.com/antoinelyset/bmo'
+  gem.require_paths = ['lib']
+  gem.version       = BMO::VERSION.dup
+  gem.files           = `git ls-files`.split("\n")
+  gem.test_files      = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.executables     = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.add_runtime_dependency('equalizer', '~> 0.0.0')
+  gem.add_runtime_dependency('faraday', '~> 0.8.0')
+  gem.license       = 'MIT'
+end

data/lib/bmo/apns/client.rb

@@ -0,0 +1,84 @@
+# encoding: utf-8
+module BMO
+  module APNS
+    # APNS Client Class
+    #
+    # @!attribute gateway_host
+    # @!attribute gateway_port
+    # @!attribute feedback_host
+    # @!attribute feedback_port
+    # @!attribute cert_path
+    # @!attribute cert_pass
+    class Client
+      attr_reader :cert_path,     :cert_pass,
+                  :gateway_host,  :gateway_port,
+                  :feedback_host, :feedback_port
+
+      # The constructor of the Client object
+      #   it will only use a ssl connection if you pass a cert_path option
+      #
+      # @param gateway_host  [String]
+      # @param gateway_port  [Integer]
+      # @param feedback_host [String]
+      # @param feedback_port [Integer]
+      #
+      # @options options [String] :cert_pass
+      # @options options [String] :cert_path path to certificate file
+      #
+      def initialize(gateway_host,  gateway_port,
+                     feedback_host, feedback_port,
+                     options = {})
+        @gateway_host  = gateway_host
+        @gateway_port  = gateway_port
+        @feedback_host = feedback_host
+        @feedback_port = feedback_port
+        @cert_path     = options[:cert_path]
+        @cert_pass     = options[:cert_pass]
+      end
+
+      # @param notification [Notification] the notification to send to Apple
+      #
+      def send_notification(notification)
+        connection = APNS::Connection.new(@gateway_host, @gateway_port,
+                                          @cert_path,    @cert_pass)
+        connection.connect do |socket|
+          socket.write(notification.to_package)
+        end
+      end
+
+      # Get the Feedback from Apple
+      #
+      # @return <Array[FeedbackTuple]> A feedback tuple contains the time
+      #   when Apple determined that the app no longer exists on the device,
+      #   and a the token of device token
+      def get_feedback
+        connection = APNS::Connection.new(@feedback_host, @feedback_port,
+                                          @cert_path,     @cert_pass)
+        connection.connect do |socket|
+          feedback_tuples = []
+          while (data = socket.read(38))
+            tuple = data.unpack('N1n1H*')
+            feedback_tuples << FeedbackTuple.new(tuple[0], tuple[2])
+          end
+          feedback_tuples
+        end
+      end
+
+      private
+
+      # Handle the Feedback Object
+      #
+      # @!attribute time [Time] Time when the device was notified
+      #   but didn't have the app installed
+      # @!attribute token [String] The Token of the device notified wrongly
+      class FeedbackTuple
+        attr_reader :time, :token
+
+        def initialize(timestamp, token)
+          @time  = Time.at(timestamp)
+          @token = token
+        end
+      end
+    end # class Client
+  end # module APNS
+end # module BMO

data/lib/bmo/apns/connection.rb

@@ -0,0 +1,55 @@
+# encoding: utf-8
+module BMO
+  module APNS
+    # Handle the connection state SSL or Pure TCP
+    class Connection
+      attr_reader :host, :port, :cert_path, :cert_pass
+
+      def initialize(host, port, cert_path = nil, cert_pass = nil)
+        @host      = host
+        @port      = port
+        @cert_path = cert_path
+        @cert_pass = cert_pass
+      end
+
+      # Create a connection to Apple. If a cert_path exists it uses SSL else
+      #   a pure TCPSocket. It then yields the socket and handles the closing
+      #
+      # @return The yielded return
+      def connect(&block)
+        socket = cert_path ? ssl_socket : tcp_socket
+
+        yielded = yield socket
+
+        socket.close
+        yielded
+      end
+
+      private
+
+      # @return [TCPSocket]
+      def tcp_socket
+        TCPSocket.new(host, port)
+      end
+
+      # @return [SSLSocket] the SSLSocket connected and setted to sync_close
+      #   to sync tcp_socket and ssl_socket closing.
+      def ssl_socket
+        ssl_socket = OpenSSL::SSL::SSLSocket.new(tcp_socket, ssl_context)
+        ssl_socket.sync_close = true
+        ssl_socket.connect
+        ssl_socket
+      end
+
+      # @return [SSLContext] SSLContext setted with the certificate
+      #
+      def ssl_context
+        cert         = File.read(cert_path)
+        context      = OpenSSL::SSL::SSLContext.new
+        context.cert = OpenSSL::X509::Certificate.new(cert)
+        context.key  = OpenSSL::PKey::RSA.new(cert, cert_pass)
+        context
+      end
+    end # class Connection
+  end # module APNS
+end # module BMO

data/lib/bmo/apns/notification.rb

@@ -0,0 +1,92 @@
+# encoding: utf-8
+module BMO
+  module APNS
+    # The Notification Class handles all the packaging logic
+    class Notification
+      # Define ==
+      include Equalizer.new(:device_token, :payload)
+
+      attr_reader :device_token, :payload
+
+      def initialize(device_token, payload)
+        @device_token = DeviceToken.new(device_token)
+        @payload      = Payload.new(payload)
+      end
+
+      def to_package
+        payload_packaged      = payload.to_package
+        device_token_packaged = device_token.to_package
+        [
+          0, 0,
+          device_token_packaged.size,
+          device_token_packaged,
+          0,
+          payload_packaged.size,
+          payload_packaged
+        ].pack('ccca*cca*')
+      end
+
+      def validate!
+        device_token.validate!
+        payload.validate!
+      end
+
+      private
+
+      # The Payload contains the data sent to Apple
+      class Payload
+        class PayloadTooLarge < Exception; end
+
+        MAX_BYTE_SIZE = 256
+
+        # Define ==
+        include Equalizer.new(:data)
+
+        attr_reader :data
+
+        def initialize(data)
+          @data = Utils.coerce_to_symbols(data)
+        end
+
+        def to_package
+          data.to_json.bytes.to_a.pack('C*')
+        end
+
+        def validate!
+          if to_package.size > MAX_BYTE_SIZE
+            str = <<-EOS
+              Payload size should be less than #{Payload::MAX_BYTE_SIZE} bytes"
+            EOS
+            fail PayloadTooLarge, str
+          end
+          true
+        end
+      end # class Payload
+
+      # The DeviceToken is the id of a Device for an App
+      class DeviceToken
+        # Define ==
+        include Equalizer.new(:token)
+
+        class MalformedDeviceToken < Exception; end
+
+        attr_reader :token
+
+        def initialize(token)
+          @token = token
+        end
+
+        def to_package
+          [token].pack('H*')
+        end
+
+        def validate!
+          unless token =~ /^[a-z0-9]{64}$/i
+            fail(MalformedDeviceToken, 'Malformed Device Token')
+          end
+          true
+        end
+      end # class DeviceToken
+    end # class Notification
+  end # module APNS
+end # module BMO

data/lib/bmo/configuration.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+# Main BMO module
+module BMO
+  # Handles all the configuration per provider
+  class Configuration
+    attr_reader :apns, :gcm
+
+    def initialize
+      @apns = APNS.new
+      @gcm  = GCM.new
+    end
+
+    # APNS Configuration
+    #
+    # @!attribute gateway_host
+    # @!attribute gateway_port
+    # @!attribute feedback_host
+    # @!attribute feedback_port
+    # @!attribute cert_path
+    # @!attribute cert_pass
+    class APNS
+      attr_accessor :cert_path,     :cert_pass,
+                    :gateway_host,  :gateway_port,
+                    :feedback_host, :feedback_port
+
+      def initialize
+        @gateway_host  = 'gateway.push.apple.com'
+        @gateway_port  = 2195
+        @feedback_host = 'feedback.push.apple.com'
+        @feedback_port = 2196
+        @cert_path     = nil
+        @cert_pass     = nil
+      end
+    end
+
+    # GCM Configuration
+    class GCM
+      attr_accessor :gateway_url, :api_key
+      def initialize
+        @gateway_url = 'https://android.googleapis.com/gcm/send'
+        @api_key     = nil
+      end
+    end
+  end # class Configuration
+
+  module_function
+
+  def configure
+    yield(configuration) if block_given?
+    configuration
+  end
+
+  def configuration
+    @configuration ||= Configuration.new
+  end
+
+  # Needed because we can't use module_function and attr_writer
+  # rubocop:disable TrivialAccessors
+  def configuration=(configuration)
+    @configuration = configuration
+  end
+  # rubocop:enable
+
+  def reset_configuration
+    @configuration = Configuration.new
+  end
+end # BMO

data/lib/bmo/gcm/client.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+module BMO
+  module GCM
+    # GCM Client Class
+    class Client
+      attr_reader :gateway_url, :api_key
+
+      def initialize(gateway_url, api_key)
+        @gateway_url = gateway_url
+        @api_key     = api_key
+      end
+
+      # @param notification [Notification] the notification to send to Google
+      #
+      def send_notification(notification)
+        connection = GCM::Connection.new(gateway_url, api_key)
+        connection.connect do |request|
+          request.body = notification.to_package
+        end
+      end
+    end # class Client
+  end # module APNS
+end # module BMO

data/lib/bmo/gcm/connection.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+module BMO
+  module GCM
+    # Handle the connection state SSL or Pure TCP
+    class Connection
+      def initialize(gateway_url, api_key)
+        @gateway_url        = gateway_url
+        @faraday_connection = Faraday::Connection.new(gateway_url)
+        @api_key            = api_key
+      end
+
+      def connect(&block)
+        faraday_connection.post(gateway_url) do |request|
+          request.headers.merge!(content_type: 'application/json',
+                                 authorization: "key=#{api_key}")
+          yield request
+        end
+      end
+
+      protected
+
+      attr_reader :faraday_connection, :gateway_url, :api_key
+    end # class Connection
+  end # module GCM
+end # module BMO

data/lib/bmo/gcm/notification.rb

@@ -0,0 +1,61 @@
+# encoding: utf-8
+module BMO
+  module GCM
+    # The Notification Class handles all the packaging logic
+    class Notification
+      # Define ==
+      include Equalizer.new(:device_token, :payload)
+
+      attr_reader :device_token, :payload
+
+      def initialize(device_token, payload)
+        @device_token = device_token
+        @payload      = Payload.new(payload)
+      end
+
+      def to_package
+        {
+          registration_ids: [device_token],
+          data: payload.to_package
+        }.to_json
+      end
+
+      def validate!
+        payload.validate!
+      end
+
+      private
+
+      # The Payload contains the data sent to Apple
+      class Payload
+        # Error Raised when the payload packaged > MAX_BYTE_SIZE
+        class PayloadTooLarge < Exception; end
+
+        MAX_BYTE_SIZE = 4096
+
+        # Define ==
+        include Equalizer.new(:data)
+
+        attr_reader :data
+
+        def initialize(data)
+          @data = Utils.coerce_to_symbols(data)
+        end
+
+        def to_package
+          data
+        end
+
+        def validate!
+          if to_package.size > MAX_BYTE_SIZE
+            str = <<-EOS
+              Payload size should be less than #{Payload::MAX_BYTE_SIZE} bytes"
+            EOS
+            fail PayloadTooLarge, str
+          end
+          true
+        end
+      end # class Payload
+    end # class Notification
+  end # module APNS
+end # module BMO

data/lib/bmo/utils.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+module BMO
+  # Utility module
+  module Utils
+    module_function
+
+    # Coerce string hash keys to symbols
+    def coerce_to_symbols(hash)
+      hash_symbolized = {}
+      hash.each_pair do |key, value|
+        key = key.to_sym if key.respond_to?(:to_sym)
+        hash_symbolized[key] = value
+      end
+      hash_symbolized
+    end
+  end
+end

data/lib/bmo/version.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+# Main BMO module, version get right here
+module BMO
+  VERSION = '0.8.0'.freeze
+end

data/lib/bmo.rb

@@ -0,0 +1,81 @@
+# encoding: utf-8
+
+require 'socket'
+require 'openssl'
+require 'json'
+require 'equalizer'
+require 'faraday'
+
+require 'bmo/version'
+require 'bmo/configuration'
+require 'bmo/utils'
+
+require 'bmo/apns/notification'
+require 'bmo/apns/connection'
+require 'bmo/apns/client'
+
+require 'bmo/gcm/notification'
+require 'bmo/gcm/connection'
+require 'bmo/gcm/client'
+
+# Main BMO namespace
+module BMO
+  # All the methods will be Class Methods
+  module_function
+
+  # Send ios notification with the configuration of BMO
+  #   (see #BMO::Configuration)
+  #
+  # @param device_token [String]
+  # @param data [Hash] The data you want to send
+  #
+  # @return The Socket#write return
+  #
+  # @see https://developer.apple.com/library/ios/documentation/
+  #   NetworkingInternet/Conceptual/RemoteNotificationsPG/
+  #   Chapters/ApplePushService.html
+  def send_ios_notification(device_token, data)
+    notification = APNS::Notification.new(device_token, data)
+    apns_client.send_notification(notification)
+  end
+
+  # Get the iOS Feedback tuples
+  #
+  # @return [Array<FeedbackTuple>] Feedback Object containing
+  #   a time and a token
+  def get_ios_feedback
+    apns_client.get_feedback
+  end
+
+  # Send android notification with the configuration of BMO
+  #   (see #BMO::Configuration)
+  #
+  # @param device_token [String]
+  # @param data [Hash] The data you want to send
+  #
+  # @return [Faraday::Response] The HTTP Response
+  #
+  # @see http://developer.android.com/google/gcm/server.html]
+  def send_android_notification(device_token, data)
+    notification = GCM::Notification.new(device_token, data)
+    android_client.send_notification(notification)
+  end
+
+  private
+
+  def apns_client
+    conf   = BMO.configuration.apns
+    APNS::Client.new(conf.gateway_host,
+                     conf.gateway_port,
+                     conf.feedback_host,
+                     conf.feedback_port,
+                     cert_path: conf.cert_path,
+                     cert_pass: conf.cert_pass)
+  end
+
+  def gcm_client
+    conf   = BMO.configuration.gcm
+    GCM::Client.new(conf.gateway_url,
+                    conf.api_key)
+  end
+end

data/spec/bmo/apns/notification_spec.rb

@@ -0,0 +1,81 @@
+# encoding: utf-8
+
+require File.dirname(__FILE__) + '../../../spec_helper'
+
+describe BMO::APNS::Notification::DeviceToken do
+  describe '#token' do
+    it 'returns the token' do
+      device_token     = described_class.new('abc')
+      expect(device_token.token).to eq('abc')
+    end
+  end
+
+  describe '#==' do
+    it 'returns true for equal device token' do
+      device_token     = described_class.new('abc')
+      device_token_bis = described_class.new('abc')
+      expect(device_token == device_token_bis).to be_true
+    end
+
+    it 'returns true for equal device token' do
+      device_token     = described_class.new('abc')
+      device_token_bis = described_class.new('abc')
+      expect(device_token).to eq(device_token_bis)
+    end
+
+    it 'returns false for equal device token' do
+      device_token     = described_class.new('abc')
+      device_token_bis = described_class.new('def')
+      expect(device_token).to_not eq(device_token_bis)
+    end
+
+    it 'returns true for equal device token' do
+      device_token     = described_class.new('abc')
+      device_token_bis = described_class.new('def')
+      expect(device_token == device_token_bis).to be_false
+    end
+  end
+
+  describe '#validate!' do
+    it 'returns true if the token is 64 chars' do
+      device_token = described_class.new('a' * 64)
+      expect(device_token.validate!).to be_true
+    end
+
+    it 'returns false if the token is not 64 chars' do
+      device_token = described_class.new('a' * 63)
+      expect { device_token.validate! }.to raise_error
+        BMO::APNS::Notification::DeviceToken::MalformedDeviceToken
+    end
+
+    it 'returns false if the token contains a special char' do
+      device_token = described_class.new(('a' * 63) + '"')
+      expect { device_token.validate! }.to raise_error
+        BMO::APNS::Notification::DeviceToken::MalformedDeviceToken
+    end
+  end
+
+  describe '#to_package' do
+    it 'returns the packaged token' do
+      device_token = described_class.new('0' * 64)
+      expect(device_token.to_package).to eq("\x00" * 32)
+    end
+  end
+end
+
+describe BMO::APNS::Notification::Payload do
+  it 'coerce hash keys to symbols' do
+    payload = described_class.new('Finn' => 'The Human')
+    expect(payload.data).to eq(Finn: 'The Human')
+  end
+
+  it "doesn't coerce incompatible types" do
+    payload = described_class.new(1 => 'For Money')
+    expect(payload.data).to eq(1 => 'For Money')
+  end
+
+  it 'returns true for equality between coerced hash and symbolized hash ' do
+    payload = described_class.new('Jake' => 'The Dog')
+    expect(payload).to eq(described_class.new(Jake: 'The Dog'))
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+# encoding: utf-8
+require 'bmo'

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: bmo
+version: !ruby/object:Gem::Version
+  version: 0.8.0
+platform: ruby
+authors:
+- Antoine Lyset
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: equalizer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.0
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+description: Push notifications to iOS and Android devices
+email:
+- antoinelyset@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- LICENSE
+- README.md
+- bmo.gemspec
+- bmo.png
+- lib/bmo.rb
+- lib/bmo/apns/client.rb
+- lib/bmo/apns/connection.rb
+- lib/bmo/apns/notification.rb
+- lib/bmo/configuration.rb
+- lib/bmo/gcm/client.rb
+- lib/bmo/gcm/connection.rb
+- lib/bmo/gcm/notification.rb
+- lib/bmo/utils.rb
+- lib/bmo/version.rb
+- spec/bmo/apns/notification_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/antoinelyset/bmo
+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.1.11
+signing_key: 
+specification_version: 4
+summary: Push notifications to iOS and Android devices
+test_files:
+- spec/bmo/apns/notification_spec.rb
+- spec/spec_helper.rb
+has_rdoc: