rosumi 0.0.1

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+# Specify your gem's dependencies in rosumi.gemspec
+gemspec
+gem 'rspec'
+gem 'pry'

data/README.md

@@ -0,0 +1,29 @@
+# Rosumi
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'rosumi'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install rosumi
+
+## 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/lib/rosumi.rb

@@ -0,0 +1,53 @@
+class Rosumi
+
+  def initialize(user, pass)
+    @user = user.strip
+    @pass = pass.strip
+    @locator = Rosumi::Locator.new(user, pass)
+    @messenger = Rosumi::Messenger.new(user, pass)
+  end
+
+  def devices
+    devices = @locator.update_devices
+
+    result = {}
+    devices.each_with_index do |device, i|
+      result[i] = {:type => device['deviceClass'], :name => device['name']}
+    end
+
+    result
+  end
+
+  # Gets location information for a device.
+  #
+  # ==== Attributes
+  #
+  # * +id+ - ID to locate (0,1,2,3, et cetera).
+  def locate_device(id)
+    unless id
+      raise "An id must be specified."
+    end
+
+    @locator.locate(id)
+  end
+
+  # Sends a message to the specified device.
+  #
+  # ==== Attributes
+  #
+  # * +id+ - id of the device (0,1,2,3 et cetera).
+  # * +subject+ - Subject of the message.
+  # * +message+ - The message to display on the device.
+  # * +sound+ - If true, plays a sound on the device.
+  def send_message(id, subject="", message, sound)
+    unless id
+      raise "An id must be specified."
+    end
+
+    @messenger.send_message(id, subject, message, sound)
+  end
+
+end
+
+require "rosumi/locator"
+require "rosumi/messenger"

data/lib/rosumi/locator.rb

@@ -0,0 +1,50 @@
+require "uri"
+require 'json'
+require 'net/http'
+require 'net/https'
+require 'base64'
+require 'pry'
+require_relative "post_helper"
+
+class Rosumi::Locator
+  include PostHelper  
+    
+  def initialize(user, pass)
+    @user = user
+    @pass = pass
+    @devices = []
+    super()
+  end
+
+  # Find a device by it's number.
+  #
+  # ==== Attributes
+  #
+  # * +device_num+ - Device number as returned from the update_devices method.
+  # * +max_wait+ - Maximum wait in seconds to wait for call to complete.
+  def locate(device_num = 0, max_wait = 300)
+    
+    start = Time.now
+    
+    begin
+      raise "Unable to find location within '#{max_wait}' seconds" if ((Time.now - start) > max_wait)
+
+      sleep(5)
+      update_devices
+      raise "Invalid device number!" if @devices[device_num].nil?  
+      raise "There is no location data for this device (#{@devices[device_num]['name']})" if @devices[device_num]['location'].nil?
+    end while (@devices[device_num]['location']['locationFinished'] == 'false') 
+
+    loc = {
+      :name      => @devices[device_num]['name'],
+      :latitude  => @devices[device_num]['location']['latitude'],
+      :longitude => @devices[device_num]['location']['longitude'],
+      :accuracy  => @devices[device_num]['location']['horizontalAccuracy'],
+      :timestamp => @devices[device_num]['location']['timeStamp'],
+      :position_type  => @devices[device_num]['location']['positionType']
+      };
+
+    return loc;
+  end
+
+end

data/lib/rosumi/messenger.rb

@@ -0,0 +1,42 @@
+require "uri"
+require 'json'
+require 'net/http'
+require 'net/https'
+require 'base64'
+require_relative "post_helper"
+
+class Rosumi::Messenger
+  include PostHelper  
+    
+  def initialize(user, pass)
+    @user = user
+    @pass = pass
+    super()
+  end
+
+  # Sends a message to the specified device.
+  #
+  # ==== Attributes
+  #
+  # * +id+ - id of the device (0,1,2,3 et cetera).
+  # * +subject+ - Subject of the message.
+  # * +message+ - The message to display on the device.
+  # * +sound+ - If true, plays a sound on the device.
+  def send_message(id, subject, message, sound)
+
+    update_devices
+    device_id = @devices[id]['id']
+
+    data = {'clientContext' => client_context(device_id),
+            'device' => device_id,
+            'sound' => sound,
+            'subject' => subject,
+            'text' => message,
+            'userText' => true
+           };
+    
+    self.send(:post,"/fmipservice/device/#{@user}/sendMessage", data)
+
+  end
+
+end

data/lib/rosumi/post_helper.rb

@@ -0,0 +1,116 @@
+module PostHelper
+
+  URL ="fmipmobile.icloud.com"
+  PORT=443
+
+  attr_accessor :http, :partition, :devices
+
+  def initialize
+    @http = Net::HTTP.new(URL, PORT)   
+    @http.use_ssl = true
+    @partition = nil
+    @devices = []
+  end
+
+  # Updates the devices array with the latest information from icloud.
+  def update_devices
+    data = {'clientContext' => client_context(nil)};
+    
+    json_devices = self.send(:post,"/fmipservice/device/#{@user}/initClient", data)
+    json_devices['content'].each { |json_device| @devices << json_device }
+    
+    @devices
+  end
+
+private 
+
+  # Posts some data to the URL and the path specified.
+  #
+  # ==== Attributes
+  #
+  # * +path+ - The path to post to (relative to the URL constant).
+  # * +data+ - Payload to send.
+  def post(path, data)
+		auth = Base64.encode64(@user+':'+@pass)
+		headers = {
+      'Content-Type' => 'application/json; charset=utf-8',
+      'X-Apple-Find-Api-Ver' => '2.0',
+      'X-Apple-Authscheme' => 'UserIdGuest',
+      'X-Apple-Realm-Support' => '1.2',
+      'User-Agent' => 'Find iPhone/1.1 MeKit (iPad: iPhone OS/4.2.1)',
+      'X-Client-Name' => 'iPad',
+      'X-Client-Uuid' => '0cf3dc501ff812adb0b202baed4f37274b210853',
+      'Accept-Language' => 'en-us',
+      'Authorization' => "Basic #{auth}"
+    }
+
+    unless @partition
+      @partition = self.send(:fetch_partition, path, JSON.generate(data), headers) 
+      @http = Net::HTTP.new(partition, PORT)
+      @http.use_ssl=true
+    end
+
+    resp = fetch(path, JSON.generate(data), headers)
+    
+    return JSON.parse(resp.body);
+  end
+
+  # Posts some data to the URL and the path specified.
+  #
+  # ==== Attributes
+  #
+  # * +path+ - Path to do an http post to the URL constant.
+  # * +data+ - Payload to send.
+  # * +headers+ - HTTP headers.
+  # * +limit+ - Number of redirects allowed.
+  def fetch(path, data, headers, limit = 10)
+    
+    raise ArgumentError, 'HTTP redirect too deep' if limit == 0
+
+    response = http.post(path, data, headers)
+
+    case response
+    when Net::HTTPSuccess     then response
+    when Net::HTTPRedirection then fetch(response['location'], data, headers, limit - 1)
+    else
+      response.error!
+    end
+  end
+
+  # Posts some data to the path and returns the 'X-Apple-MMe-Host' portion
+  # of the response.
+  #
+  # ==== Attributes
+  #
+  # * +path+ - Path to do an http post to the URL constant.
+  # * +data+ - Payload to send.
+  # * +headers+ - HTTP headers.
+  def fetch_partition(path, data, headers)
+
+    response = http.post(path, data, headers)
+    response['X-Apple-MMe-Host']
+
+  end
+
+  # Returns the 'clientContext' attribute for requests.
+  #
+  # ==== Attributes
+  #
+  # * +id+ - The device id.
+  def client_context(id)
+
+     {
+      'appName' => 'FindMyiPhone',
+      'appVersion' => '1.4',
+      'buildVersion' => '145',
+      'deviceUDID' => '0000000000000000000000000000000000000000',
+      'inactiveTime' => 5911,
+      'osVersion' => '4.2.1',
+      'productType' => 'iPad1,1',
+      'selectedDevice' => id,
+      'shouldLocate'=>false
+     }
+
+  end
+
+end

data/rosumi.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'rosumi/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "rosumi"
+  spec.version       = Rosumi::VERSION
+  spec.authors       = ["Kevin Eder"]
+  spec.email         = ["kevin.eder@gmail.com"]
+  spec.description   = %q{Provides an API for locating and messaging Apple devices.}
+  spec.summary       = "Provides and API for locating and messaging Apple devices."
+  spec.homepage      = "https://github.com/kevineder/rosumi"
+  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"
+end

data/spec/integration/locator_test.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+DEVICE_TO_CHECK = 0
+
+describe Rosumi do
+
+  describe "#devices" do
+    it "should return a devices hash mapping id => {:type, :name}" do
+      devices = @@rosumi.devices
+      devices.should_not be_nil
+      devices[0].should_not be_nil
+      devices[0][:type].should_not be_nil
+      devices[0][:name].should_not be_nil
+    end
+  end
+
+  describe "#locate_device" do
+    it "should return location information for device #{DEVICE_TO_CHECK}" do
+      location = @@rosumi.locate_device(DEVICE_TO_CHECK)
+      location.should_not be_nil
+      location.should_not be_nil
+      location[:name].should_not be_nil
+      location[:latitude].should_not be_nil
+      location[:longitude].should_not be_nil
+      location[:accuracy].should_not be_nil
+      location[:timestamp].should_not be_nil
+    end
+  end
+
+end

data/spec/integration/messenger_test.rb

@@ -0,0 +1,12 @@
+require 'spec_helper'
+DEVICE_TO_CHECK = 1
+
+describe Rosumi do
+
+  describe "#send_message" do
+    it "Should send message to device" do
+      @@rosumi.send_message(DEVICE_TO_CHECK, "Subject!", "Hello, word...!", false)
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'rosumi'
+require 'yaml'
+require "rspec"
+require "pry"
+
+CREDENTIALS_FILE = File.join(File.dirname(__FILE__), 'credentials.yml')
+
+RSpec.configure do |config|
+  unless File.exist?(CREDENTIALS_FILE) and File.file?(CREDENTIALS_FILE)
+    raise "Please create a credentials.yml file containing your Apple email / password."
+  end
+
+  data = YAML.load_file(CREDENTIALS_FILE)
+  @@username = data['email']
+  @@password = data['password']
+  @@rosumi = Rosumi.new @@username, @@password
+end

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification
+name: rosumi
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Kevin Eder
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-19 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'
+description: Provides an API for locating and messaging Apple devices.
+email:
+- kevin.eder@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- lib/rosumi.rb
+- lib/rosumi/locator.rb
+- lib/rosumi/messenger.rb
+- lib/rosumi/post_helper.rb
+- rosumi.gemspec
+- spec/integration/locator_test.rb
+- spec/integration/messenger_test.rb
+- spec/spec_helper.rb
+homepage: https://github.com/kevineder/rosumi
+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: Provides and API for locating and messaging Apple devices.
+test_files:
+- spec/integration/locator_test.rb
+- spec/integration/messenger_test.rb
+- spec/spec_helper.rb
+has_rdoc: