cloud_connect 0.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+pkg/*
+*.gem
+.bundle
+.yardoc
+.DS_Store
+doc/*

data/.yardopts

@@ -0,0 +1,7 @@
+'lib/cloud_connect.rb' 'lib/cloud_connect/**/*.rb'
+--no-private
+--protected
+--tag format:"Supported formats"
+--tag authenticated:"Requires Authentication"
+--tag rate_limited:"Rate Limited"
+--markup markdown

data/Gemfile

@@ -0,0 +1,2 @@
+source :gemcutter
+gemspec

data/Gemfile.lock

@@ -0,0 +1,55 @@
+PATH
+  remote: .
+  specs:
+    cloud_connect (0.0.1)
+      faraday (~> 0.5.0)
+      faraday_middleware (~> 0.1.6)
+      hashie (~> 0.4.0)
+      json
+      multi_json (~> 0.0.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.2)
+    bluecloth (2.0.11)
+    diff-lcs (1.1.2)
+    faraday (0.5.1)
+      addressable (~> 2.2.2)
+      multipart-post (~> 1.0.1)
+      rack (~> 1.2.1)
+    faraday_middleware (0.1.7)
+      faraday (~> 0.5.1)
+    hashie (0.4.0)
+    json (1.5.1)
+    multi_json (0.0.4)
+    multipart-post (1.0.1)
+    rack (1.2.1)
+    rake (0.8.7)
+    rspec (2.0.1)
+      rspec-core (~> 2.0.1)
+      rspec-expectations (~> 2.0.1)
+      rspec-mocks (~> 2.0.1)
+    rspec-core (2.0.1)
+    rspec-expectations (2.0.1)
+      diff-lcs (>= 1.1.2)
+    rspec-mocks (2.0.1)
+      rspec-core (~> 2.0.1)
+      rspec-expectations (~> 2.0.1)
+    yard (0.6.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bluecloth (>= 2.0)
+  bundler (>= 1.0.0)
+  cloud_connect!
+  faraday (~> 0.5.0)
+  faraday_middleware (~> 0.1.6)
+  hashie (~> 0.4.0)
+  json
+  multi_json (~> 0.0.0)
+  rake (~> 0.8)
+  rspec
+  yard (~> 0.6)

data/HISTORY.md

@@ -0,0 +1,12 @@
+0.0.1 - February 16, 2011
+-------------------------
+* Initial release
+
+Thanks to the following people for making this possible
+-------------------------------------------------------
+- John Nunemaker ([@jnunemaker](http://twitter.com/#!/jnunemaker))
+  for the twitter that inspired this one.
+- Rick Olson ([@technoweenie](https://github.com/technoweenie))
+  for the faraday gem
+- Wynn Netherland ([@pengwynn](http://github.com/pengwynn))
+  for the faraday_middleware gem

data/README.md

@@ -0,0 +1,97 @@
+The Coud Connect Ruby Gem
+==========================
+
+A Ruby wrapper for the [Cloud Connect API](http://develop.g8teway.com).
+
+Installation
+------------
+    gem install cloud_connect
+
+Usage
+-----
+
+    require 'rubygems'
+    require 'cloud_connect'
+
+### Instantiate a client
+
+    cloud_connect = CloudConnect::Client.new(:username => 'user', :password => 'password', :account => 'test', :env => 'sandbox')
+
+### Or configure once
+
+    CloudConnect.configure do |config|
+      config.username = 'user'
+      config.password = 'password'
+      config.account  = 'test'
+      config.env      = 'sandbox'
+    end
+    cloud_connect = CloudConnect.client.new
+
+### Login
+
+    cloud_connect.login
+
+### Examples
+
+    cloud_connect.units
+    =>  [<#Hashie::Mash id=2 lat=nil lng=nil time=nil>, <#Hashie::Mash id=3 lat=4884481 lng=226392 time="2009-07-08T10:23:13Z">]
+
+Details for the current user
+    cloud_connect.user
+
+Details for another user
+
+    cloud_connect.user('other_user')
+    cloud_connect.user(1)
+
+Send a message to a unit
+
+    cloud_connect.send_message(1, 11, "Hello World!")
+
+Get a unit's last known position
+
+    unit = cloud_connect.unit(3)
+    puts "#{unit.location.join(', ')} @ #{unit.time}"
+
+We recommand you install the [yajl-ruby](http://github.com/brianmario/yajl-ruby) Gem
+for improved performance over the default pure ruby JSON library.
+
+Contributing
+------------
+In the spirit of [free software](http://www.fsf.org/licensing/essays/free-sw.html), **everyone** is encouraged to help improve this project.
+
+Here are some ways *you* can contribute:
+
+* by using alpha, beta, and prerelease versions
+* by reporting bugs
+* by suggesting new features
+* by writing or editing documentation
+* by writing specifications
+* by writing code (**no patch is too small**: fix typos, add comments, clean up inconsistent whitespace)
+* by refactoring code
+* by closing [issues](http://github.com/mobiledevices/cloud_connect/issues)
+* by reviewing patches
+
+All contributors will be added to the [HISTORY](https://github.com/mobiledevices/cloud_connect/blob/master/HISTORY.md)
+file and will receive the respect and gratitude of the community.
+
+Submitting an Issue
+-------------------
+We use the [GitHub issue tracker](http://github.com/mobiledevices/cloud_connect/issues) to track bugs and
+features. Before submitting a bug report or feature request, check to make sure it hasn't already
+been submitted. You can indicate support for an existing issuse by voting it up. When submitting a
+bug report, please include a [Gist](http://gist.github.com/) that includes a stack trace and any
+details that may be necessary to reproduce the bug, including your gem version, Ruby version, and
+operating system. Ideally, a bug report should include a pull request with failing specs.
+
+Submitting a Pull Request
+-------------------------
+1. Fork the project.
+2. Create a topic branch.
+3. Implement your feature or bug fix.
+4. Add documentation for your feature or bug fix.
+5. Run <tt>bundle exec rake doc:yard</tt>. If your changes are not 100% documented, go back to step 4.
+6. Add specs for your feature or bug fix.
+7. Run <tt>bundle exec rake spec</tt>. If your changes are not 100% covered, go back to step 6.
+8. Commit and push your changes.
+9. Submit a pull request. Please do not include changes to the gemspec, version, or history file. (If you want to create your own version for some reason, please do so in a separate commit.)

data/Rakefile

@@ -0,0 +1,47 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+namespace :doc do
+  require 'yard'
+  YARD::Rake::YardocTask.new do |task|
+    task.files   = ['lib/cloud_connect.rb', 'lib/cloud_connect/**/*.rb']
+    task.options = [
+      '--protected',
+      '--output-dir', 'doc/yard',
+      '--tag', 'format:Supported formats',
+      '--tag', 'authenticated:Requires Authentication',
+      '--tag', 'rate_limited:Rate Limited',
+      '--markup', 'markdown',
+    ]
+  end
+end
+
+task :irb do
+  $:.unshift File.join(File.dirname(__FILE__), *%w[.. lib])
+  require 'irb'
+  require 'bundler/setup'
+  require 'cloud_connect'
+  module IRB # :nodoc:
+    def self.start_session(binding)
+      unless @__initialized
+        args = ARGV
+        ARGV.replace(ARGV.dup)
+        IRB.setup(nil)
+        ARGV.replace(args)
+        @__initialized = true
+      end
+
+      ws  = WorkSpace.new(binding)
+      irb = Irb.new(ws)
+
+      @CONF[:IRB_RC].call(irb.context) if @CONF[:IRB_RC]
+      @CONF[:MAIN_CONTEXT] = irb.context
+
+      catch(:IRB_EXIT) do
+        irb.eval_input
+      end
+    end
+
+    IRB.start_session(binding)
+  end
+end

data/cloud_connect.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/cloud_connect/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "cloud_connect"
+  s.version     = CloudConnect::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Jean-Paul Bonnetouche"]
+  s.email       = ["jean-paul.bonnetouche@mobile-devices.fr"]
+  s.homepage    = "http://rubygems.org/gems/cloud_connect"
+  s.summary     = "Wrapper for Cloud Connect"
+  s.description = "Ruby Wrapper for the Mobile Devices Cloud Connect API"
+
+  s.required_rubygems_version = ">= 1.3.6"
+
+  s.add_runtime_dependency "json"
+  s.add_runtime_dependency "multi_json", "~> 0.0.0"
+  s.add_runtime_dependency "faraday", "~> 0.5.0"
+  s.add_runtime_dependency "faraday_middleware", "~> 0.1.6"
+  s.add_runtime_dependency "hashie", "~> 0.4.0"
+
+  s.add_development_dependency "bundler", ">= 1.0.0"
+  s.add_development_dependency "bluecloth", ">= 2.0"
+  s.add_development_dependency "rake", "~> 0.8"
+  s.add_development_dependency "yard", "~> 0.6"
+  s.add_development_dependency "rspec"
+
+  s.files        = `git ls-files`.split("\n")
+  s.executables  = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact
+  s.require_path = 'lib'
+end

data/lib/cloud_connect/client/channels.rb

@@ -0,0 +1,22 @@
+module CloudConnect
+  module Channels
+
+    # Retrieve list of channels
+    # WARNING: This method uses calls not officially supported by Mobile Devices.
+    #
+    # @return [Array of Hashie::Mash] Channels
+    def channels(reload = false)
+      return @channels if @channels && !reload
+      page  = 1
+      limit = 100
+      channels = []
+      while (slice = connection.get(connection.build_url("channels", :per_page => limit, :page => page)).body).size > 0
+        page += 1
+        channels += slice.map!{|hash| hash.values.first} if slice.size > 0
+        slice.size < limit ? break : sleep(1)
+      end
+      @channels = channels.sort_by(&:channel)
+    end
+
+  end
+end

data/lib/cloud_connect/client/fields.rb

@@ -0,0 +1,21 @@
+module CloudConnect
+  module Fields
+
+    # Retrieve a list of fields.
+    # WARNING: This method uses calls not officially supported by Mobile Devices.
+    #
+    # @return [[Hashie::Mash]] Array of Fields
+    def fields(reload = false)
+      return @fields if @fields && !reload
+      page  = 1
+      limit = 100
+      fields = []
+      while (slice = connection.get(connection.build_url("fields", :per_page => limit, :page => page)).body).size > 0
+        page += 1
+        fields += slice.map!{|hash| hash.values.first} if slice.size > 0
+        slice.size < limit ? break : sleep(1)
+      end
+      @fields = fields.sort_by(&:id)
+    end
+  end
+end

data/lib/cloud_connect/client/messages.rb

@@ -0,0 +1,49 @@
+module CloudConnect
+  module Messages
+
+    # Returns all messages that match parameters provided in +opts+ list
+    # (if +opts+ is provided)
+    #
+    # @param [Hash] opts the options to filter the messages.
+    # @option opts [String] :ret ('id, time') Select attributes to fetch
+    # @option opts [String] :channelids List of channel ids
+    # @option opts [String] :messageids List of message ids
+    # @option opts [String] :unitids List of unit ids
+    # @option opts [String] :userids List of user ids
+    # @option opts [String] :status Message status
+    #   (0 (new), 1 (sent), 2 (received), 3 (failed))
+    # @option opts [String] :timedout (false) Include timed-out messages
+    # @option opts [String] :from Minimum date
+    # @option opts [String] :to Maximum date
+    # @option opts [String] :direction Message direction
+    #   (unittouser or usertounit)
+    # @option opts [String] :replyto List of reference message ids
+    # @option opts [Integer] :id_min Minimum ID
+    # @option opts [Integer] :id_max Maximum ID
+    # @option opts [Integer] :limit (25) Number of elements to fetch
+    # @return [Array<Hashie::Mash>] Messages
+    # @see http://develop.g8teway.com/p/messages.html#listing_messages
+    def messages(opts = {})
+      messages = connection.get(connection.build_url("messages", opts)).body
+      messages.map!{|hash| hash.values.first}
+    end
+
+    # Send a message to a specific device
+    #
+    # @param [Integer] unit
+    # @param [Integer] channel
+    # @param [String] content
+    # @param [Hash] opts
+    # @return [Hashie::Mash] The message
+    # @see http://develop.g8teway.com/p/messages.html#sending_a_new_message
+    def send_message(unit, channel, content, opts = {})
+      # TODO: rename #message_create ?
+      opts.merge! :channelid => channel, :unitid => unit, :content => content
+      response = connection.post do |req|
+        req.url 'messages'
+        req.body = {:message => opts}
+      end
+      response.body.values.first
+    end
+  end
+end

data/lib/cloud_connect/client/trackings.rb

@@ -0,0 +1,22 @@
+module CloudConnect
+  module Trackings
+
+    # Retrieve list of tracking data
+    #
+    # @see http://develop.g8teway.com/p/tracking_records.html#listing_tracking_records
+    # @param [Hash] opts the options to filter the tracking data.
+    # @options opts [String] :ret Select attributes to fetch
+    # @options opts [String] :userids List of unit ids
+    # @options opts [String] :fieldids List of field ids
+    # @options opts [Integer] :from Minimum ID
+    # @options opts [Integer] :to Maximum ID
+    # @options opts [Integer] :id_min Minimum ID
+    # @options opts [Integer] :id_max Maximum ID
+    # @options opts [Integer] :limit Number of elements to fetch (default 25
+    # @return [Array of Hashie::Mash] Tracking data
+    def trackings(opts = {})
+      trackings = connection.get(connection.build_url("tracking_records", opts)).body
+      trackings.map!{|hash| hash.values.first}
+    end
+  end
+end

data/lib/cloud_connect/client/units.rb

@@ -0,0 +1,77 @@
+module CloudConnect
+  module Units
+
+    # Returns all units that match parameters provided in +opts+ list
+    # (if +opts+ is provided)
+    #
+    # @param [Hash] opts the options to filter the units.
+    # @option opts [String] :ret ('id, lat, long, time') Select attributes to fetch
+    # @option opts [String] :unitids List of unit ids
+    # @option opts [String] :fieldids List of field ids
+    # @option opts [String] :unknow Allow unknown position
+    # @option opts [Integer] :id_min Minimum ID
+    # @option opts [Integer] :id_max Maximum ID
+    # @option opts [Integer] :limit Number of elements to fetch (default 25
+    # @return [Array<Hashie::Mash>] Units
+    # @see http://develop.g8teway.com/p/units.html#listing_units
+    def units(opts = {})
+      units = connection.get(connection.build_url("units", opts)).body
+      units.map!{|hash| hash.values.first}
+      units.each{|u| u.extend UnitMethods; u._cloud_connect = self;}
+    end
+
+    # Search for a specific unit knowing it's modid
+    #
+    # @param [String] modids the comma separated list modids.
+    #   Partial modids can be provided using the '*' caracter
+    # @example
+    #   find_unit("*3216*")
+    # @return [Array<Hashie::Mash>] Unit
+    # @see http://develop.g8teway.com/p/units.html#searching_units
+    def find_units(modids)
+      # TODO: Rename unit_search?
+      units = connection.get(connection.build_url("units/search", :modids => modids)).body
+      units.map!{|hash| hash.values.first}
+      units.each{|u| u.extend UnitMethods; u._cloud_connect = self;}
+    end
+
+    # Return information about a specific unit
+    #
+    # @param [String] unit_id Unit ID
+    # @param [Hash] opts the options to filter the units.
+    # @option opts [String] :ret ('id, lat, long, time') Select attributes to fetch
+    # @option opts [String] :fieldids List of field ids
+    # @option opts [String] :unknow Allow unknown position
+    # @return [Hashie::Mash] Unit info
+    def unit(unit_id=nil, opts = {})
+      units = connection.get(connection.build_url("units", opts.merge(:unitids => unit_id))).body
+      units.map!{|hash| hash.values.first}
+      units.each{|u| u.extend UnitMethods; u._cloud_connect = self;}
+      units.first
+    end
+
+    module UnitMethods
+      # @private
+      attr_accessor :_cloud_connect
+
+      # Return the last known location of a specific unit
+      #
+      # @return [Integer lat, Integer long] Latitude, Longitude
+      def location
+        [lat.to_f / 100_000, lng.to_f / 100_000]
+      end
+
+      # Send a message to the unit
+      #
+      # @param [Integer] channel
+      # @param [String] content
+      # @param [Hash] opts
+      # @return [Hashie::Mash] The message
+      # @see http://develop.g8teway.com/p/messages.html#sending_a_new_message
+      def send_message(channel, content, opts = {})
+        raise "Unknown unit id, try providing :ret => 'id' when fetching units from the API." unless id && id > 0
+        _cloud_connect.send_message(id, channel, content, opts)
+      end
+    end
+  end
+end

data/lib/cloud_connect/client/users.rb

@@ -0,0 +1,36 @@
+module CloudConnect
+  module Users
+
+    # Retrieve list of users
+    #
+    # @see http://develop.g8teway.com/p/users.html#searching_and_listing_users
+    # @param [Hash] opts the options to filter the units.
+    # @options opts [String] :ret Select attributes to fetch
+    # @options opts [String] :userids List of unit ids
+    # @options opts [String] :logins List of field ids
+    # @options opts [Integer] :id_min Minimum ID
+    # @options opts [Integer] :id_max Maximum ID
+    # @options opts [Integer] :limit Number of elements to fetch (default 25
+    # @return [Array of Hashie::Mash] Users
+    def users(opts = {})
+      opts.default! :ret => %w(id login email).join(',')
+      users = connection.get(connection.build_url('users', opts)).body
+      users.map!{|hash| hash.values.first}
+    end
+
+    # Return information about a specific user
+    #
+    # @param [String] user_id Unit ID
+    # @return [Hashie::Mash] User info
+    def user(user_id = nil)
+      user_id = username if user_id.nil? || user_id == ""
+      if user_id.to_i.to_s == user_id.to_s
+        users = connection.get(connection.build_url('users', :userids => user_id)).body
+      else
+        users = connection.get(connection.build_url('users', :logins => user_id)).body
+      end
+      users.map!{|hash| hash.values.first}
+      users.first
+    end
+  end
+end

data/lib/cloud_connect/client.rb

@@ -0,0 +1,62 @@
+module CloudConnect
+  class Client
+    attr_reader :username, :password, :account, :env, :cookie
+    attr_writer :cookie
+
+    def initialize(options={})
+      @username = options[:username] || CloudConnect.username
+      @password = options[:password] || CloudConnect.password
+      @account  = options[:account]  || CloudConnect.account
+      @env      = options[:env]      || CloudConnect.env      || "prod"
+    end
+
+    # Raw HTTP connection, either Faraday::Connection
+    #
+    # @return [Faraday::Connection]
+    def connection
+      params = {}
+      params[:access_token] = @access_token if @access_token
+      @connection ||= Faraday::Connection.new(:url => api_url, :params => params, :headers => default_headers) do |builder|
+        builder.use Faraday::Request::CookieAuth, self
+        builder.adapter Faraday.default_adapter
+        builder.use Faraday::Response::RaiseHttp5xx
+        builder.use Faraday::Response::ParseJson
+        builder.use Faraday::Response::RaiseHttp4xx
+        builder.use Faraday::Response::Mashify
+        #builder.response :yajl     # Faraday::Request::Yajl
+      end
+    end
+
+    # Provides the URL for accessing the API
+    #
+    # @return [String]
+    def api_url
+      if env == "preprod"
+        "http://srv/api/v2"
+      else
+        "http://#{env}.g8teway.com/api/v2"
+      end
+    end
+
+
+    def login
+      req = connection.post('sessions', {:login => username, :password => password, :client => account})
+    end
+
+    private
+      # @private
+      def default_headers
+        headers = {
+          :accept =>  'application/json',
+          :user_agent => 'CloudClient Ruby gem'
+        }
+      end
+
+    include Units
+    include Users
+    include Channels
+    include Messages
+    include Fields
+    include Trackings
+  end
+end

data/lib/cloud_connect/error.rb

@@ -0,0 +1,12 @@
+module CloudConnect
+  class Error < StandardError; end
+  class BadGateway < Error; end
+  class BadRequest < Error; end
+  class Forbidden < Error; end
+  class InternalServerError < Error; end
+  class NotAcceptable < Error; end
+  class NotFound < Error; end
+  class ServiceUnavailable < Error; end
+  class UnprocessableEntity < Error; end
+  class Unauthorized < Error; end
+end

data/lib/cloud_connect/version.rb

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

data/lib/cloud_connect.rb

@@ -0,0 +1,42 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'forwardable'
+
+begin
+  require 'yajl'
+  MultiJson.engine = :yajl
+rescue LoadError
+  require 'json'
+  MultiJson.engine = :json_gem
+end
+
+module CloudConnect
+  class << self
+    attr_accessor :username
+    attr_accessor :password
+    attr_accessor :account
+    attr_accessor :env
+
+    def configure
+      yield self
+      true
+    end
+
+    require 'ext/object'
+    require 'ext/module'
+    require 'ext/hash'
+
+    require 'faraday/cookie_auth'
+    require 'faraday/raise_http_4xx'
+    require 'faraday/raise_http_5xx'
+
+    require 'cloud_connect/error'
+    require 'cloud_connect/client/units'
+    require 'cloud_connect/client/users'
+    require 'cloud_connect/client/messages'
+    require 'cloud_connect/client/trackings'
+    require 'cloud_connect/client/channels'
+    require 'cloud_connect/client/fields'
+    require 'cloud_connect/client'
+  end
+end

data/lib/ext/hash.rb

@@ -0,0 +1,5 @@
+class Hash
+  def default!(other_hash)
+    merge!( other_hash ){|k,o,n| o }
+  end
+end

data/lib/ext/module.rb

@@ -0,0 +1,59 @@
+# From active_support
+#
+# http://github.com/rails/rails/blob/master/activesupport/lib/active_support/core_ext/module/delegation.rb
+# http://github.com/rails/rails/blob/master/activesupport/lib/active_support/core_ext/module/remove_method.rb
+class Module
+
+  # Used by delegate
+  # @see http://github.com/rails/rails/blob/master/activesupport/lib/active_support/core_ext/module/remove_method.rb
+  def remove_possible_method(method)
+      remove_method(method)
+    rescue NameError
+  end
+
+  # Provides a delegate class method to easily expose contained objects' methods
+  # as your own. Pass one or more methods (specified as symbols or strings)
+  # and the name of the target object via the <tt>:to</tt> option (also a symbol
+  # or string). At least one method and the <tt>:to</tt> option are required.
+  # @see http://github.com/rails/rails/blob/master/activesupport/lib/active_support/core_ext/module/delegation.rb
+  def delegate(*methods)
+    options = methods.pop
+    unless options.is_a?(Hash) && to = options[:to]
+      raise ArgumentError, "Delegation needs a target. Supply an options hash with a :to key as the last argument (e.g. delegate :hello, :to => :greeter)."
+    end
+
+    if options[:prefix] == true && options[:to].to_s =~ /^[^a-z_]/
+      raise ArgumentError, "Can only automatically set the delegation prefix when delegating to a method."
+    end
+
+    prefix = options[:prefix] && "#{options[:prefix] == true ? to : options[:prefix]}_" || ''
+
+    file, line = caller.first.split(':', 2)
+    line = line.to_i
+
+    methods.each do |method|
+      on_nil =
+        if options[:allow_nil]
+          'return'
+        else
+          %(raise "#{self}##{prefix}#{method} delegated to #{to}.#{method}, but #{to} is nil: \#{self.inspect}")
+        end
+
+      module_eval(<<-EOS, file, line - 5)
+        if instance_methods(false).map(&:to_s).include?("#{prefix}#{method}")
+          remove_possible_method("#{prefix}#{method}")
+        end
+
+        def #{prefix}#{method}(*args, &block)               # def customer_name(*args, &block)
+          #{to}.__send__(#{method.inspect}, *args, &block)  #   client.__send__(:name, *args, &block)
+        rescue NoMethodError                                # rescue NoMethodError
+          if #{to}.nil?                                     #   if client.nil?
+            #{on_nil}                                       #     return # depends on :allow_nil
+          else                                              #   else
+            raise                                           #     raise
+          end                                               #   end
+        end                                                 # end
+      EOS
+    end
+  end
+end

data/lib/ext/object.rb

@@ -0,0 +1,57 @@
+class Object
+  # mainly from active_support on http://github.com/rails/rails/
+
+  # Returns +value+ after yielding +value+ to the block. This simplifies the
+  # process of constructing an object, performing work on the object, and then
+  # returning the object from a method. It is a Ruby-ized realization of the K
+  # combinator, courtesy of Mikael Brockman.
+  #
+  # ==== Examples
+  #
+  #  # Without returning
+  #  def foo
+  #    values = []
+  #    values << "bar"
+  #    values << "baz"
+  #    return values
+  #  end
+  #
+  #  foo # => ['bar', 'baz']
+  #
+  #  # returning with a local variable
+  #  def foo
+  #    returning values = [] do
+  #      values << 'bar'
+  #      values << 'baz'
+  #    end
+  #  end
+  #
+  #  foo # => ['bar', 'baz']
+  #
+  #  # returning with a block argument
+  #  def foo
+  #    returning [] do |values|
+  #      values << 'bar'
+  #      values << 'baz'
+  #    end
+  #  end
+  #
+  #  foo # => ['bar', 'baz']
+  def returning(value)
+    yield(value)
+    value
+  end
+
+  # Tries to send the method only if object responds to it. Return +nil+ otherwise.
+  #
+  # ==== Example :
+  #
+  # # Without try
+  # @person ? @person.name : nil
+  #
+  # With try
+  # @person.try(:name)
+  def try(method, *args, &block)
+    send(method, *args, &block) if respond_to?(method, true)
+  end
+end

data/lib/faraday/cookie_auth.rb

@@ -0,0 +1,21 @@
+module Faraday
+  class Request::CookieAuth < Faraday::Middleware
+    delegate :cookie, :cookie=, :to => :@client, :allow_nil => true
+
+    def call(env)
+      env[:request_headers]['Cookie'] = cookie if cookie
+
+      env[:response].on_complete do |finished_env|
+        if finished_env[:response_headers]['set-cookie']
+          self.cookie = finished_env[:response_headers]['set-cookie'].split('; ')[0]
+        end
+      end
+
+      @app.call(env)
+    end
+
+    def initialize(app, client = nil)
+      @app, @client = app, client
+    end
+  end
+end

data/lib/faraday/raise_http_4xx.rb

@@ -0,0 +1,42 @@
+module Faraday
+  class Response::RaiseHttp4xx < Response::Middleware
+    def self.register_on_complete(env)
+      env[:response].on_complete do |response|
+        puts "STATUS: <<<<<<<<< #{response[:status]} >>>>>>>>>>>>"
+        case response[:status].to_i
+        when 400
+          raise CloudConnect::BadRequest, error_message(response)
+        when 401
+          raise CloudConnect::Unauthorized, error_message(response)
+        when 403
+          raise CloudConnect::Forbidden, error_message(response)
+        when 404
+          raise CloudConnect::NotFound, error_message(response)
+        when 406
+          raise CloudConnect::NotAcceptable, error_message(response)
+        when 422
+          raise CloudConnect::UnprocessableEntity, error_message(response)
+        #when 420
+        #  raise CloudConnect::EnhanceYourCalm.new error_message(response), response[:response_headers]
+        end
+      end
+    end
+
+    def initialize(app)
+      super
+      @parser = nil
+    end
+
+    private
+
+    def self.error_message(response)
+      if response[:body] && response[:body].is_a?(Hash) && response[:body]['error']
+        "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{response[:response_headers]['status']}: #{(response[:body]['error'])}"
+      elsif response[:body] && response[:body].is_a?(Array)
+        "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{response[:response_headers]['status']}: #{(response[:body].join(', '))}"
+      else
+        "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{response[:response_headers]['status']}: #{(response[:body])}"
+      end
+    end
+  end
+end

data/lib/faraday/raise_http_5xx.rb

@@ -0,0 +1,27 @@
+module Faraday
+  class Response::RaiseHttp5xx < Response::Middleware
+    def self.register_on_complete(env)
+      env[:response].on_complete do |response|
+        case response[:status].to_i
+        when 500
+          raise CloudConnect::InternalServerError, error_message(response, "Something is technically wrong.")
+        when 502
+          raise CloudConnect::BadGateway, error_message(response, "CloudConnect is down or being upgraded.")
+        when 503
+          raise CloudConnect::ServiceUnavailable, error_message(response, "(__-){ CloudConnect is over capacity.")
+        end
+      end
+    end
+
+    def initialize(app)
+      super
+      @parser = nil
+    end
+
+    private
+
+    def self.error_message(response, body=nil)
+      "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{response[:response_headers]['status']}:#{(' ' + body) if body} Check http://status.g8teway.com/ for updates on the status of the CloudConnect service."
+    end
+  end
+end

metadata

@@ -0,0 +1,245 @@
+--- !ruby/object:Gem::Specification 
+name: cloud_connect
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Jean-Paul Bonnetouche
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-16 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: multi_json
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 31
+        segments: 
+        - 0
+        - 0
+        - 0
+        version: 0.0.0
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: faraday
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 0
+        - 5
+        - 0
+        version: 0.5.0
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: faraday_middleware
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 0
+        - 1
+        - 6
+        version: 0.1.6
+  type: :runtime
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: hashie
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 0
+        - 4
+        - 0
+        version: 0.4.0
+  type: :runtime
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: bluecloth
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 0
+        version: "2.0"
+  type: :development
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 0
+        - 8
+        version: "0.8"
+  type: :development
+  version_requirements: *id008
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 0
+        - 6
+        version: "0.6"
+  type: :development
+  version_requirements: *id009
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id010
+description: Ruby Wrapper for the Mobile Devices Cloud Connect API
+email: 
+- jean-paul.bonnetouche@mobile-devices.fr
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .yardopts
+- Gemfile
+- Gemfile.lock
+- HISTORY.md
+- README.md
+- Rakefile
+- cloud_connect.gemspec
+- lib/cloud_connect.rb
+- lib/cloud_connect/client.rb
+- lib/cloud_connect/client/channels.rb
+- lib/cloud_connect/client/fields.rb
+- lib/cloud_connect/client/messages.rb
+- lib/cloud_connect/client/trackings.rb
+- lib/cloud_connect/client/units.rb
+- lib/cloud_connect/client/users.rb
+- lib/cloud_connect/error.rb
+- lib/cloud_connect/version.rb
+- lib/ext/hash.rb
+- lib/ext/module.rb
+- lib/ext/object.rb
+- lib/faraday/cookie_auth.rb
+- lib/faraday/raise_http_4xx.rb
+- lib/faraday/raise_http_5xx.rb
+has_rdoc: true
+homepage: http://rubygems.org/gems/cloud_connect
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Wrapper for Cloud Connect
+test_files: []
+