device_cloud 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--format nested
+--color

data/.ruby-version

@@ -0,0 +1 @@
+1.9.3-p392

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in device_cloud.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Erik Straub
+
+MIT License
+
+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,29 @@
+# DeviceCloud
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'device_cloud'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install device_cloud
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/device_cloud.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'device_cloud/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "device_cloud"
+  spec.version       = DeviceCloud::VERSION
+  spec.authors       = ["Erik Straub"]
+  spec.email         = ["erik@madgloryint.com"]
+  spec.description   = %q{A Ruby wrapper for the Etherios Device Cloud}
+  spec.summary       = %q{A Ruby wrapper for the Etherios Device Cloud}
+  spec.homepage      = "http://github.com/madgloryint/device_cloud"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  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"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+
+  spec.add_development_dependency 'rspec'
+end

data/lib/device_cloud/configuration.rb

@@ -0,0 +1,70 @@
+require 'logger'
+
+module DeviceCloud
+  module Configuration
+
+    # DeviceCloud account root_url
+    attr_writer :root_url
+
+    # DeviceCloud account username
+    attr_writer :username
+
+    # DeviceCloud account password
+    attr_writer :password
+
+    # DeviceCloud defualt logger
+    attr_writer :logger
+
+    # Proc that will be called for handling
+    # DeviceCloud::PushNotification::Event objects
+    # Proc will be called with the event object
+    attr_accessor :push_notification_event_handler
+
+    # Proc that will be called for handling
+    # DeviceCloud::PushNotification::Alert objects
+    # Proc will be called with the alert object
+    attr_accessor :push_notification_alert_handler
+
+    # Yield self to be able to configure ActivityFeed with
+    # block-style configuration.
+    #
+    # Example:
+    #
+    #   ActivityFeed.configure do |configuration|
+    #     configuration.root_url = 'https://example.com'
+    #   end
+    def configure
+      yield self
+    end
+
+    # DeviceCloud url
+    #
+    # @return the DeviceCloud url or the default of 'https://my.idigi.com' if not set.
+    def root_url
+      @root_url ||= 'https://my.idigi.com'
+    end
+
+    # DeviceCloud username
+    #
+    # @return the DeviceCloud username or raises an error
+    def username
+      raise 'DeviceCloud username is blank' if @username.blank?
+      @username
+    end
+
+    # DeviceCloud password
+    #
+    # @return the DeviceCloud password or raises an error
+    def password
+      raise 'DeviceCloud password is blank' if @password.blank?
+      @password
+    end
+
+    # DeviceCloud logger
+    #
+    # @return the DeviceCloud logger or set the default to stdout
+    def logger
+      @root_url ||= Logger.new(STDOUT)
+    end
+  end
+end

data/lib/device_cloud/push_notification/alert.rb

@@ -0,0 +1,7 @@
+module DeviceCloud
+  class PushNotification::Alert < PushNotification::Base
+    def handle!
+      DeviceCloud.push_notification_alert_handler.call(self)
+    end
+  end
+end

data/lib/device_cloud/push_notification/base.rb

@@ -0,0 +1,27 @@
+module DeviceCloud
+  class PushNotification::Base
+    attr_reader :id, :device_id, :value, :queued_at, :type
+    
+    def self.handle!(file_data)
+      event = new(file_data)
+      event.handle!
+    end
+
+    def initialize(file_data)
+      @file_data = file_data
+      @id = data["id"]
+      @device_id = data["device_id"]
+      @type = data["type"]
+      @queued_at = data["queued_dt"]
+      @value = data["value"]
+    end
+
+    def handle!
+      raise NotImplementedError
+    end
+
+    def data
+      @file_data.data
+    end
+  end
+end

data/lib/device_cloud/push_notification/event.rb

@@ -0,0 +1,7 @@
+module DeviceCloud
+  class PushNotification::Event < PushNotification::Base
+    def handle!
+      DeviceCloud.push_notification_event_handler.call(self)
+    end
+  end
+end

data/lib/device_cloud/push_notification/message/file_data.rb

@@ -0,0 +1,64 @@
+require 'json'
+require 'base64'
+
+module DeviceCloud
+  class PushNotification::Message::FileData
+    attr_accessor :id, :fdLastModifiedDate, :fdSize, :fdContentType, :fdData, :fdArchive, :cstId, :fdType, :fdCreatedDate
+    attr_reader :errors
+
+    def initialize(attributes = {})
+      @errors = []
+      attributes.each do |name, value|
+        send("#{name}=", value)
+      end
+      DeviceCloud.logger.warn "DeviceCloud::PushNotification::Message::FileData Invalid (#{errors.join(',')}) - #{full_path}" unless valid?
+    end
+
+    def full_path
+      file_path + file_name
+    end
+
+    def data
+      return false unless valid?
+      @data ||= JSON.parse unencoded_data
+    end
+
+    def file_name
+      return '' unless id
+      id['fdName']
+    end
+
+    def file_path
+      return '' unless id
+      id['fdPath']
+    end
+
+    def valid?
+      return false if @errors.any?
+      validate_content_type! && validate_content!
+    end
+  private
+
+    def unencoded_data
+      @unencode_data ||= Base64.decode64(fdData)
+    end
+
+    def validate_content_type!
+      if file_name =~ /\.json/
+        true
+      else
+        @errors << 'wrong file type'
+        false
+      end
+    end
+
+    def validate_content!
+      if fdData.size == 0 || fdSize.to_i < 1
+        @errors << 'no content'
+        false
+      else
+        true
+      end
+    end
+  end
+end

data/lib/device_cloud/push_notification/message.rb

@@ -0,0 +1,54 @@
+module DeviceCloud
+  class PushNotification::Message
+    attr_accessor :timestamp, :topic, :file_data, :operation, :group, :replay
+
+    ALLOWED_TOPICS = %w{alert event}
+
+    def self.parse_raw_messages(raw_message_data)
+      if raw_message_data.is_a? Array
+        messages = raw_message_data.map {|message| new(message) }
+      else
+        messages = [new(raw_message_data)]
+      end
+      messages
+    end
+
+    def initialize(attributes = {})
+      attributes.each do |name, value|
+        if name == 'FileData'
+          @file_data = value
+        else
+          send("#{name}=", value)
+        end
+      end
+      DeviceCloud.logger.warn "DeviceCloud::PushNotification::Message Invalid (no content) - #{topic}" unless valid?
+    end
+
+    def parsed_file_data
+      return false unless valid?
+      @parsed_file_data ||= FileData.new file_data
+    end
+
+    def valid?
+      !!file_data && topic_allowed?
+    end
+
+    def valid_parsed_file_data?
+      parsed_file_data.valid?
+    end
+
+    def topic_type
+      topic_matches.first
+    end
+
+  private
+    def topic_allowed?
+      return false if !topic
+      topic_matches.any?
+    end
+
+    def topic_matches
+      topic.split('/') & ALLOWED_TOPICS
+    end
+  end
+end

data/lib/device_cloud/push_notification.rb

@@ -0,0 +1,23 @@
+module DeviceCloud
+  class PushNotification
+    attr_reader :messages
+
+    def initialize(raw_messages)
+      @messages = DeviceCloud::PushNotification::Message.parse_raw_messages(raw_messages)
+    end
+
+    def handle_each!
+      messages.each do |message|
+        next unless message.valid? && message.valid_parsed_file_data?
+
+        klass = class_type(message.topic_type)
+        
+        klass.handle!(message.parsed_file_data)
+      end
+    end
+  private
+    def class_type(class_name)
+      DeviceCloud.constantize "DeviceCloud::PushNotification::#{class_name.capitalize}"
+    end
+  end
+end

data/lib/device_cloud/utils.rb

@@ -0,0 +1,11 @@
+module DeviceCloud
+  module Utils
+    def mac_address_from_device_id(device_id)
+      device_id.sub(/\Am:/, '').scan(/.{2}|.+/).join(':')
+    end
+
+    def constantize(string)
+      string.split("::").inject(Module) {|acc, val| acc.const_get(val)}
+    end
+  end
+end

data/lib/device_cloud/version.rb

@@ -0,0 +1,3 @@
+module DeviceCloud
+  VERSION = "0.0.1"
+end

data/lib/device_cloud.rb

@@ -0,0 +1,14 @@
+require 'device_cloud/configuration'
+require 'device_cloud/utils'
+require 'device_cloud/version'
+require 'device_cloud/push_notification'
+require 'device_cloud/push_notification/base'
+require 'device_cloud/push_notification/alert'
+require 'device_cloud/push_notification/event'
+require 'device_cloud/push_notification/message'
+require 'device_cloud/push_notification/message/file_data'
+
+module DeviceCloud
+  extend Configuration
+  extend Utils
+end

data/spec/device_cloud/push_notification/alert_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe DeviceCloud::PushNotification::Alert do
+  describe "#handle!" do
+    let(:data) do
+      {
+        'id' => 1234,
+        'device_id' => 'm:1392301029',
+        'type' => 'some type',
+        'queued_dt' => '2013-06-24T14:52:55.421Z',
+        'value' => {'this' => 'is a value'}
+      }
+    end
+    let(:file_data) { OpenStruct.new(data: data, full_path: '/foo/bar/baz.json') }
+
+    subject { DeviceCloud::PushNotification::Alert.new file_data }
+
+    it "should call the DeviceCloud.push_notification_alert_handler with self" do
+      handled_alert = nil
+      DeviceCloud.push_notification_alert_handler = ->(alert) { handled_alert = alert }
+
+      subject.handle!
+      expect(handled_alert).to eq subject
+    end
+  end
+end

data/spec/device_cloud/push_notification/base_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe DeviceCloud::PushNotification::Base do
+  let(:data) do
+    {
+      'id' => 1234,
+      'device_id' => 'm:1392301029',
+      'type' => 'some type',
+      'queued_dt' => '2013-06-24T14:52:55.421Z',
+      'value' => {'this' => 'is a value'}
+    }
+  end
+  let(:file_data) { OpenStruct.new(data: data, full_path: '/foo/bar/baz.json') }
+
+  subject { DeviceCloud::PushNotification::Base.new file_data }
+
+  describe "attributes" do
+    its(:id) { should eq data['id'] }
+    its(:device_id) { should eq data['device_id'] }
+    its(:type) { should eq data['type'] }
+    its(:queued_at) { should eq data['queued_dt'] }
+    its(:value) { should eq data['value'] }
+  end
+
+  describe "#handle!" do
+    it "should raise NotImplementedError" do
+      expect{subject.handle!}.to raise_error NotImplementedError
+    end
+  end
+end

data/spec/device_cloud/push_notification/event_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe DeviceCloud::PushNotification::Event do
+  describe "#handle!" do
+    let(:data) do
+      {
+        'id' => 1234,
+        'device_id' => 'm:1392301029',
+        'type' => 'some type',
+        'queued_dt' => '2013-06-24T14:52:55.421Z',
+        'value' => {'this' => 'is a value'}
+      }
+    end
+    let(:file_data) { OpenStruct.new(data: data, full_path: '/foo/bar/baz.json') }
+
+    subject { DeviceCloud::PushNotification::Event.new file_data }
+
+    it "should call the DeviceCloud.push_notification_event_handler with self" do
+      handled_event = nil
+      DeviceCloud.push_notification_event_handler = ->(event) { handled_event = event }
+
+      subject.handle!
+      expect(handled_event).to eq subject
+    end
+  end
+end

data/spec/device_cloud/push_notification/message/file_data_spec.rb

@@ -0,0 +1,129 @@
+require 'spec_helper'
+
+describe DeviceCloud::PushNotification::Message::FileData do
+  let(:raw_file_data) do
+    {
+      "id" => {
+        "fdPath" => " /db/4044_MadGlory_Interactive/00000000-00000000-001395FF-FF0E6012/alert/",
+        "fdName" => "foo-0966595cdcdd11e2abf50013950e6012.json"
+      },
+      "fdLastModifiedDate" => "2013-06-24T14:52:55.421Z",
+      "fdSize" => 156,
+      "fdContentType" => "application/json",
+      "fdData" => "eyJ2YWx1ZSI6IHt9LCAiY2xhc3MiOiAiYWxlcnQiLCAicXVldWVkX2R0IjogIjIwMTMtMDYtMjRUMTQ6NDc6NDdaIiwgInR5cGUiOiAiZm9vIiwgImlkIjogIjA5NjY1OTVjZGNkZDExZTJhYmY1MDAxMzk1MGU2MDEyIiwgImRldmljZV9pZCI6ICJtOjAwMTM5NTBFNjAxMiJ9",
+      "fdArchive" => false,
+      "cstId" => 4044,
+      "fdType" => "file",
+      "fdCreatedDate" => "2013-06-24T14:52:55.421Z"
+    }
+  end
+
+  describe "attributes" do
+    subject { DeviceCloud::PushNotification::Message::FileData.new raw_file_data }
+
+    its(:id) { should eq(raw_file_data['id']) }
+    its(:fdLastModifiedDate) { should eq(raw_file_data['fdLastModifiedDate']) }
+    its(:fdSize) { should eq(raw_file_data['fdSize']) }
+    its(:fdArchive) { should eq(raw_file_data['fdArchive']) }
+    its(:cstId) { should eq(raw_file_data['cstId']) }
+    its(:fdType) { should eq(raw_file_data['fdType']) }
+    its(:fdCreatedDate) { should eq(raw_file_data['fdCreatedDate']) }
+    its(:fdData) { should eq(raw_file_data["fdData"]) }
+  end
+
+  describe '#valid?' do
+    subject { DeviceCloud::PushNotification::Message::FileData.new }
+    context 'wrong file type' do
+      let(:raw_file_data) do
+        {
+          "id" => {
+            "fdPath" => "/db/4044_MadGlory_Interactive/00000000-00000000-001395FF-FF0E6014/",
+            "fdName" => "event"
+          },
+          "fdLastModifiedDate" => "2013-06-26T16:18:39.675Z",
+          "fdSize" => 0,
+          "fdContentType" => "application/octet-stream",
+          "fdArchive" => false,
+          "cstId" => 4044,
+          "fdType" => "directory",
+          "fdCreatedDate" => "2013-06-26T16:18:39.675Z"
+        }
+      end
+
+      subject { DeviceCloud::PushNotification::Message::FileData.new raw_file_data}
+      its(:valid?) { should be_false }
+      it "should set a 'wrong file type' error" do
+        subject.valid?
+        expect(subject.errors.include?('wrong file type')).to be_true
+      end
+    end
+
+    context 'without content' do
+      let(:raw_file_data) do
+        {
+          "id" => {
+            "fdPath" => " /db/4044_MadGlory_Interactive/00000000-00000000-001395FF-FF0E6012/alert/",
+            "fdName" => "foo-0966595cdcdd11e2abf50013950e6012.json"
+          },
+          "fdLastModifiedDate" => "2013-06-24T14:52:55.421Z",
+          "fdSize" => 156,
+          "fdContentType" => "application/octet-stream",
+          "fdData" => "",
+          "fdArchive" => false,
+          "cstId" => 4044,
+          "fdType" => "file",
+          "fdCreatedDate" => "2013-06-24T14:52:55.421Z"
+        }
+      end
+
+      subject { DeviceCloud::PushNotification::Message::FileData.new raw_file_data}
+      its(:valid?) { should be_false }
+      it "should set a 'wrong file type' error" do
+        subject.valid?
+        expect(subject.errors.include?('no content')).to be_true
+      end
+    end
+  end
+
+  describe "#file_path" do
+    context "when id present" do
+      subject { DeviceCloud::PushNotification::Message::FileData.new raw_file_data }
+
+      its(:file_path) { should eq raw_file_data['id']['fdPath'] }
+    end
+
+    context "when id blank" do
+      its(:file_path) { should eq '' }
+    end
+  end
+
+  describe "#file_name" do
+    context "when id present" do
+      subject { DeviceCloud::PushNotification::Message::FileData.new raw_file_data }
+
+      its(:file_name) { should eq raw_file_data['id']['fdName'] }
+    end
+
+    context "when id blank" do
+      its(:file_name) { should eq '' }
+    end
+  end
+
+  describe "#data" do
+    context 'when valid' do
+      subject { DeviceCloud::PushNotification::Message::FileData.new raw_file_data }
+
+      its(:data) { should eq(JSON.parse(Base64.decode64(raw_file_data['fdData']))) }
+    end
+
+    context 'when invalid' do
+      its(:data) { should be_false }
+    end
+  end
+
+  describe "#full_path" do
+    subject { DeviceCloud::PushNotification::Message::FileData.new raw_file_data }
+
+    its(:full_path) { should eq(raw_file_data['id']['fdPath'] + raw_file_data['id']['fdName']) }
+  end
+end

data/spec/device_cloud/push_notification/message_spec.rb

@@ -0,0 +1,144 @@
+require 'spec_helper'
+
+describe DeviceCloud::PushNotification::Message do
+  let(:single_raw_message) do
+    {
+      "timestamp" => "2013-06-24T14:52:55.427Z",
+      "topic" => "4044/FileData/db/4044_MadGlory_Interactive/00000000-00000000-001395FF-FF0E6012/alert/foo-0966595cdcdd11e2abf50013950e6012.json",
+      "FileData" => {
+        "id" => {
+          "fdPath" => " /db/4044_MadGlory_Interactive/00000000-00000000-001395FF-FF0E6012/alert/",
+          "fdName" => "foo-0966595cdcdd11e2abf50013950e6012.json"
+        },
+        "fdLastModifiedDate" => "2013-06-24T14:52:55.421Z",
+        "fdSize" => 156,
+        "fdContentType" => "application/json",
+        "fdData" => "eyJ2YWx1ZSI6IHt9LCAiY2xhc3MiOiAiYWxlcnQiLCAicXVldWVkX2R0IjogIjIwMTMtMDYtMjRUMTQ6NDc6NDdaIiwgInR5cGUiOiAiZm9vIiwgImlkIjogIjA5NjY1OTVjZGNkZDExZTJhYmY1MDAxMzk1MGU2MDEyIiwgImRldmljZV9pZCI6ICJtOjAwMTM5NTBFNjAxMiJ9",
+        "fdArchive" => false,
+        "cstId" => 4044,
+        "fdType" => "file",
+        "fdCreatedDate" => "2013-06-24T14:52:55.421Z"
+      },
+      "operation" => "INSERTION",
+      "replay" => true,
+      "group" => "*"
+    }
+  end
+
+  let(:multiple_raw_messages) do
+    [
+      {
+        "timestamp" => "2013-06-24T14:52:55.427Z",
+        "topic" => "4044/FileData/db/4044_MadGlory_Interactive/00000000-00000000-001395FF-FF0E6012/alert/foo-0966595cdcdd11e2abf50013950e6012.json",
+        "FileData" => {
+          "id" => {
+            "fdPath" => " /db/4044_MadGlory_Interactive/00000000-00000000-001395FF-FF0E6012/alert/",
+            "fdName" => "foo-0966595cdcdd11e2abf50013950e6012.json"
+          },
+          "fdLastModifiedDate" => "2013-06-24T14:52:55.421Z",
+          "fdSize" => 156,
+          "fdContentType" => "application/json",
+          "fdData" => "eyJ2YWx1ZSI6IHt9LCAiY2xhc3MiOiAiYWxlcnQiLCAicXVldWVkX2R0IjogIjIwMTMtMDYtMjRUMTQ6NDc6NDdaIiwgInR5cGUiOiAiZm9vIiwgImlkIjogIjA5NjY1OTVjZGNkZDExZTJhYmY1MDAxMzk1MGU2MDEyIiwgImRldmljZV9pZCI6ICJtOjAwMTM5NTBFNjAxMiJ9",
+          "fdArchive" => false,
+          "cstId" => 4044,
+          "fdType" => "file",
+          "fdCreatedDate" => "2013-06-24T14:52:55.421Z"
+        },
+        "operation" => "INSERTION",
+        "replay" => true,
+        "group" => "*"
+      },
+      {
+        "timestamp" => "2013-06-24T14:52:55.427Z",
+        "topic" => "4044/FileData/db/4044_MadGlory_Interactive/00000000-00000000-001395FF-FF0E6012/alert/foo-0966595cdcdd11e2abf50013950e6012.json",
+        "FileData" => {
+          "id" => {
+            "fdPath" => " /db/4044_MadGlory_Interactive/00000000-00000000-001395FF-FF0E6012/alert/",
+            "fdName" => "foo-0966595cdcdd11e2abf50013950e6012.json"
+          },
+          "fdLastModifiedDate" => "2013-06-24T14:52:55.421Z",
+          "fdSize" => 156,
+          "fdContentType" => "application/json",
+          "fdData" => "eyJ2YWx1ZSI6IHt9LCAiY2xhc3MiOiAiYWxlcnQiLCAicXVldWVkX2R0IjogIjIwMTMtMDYtMjRUMTQ6NDc6NDdaIiwgInR5cGUiOiAiZm9vIiwgImlkIjogIjA5NjY1OTVjZGNkZDExZTJhYmY1MDAxMzk1MGU2MDEyIiwgImRldmljZV9pZCI6ICJtOjAwMTM5NTBFNjAxMiJ9",
+          "fdArchive" => false,
+          "cstId" => 4044,
+          "fdType" => "file",
+          "fdCreatedDate" => "2013-06-24T14:52:55.421Z"
+        },
+        "operation" => "INSERTION",
+        "replay" => true,
+        "group" => "*"
+      }
+    ]
+  end
+
+  describe "#parse_raw_messages" do
+    context "single message" do
+      it "should return an array" do
+        expect(DeviceCloud::PushNotification::Message.parse_raw_messages(single_raw_message).class).to eq(Array)
+      end
+
+      it "array objects should be of class DeviceCloud::PushNotification::Message" do
+        expect(DeviceCloud::PushNotification::Message.parse_raw_messages(single_raw_message).first.class).to eq(DeviceCloud::PushNotification::Message)
+      end
+
+      it "should return an array with a single item" do
+        expect(DeviceCloud::PushNotification::Message.parse_raw_messages(single_raw_message).size).to eq(1)
+      end
+    end
+
+    context "multiple messages" do
+      it "should return an array" do
+        expect(DeviceCloud::PushNotification::Message.parse_raw_messages(multiple_raw_messages).class).to eq(Array)
+      end
+
+      it "array objects should be of class DeviceCloud::PushNotification::Message" do
+        DeviceCloud::PushNotification::Message.parse_raw_messages(multiple_raw_messages).each do |item|
+          expect(item.class).to eq(DeviceCloud::PushNotification::Message)
+        end
+      end
+
+      it "should return an array with the same amount of items it was passed" do
+        expect(DeviceCloud::PushNotification::Message.parse_raw_messages(multiple_raw_messages).size).to eq(multiple_raw_messages.size)
+      end
+    end
+
+    describe "#valid?" do
+      context "with file_data and allowed topic" do
+        subject { DeviceCloud::PushNotification::Message.new 'FileData' => 'present', 'topic' => DeviceCloud::PushNotification::Message::ALLOWED_TOPICS.sample }
+        its(:valid?) { should be_true }
+      end
+
+      context "without file_data" do
+        subject { DeviceCloud::PushNotification::Message.new 'topic' => DeviceCloud::PushNotification::Message::ALLOWED_TOPICS.sample }
+        its(:valid?) { should_not be_true }
+      end
+
+      context "without allowed topic" do
+        subject { DeviceCloud::PushNotification::Message.new 'FileData' => 'present' }
+        its(:valid?) { should_not be_true }
+      end
+    end
+
+    describe "#parsed_file_data" do
+      context "when invalid" do
+        it "should be false" do
+          expect(subject.parsed_file_data).to be_false
+        end
+      end
+
+      context "when valid" do
+        subject { DeviceCloud::PushNotification::Message.new 'FileData' => single_raw_message["FileData"], 'topic' => DeviceCloud::PushNotification::Message::ALLOWED_TOPICS.sample }
+
+        it "should return a DeviceCloud::PushNotification::Message::FileData object" do
+          expect(subject.parsed_file_data.class).to eq(DeviceCloud::PushNotification::Message::FileData)
+        end
+
+        it "should cache the FileData object" do
+          file_data1 = subject.parsed_file_data
+          subject.parsed_file_data.should === file_data1
+        end
+      end
+    end
+  end
+end

data/spec/device_cloud/push_notification_spec.rb

@@ -0,0 +1,87 @@
+require 'spec_helper'
+
+describe DeviceCloud::PushNotification do
+  let(:raw_messages) do
+    [
+      { 'topic_type' => 'an alert' },
+      { 'topic_type' => 'an event' }
+    ]
+  end
+  let(:valid_parsed_messages) do
+    [
+      OpenStruct.new(
+        valid?: true,
+        valid_parsed_file_data?: true,
+        topic_type: 'alert',
+        parsed_file_data: 'the alert data'
+      ),
+      OpenStruct.new(
+        valid?: true,
+        valid_parsed_file_data?: true,
+        topic_type: 'event',
+        parsed_file_data: 'the event data'
+      )
+    ]
+  end
+
+  subject { DeviceCloud::PushNotification.new raw_messages }
+
+  describe "attributes" do
+    before(:each) do
+      DeviceCloud::PushNotification::Message.should_receive(:parse_raw_messages).with(raw_messages).and_return(valid_parsed_messages)
+    end
+    its(:messages) { should eq valid_parsed_messages }
+  end
+
+  describe "#handle_each!" do
+    before(:each) do
+      DeviceCloud::PushNotification::Message.should_receive(:parse_raw_messages).with(raw_messages).and_return(valid_parsed_messages)
+    end
+    
+    context "all valid" do
+
+      it "should call handle! on each of the message's topic_type classes" do
+        DeviceCloud::PushNotification::Alert.should_receive(:handle!).with(valid_parsed_messages[0].parsed_file_data)
+
+        DeviceCloud::PushNotification::Event.should_receive(:handle!).with(valid_parsed_messages[1].parsed_file_data)
+
+        subject.handle_each!
+
+      end
+    end
+
+    context "an invalid message" do
+      it "should not be handled" do
+        valid_parsed_messages[0] = OpenStruct.new(
+          valid?: false, # test condition
+          valid_parsed_file_data?: true,
+          topic_type: 'alert',
+          parsed_file_data: 'the alert data'
+        )
+
+        DeviceCloud::PushNotification::Alert.should_not_receive(:handle!)
+
+        DeviceCloud::PushNotification::Event.should_receive(:handle!)
+
+        subject.handle_each!
+      end
+    end
+
+    context "an invalid parsed_file_data" do
+      it "should not be handled" do
+        valid_parsed_messages[0] = OpenStruct.new(
+          valid?: true,
+          valid_parsed_file_data?: false, # test condition
+          topic_type: 'alert',
+          parsed_file_data: 'the alert data'
+        )
+
+        DeviceCloud::PushNotification::Alert.should_not_receive(:handle!)
+
+        DeviceCloud::PushNotification::Event.should_receive(:handle!)
+
+        subject.handle_each!
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,13 @@
+require 'device_cloud'
+require 'ostruct'
+
+RSpec.configure do |config|
+  config.mock_with :rspec
+
+  config.before(:each) do
+    DeviceCloud.configure do |configuration|
+      configuration.username = 'a username'
+      configuration.password = 'a password'
+    end
+  end
+end

data/spec/version_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe 'DeviceCloud::VERSION' do
+  it 'should be the correct version' do
+    DeviceCloud::VERSION.should == '0.0.1'
+  end
+end

metadata

@@ -0,0 +1,128 @@
+--- !ruby/object:Gem::Specification
+name: device_cloud
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Erik Straub
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Ruby wrapper for the Etherios Device Cloud
+email:
+- erik@madgloryint.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .ruby-version
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- device_cloud.gemspec
+- lib/device_cloud.rb
+- lib/device_cloud/configuration.rb
+- lib/device_cloud/push_notification.rb
+- lib/device_cloud/push_notification/alert.rb
+- lib/device_cloud/push_notification/base.rb
+- lib/device_cloud/push_notification/event.rb
+- lib/device_cloud/push_notification/message.rb
+- lib/device_cloud/push_notification/message/file_data.rb
+- lib/device_cloud/utils.rb
+- lib/device_cloud/version.rb
+- spec/device_cloud/push_notification/alert_spec.rb
+- spec/device_cloud/push_notification/base_spec.rb
+- spec/device_cloud/push_notification/event_spec.rb
+- spec/device_cloud/push_notification/message/file_data_spec.rb
+- spec/device_cloud/push_notification/message_spec.rb
+- spec/device_cloud/push_notification_spec.rb
+- spec/spec_helper.rb
+- spec/version_spec.rb
+homepage: http://github.com/madgloryint/device_cloud
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: A Ruby wrapper for the Etherios Device Cloud
+test_files:
+- spec/device_cloud/push_notification/alert_spec.rb
+- spec/device_cloud/push_notification/base_spec.rb
+- spec/device_cloud/push_notification/event_spec.rb
+- spec/device_cloud/push_notification/message/file_data_spec.rb
+- spec/device_cloud/push_notification/message_spec.rb
+- spec/device_cloud/push_notification_spec.rb
+- spec/spec_helper.rb
+- spec/version_spec.rb