naudo-ruby-iactionable 0.1.1

data/.gitignore

@@ -0,0 +1,4 @@
+pkg/*
+.bundle
+.DS_Store
+.rvmrc

data/CHANGELOG.md

@@ -0,0 +1,29 @@
+# CHANGELOG #
+
+## 0.1.1 ##
+
+* changing use of Date to DateTime;
+
+## 0.1.0 ##
+
+* New feature: api instance can be set to not wrap raw response within objects with: `@api.set\_object\_wrapping(false)`
+
+## 0.0.5 ##
+
+* Fixed: IActionable::Objects::Awardable#awarded_on was stripping out time information when converting IActionable timestamp to Ruby time object
+
+## 0.0.4 ##
+
+* explicitly rescuing from timeout errors.
+
+## 0.0.3 ##
+
+* Gem name matches require string.
+
+## 0.0.2 ##
+
+* Gem name matches require string.
+
+## 0.0.1 ##
+
+* Pulling API wrapper out as separate gem (this).

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,39 @@
+PATH
+  remote: .
+  specs:
+    ruby-iactionable (0.1.1)
+      activesupport (>= 3.0.0)
+      faraday
+      faraday_middleware (~> 0.8.7)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.2.3)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    diff-lcs (1.1.3)
+    faraday (0.8.0)
+      multipart-post (~> 1.1)
+    faraday_middleware (0.8.7)
+      faraday (>= 0.7.4, < 0.9)
+    i18n (0.6.0)
+    multi_json (1.3.5)
+    multipart-post (1.1.5)
+    rspec (2.10.0)
+      rspec-core (~> 2.10.0)
+      rspec-expectations (~> 2.10.0)
+      rspec-mocks (~> 2.10.0)
+    rspec-core (2.10.0)
+    rspec-expectations (2.10.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.10.1)
+    yard (0.8.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rspec (>= 2.6)
+  ruby-iactionable!
+  yard

data/README.md

@@ -0,0 +1,49 @@
+# Overview #
+
+Ruby IActionable is a straightforward wrapper for IActionable's restful API.  The JSON-encoded responses from IActionable are wrapped in objects that provide a few extra functions here and there, but are mostly just a representation of the API response.
+
+# How To Use #
+
+## Installation ##
+
+    gem install ruby-iactionable
+
+## IRB ##
+
+    require 'ruby-iactionable'
+
+## Bundler ##
+
+    gem 'ruby-iactionable'
+
+## API Credentials And Initialization ##
+
+Before the API wrapper can be instantiated or used it must be pre-initialized with your IActionable credentials and version number (IActionable supports older versions but recommends staying up to date):
+
+    IActionable::Api.init_settings( :app_key => "12345",
+                                    :api_key => "abcde",
+                                    :version => 3 )
+    @api = IActionable::Api.new
+
+The responses for each of the endpoints of IActionable's API are described through example by [their documentation](http://www.iactionable.com/api/).  Here is an example of the response from a [profile summary](http://iactionable.com/api/) returned as an object by the wrapper.
+
+    profile_summary = @api.get_profile_summary("user", "username", "zortnac", 10)
+    profile_summary.display_name # => "Chris Eberz"
+    profile_summary.identifiers.first # => instance of IActionable::Objects::Identifier
+    profile_summary.identifiers.first.id_type # => "username"
+    profile_summary.identifiers.first.id # => "zortnac"
+
+Each object can be dumped back in to its original form of arrays and key/value pairs:
+
+    profile_summary.to_hash # => { "DisplayName" => "Chris Eberz", "Identifiers" => [ {"ID" => "zortnac", "IDType" => "username", ...} ] ... }
+                            # (not shown in entirety)
+
+----------------
+
+## IActionable ##
+
+[Visit their website!](http://www.iactionable.com)
+
+## Author ##
+
+Christopher Eberz; chris@chriseberz.com; @zortnac

data/Rakefile

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

data/lib/iactionable/api.rb

@@ -0,0 +1,224 @@
+require 'iactionable/connection.rb'
+require 'iactionable/settings.rb'
+require 'iactionable/objects.rb'
+
+module IActionable
+  
+  class Api
+    attr :connection
+    attr :wrap_in_object
+    
+    @@settings = nil
+  
+    def initialize
+      if @@settings
+        @connection = IActionable::Connection.new(@@settings)
+      else
+        raise IActionable::ConfigError.new("IActionable::Api cannot be initialized without credentials being set in IActionable::Api.init_settings()")
+      end
+      @wrap_in_object = true
+    end
+  
+    def self.init_settings(values)
+      @@settings = IActionable::Settings.new(values)
+    rescue IActionable::ConfigError => e
+      raise e
+    end
+  
+    def self.settings
+      @@settings
+    end
+  
+    def set_object_wrapping(bool)
+      @wrap_in_object = !!bool
+      self
+    end
+  
+    # =================
+    # = Event Logging =
+    # =================
+  
+    def log_event(profile_type, id_type, id, event_key, event_attrs = {})
+      response = @connection.request.with_app_key.with_api_key.to("/#{profile_type}/#{id_type}/#{id}/events/#{event_key}").with_params(event_attrs).post
+    end
+  
+    # =====================
+    # = Profile API calls =
+    # =====================
+  
+    def get_profile_summary(profile_type, id_type, id, achievement_count = nil)
+      request = @connection.request.with_app_key.to("/#{profile_type}/#{id_type}/#{id}")
+      request.with_params(:achievementCount => achievement_count) unless achievement_count.blank?
+      if @wrap_in_object
+        IActionable::Objects::ProfileSummary.new(request.get)
+      else
+        request.get
+      end
+    end
+  
+    def create_profile(profile_type, id_type, id, display_name = nil)
+      request = @connection.request.with_app_key.with_api_key.to("/#{profile_type}/#{id_type}/#{id}")
+      request.with_params(:displayName => display_name) unless display_name.blank?
+      request.post
+    end
+    alias_method :update_profile, :create_profile
+  
+    def add_profile_identifier(profile_type, id_type, id, alt_id_type, alt_id)
+      @connection.request.with_app_key.with_api_key.to("/#{profile_type}/#{id_type}/#{id}/identifiers/#{alt_id_type}/#{alt_id}").post
+    end
+  
+    # ====================
+    # = Points API calls =
+    # ====================
+  
+    def get_profile_points(profile_type, id_type, id, point_type)
+      response = @connection.request.with_app_key.to("/#{profile_type}/#{id_type}/#{id}/points/#{point_type}").get
+      if @wrap_in_object
+        IActionable::Objects::ProfilePoints.new(response)
+      else
+        response
+      end
+    end
+  
+    def update_profile_points(profile_type, id_type, id, point_type, amount, reason = nil)
+      request = @connection.request.with_app_key.with_api_key.to("/#{profile_type}/#{id_type}/#{id}/points/#{point_type}").with_params(:value => amount)
+      request.with_params(:description => reason) unless reason.blank?
+      if @wrap_in_object
+        IActionable::Objects::ProfilePoints.new(request.post)
+      else
+        request.post
+      end
+    end
+  
+    # =========================
+    # = Achievement API calls =
+    # =========================
+  
+    def get_profile_achievements(profile_type, id_type, id, filter_type = nil)
+      request = @connection.request.with_app_key
+      case filter_type
+      when :completed
+        request.to("/#{profile_type}/#{id_type}/#{id}/achievements/Completed")
+      when :available
+        request.to("/#{profile_type}/#{id_type}/#{id}/achievements/Available")
+      else
+        request.to("/#{profile_type}/#{id_type}/#{id}/achievements")
+      end
+      
+      if @wrap_in_object
+        IActionable::Objects::ProfileAchievements.new(request.get)
+      else
+        request.get
+      end
+    end
+  
+    def get_achievements()
+      response = @connection.request.with_app_key.to("/achievements").get
+      if @wrap_in_object
+        response.map{|achievement_json| IActionable::Objects::Achievement.new(achievement_json)}
+      else
+        response
+      end
+    rescue NoMethodError => e
+      []
+    end
+  
+    # ========================
+    # = Challenges API calls =
+    # ========================
+  
+    def get_profile_challenges(profile_type, id_type, id, filter_type = nil)
+      request = @connection.request.with_app_key
+      case filter_type
+      when :completed
+        request.to("/#{profile_type}/#{id_type}/#{id}/challenges/Completed")
+      when :available
+        request.to("/#{profile_type}/#{id_type}/#{id}/challenges/Available")
+      else
+        request.to("/#{profile_type}/#{id_type}/#{id}/challenges")
+      end
+      
+      if @wrap_in_object
+        IActionable::Objects::ProfileChallenges.new(request.get)
+      else
+        request.get
+      end
+    end
+  
+    def get_challenges()
+      response = @connection.request.with_app_key.to("/challenges").get
+      if @wrap_in_object
+        response.map{|challenge_json| IActionable::Objects::Challenge.new(challenge_json)}
+      else
+        response
+      end
+    rescue NoMethodError => e
+      []
+    end
+  
+    # ===================
+    # = Goals API calls =
+    # ===================
+  
+    def get_profile_goals(profile_type, id_type, id, filter_type = nil)
+      request = @connection.request.with_app_key
+      case filter_type
+      when :completed
+        request.to("/#{profile_type}/#{id_type}/#{id}/goals/Completed")
+      when :available
+        request.to("/#{profile_type}/#{id_type}/#{id}/goals/Available")
+      else
+        request.to("/#{profile_type}/#{id_type}/#{id}/goals")
+      end
+      
+      if @wrap_in_object
+        IActionable::Objects::ProfileGoals.new(request.get)
+      else
+        request.get
+      end
+    end
+  
+    def get_goals()
+      response = @connection.request.with_app_key.to("/goals").get
+      if @wrap_in_object
+        response.map{|goal_json| IActionable::Objects::Goal.new(goal_json)}
+      else
+        response
+      end
+    rescue NoMethodError => e
+      []
+    end
+  
+    # =========================
+    # = Leaderboard API calls =
+    # =========================
+  
+    def get_leaderboard(profile_type, point_type, leaderboard, page_number=nil, page_count=nil, id=nil, id_type=nil)
+      request = @connection.request.with_app_key.to("/#{profile_type}/leaderboards/points/#{point_type}/#{leaderboard}")
+      request.with_params(:pageNumber => page_number) unless page_number.blank?
+      request.with_params(:pageCount => page_count) unless page_count.blank?
+      request.with_params(:id => id) unless id.blank? || id_type.blank?
+      request.with_params(:idType => id_type) unless id.blank? || id_type.blank?
+      
+      if @wrap_in_object
+        IActionable::Objects::LeaderboardReport.new(request.get)
+      else
+        request.get
+      end
+    end
+  
+    # ===================================
+    # = Profile Notifications API calls =
+    # ===================================
+  
+    def get_profile_notifications(profile_type, id_type, id)
+      response = @connection.request.with_app_key.to("/#{profile_type}/#{id_type}/#{id}/notifications").get
+
+      if @wrap_in_object
+        IActionable::Objects::ProfileNotifications.new(response)
+      else
+        response
+      end
+    end
+  end
+end

data/lib/iactionable/connection.rb

@@ -0,0 +1,118 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'iactionable/error'
+
+module IActionable
+  class Request < Struct.new(:path, :params, :headers, :body)
+    attr :settings
+
+    def initialize(settings)
+      @settings = settings
+      self.path = nil
+      self.params = {}
+      self.headers = {}
+      self.body = {}
+    end
+
+    def to(path)
+      self.path = path unless path.nil? || path.empty?
+      self
+    end
+
+    def with_api_key
+      (self.headers[:Authorization] = @settings.api_key) and self
+    end
+
+    def with_app_key
+      (self.params[:appKey] = @settings.app_key) and self
+    end
+
+    def with_params(params={})
+      self.params.merge!(params) and self
+    end
+
+    def with_body(body={})
+      self.body.merge!(body) and self
+    end
+  end
+
+  class Connection
+    attr :connection
+    attr :settings
+    attr :request
+    attr_accessor :response
+
+    def initialize(settings)
+      @settings = settings
+
+      @connection = Faraday.new api_url(@settings.version) do |builder|
+        builder.use FaradayMiddleware::ParseJson, content_type: 'application/json'
+        builder.use Faraday::Response::RaiseError
+        builder.use Faraday::Adapter::NetHttp
+      end
+
+      @request = nil
+    end
+
+    def request
+      (@request = Request.new(@settings)) and self
+    end
+
+    def get(path=nil, query_params={})
+      @request ||= Request.new(@settings)
+      @request.to(path).with_params(query_params)
+      @response = @connection.get do |req|
+        req.headers.merge! @request.headers
+        req.url @request.path, @request.params
+      end
+      @response.body
+    rescue Faraday::Error::ClientError => e
+      handle_client_error e
+    rescue Faraday::Error::TimeoutError, Timeout::Error => e
+      raise e
+    ensure
+      @request = nil
+    end
+
+    def post(path=nil, query_params={}, body_params={})
+      @request ||= Request.new(@settings)
+      @request.to(path).with_params(query_params)
+      @response = @connection.post do |req|
+        req.headers.merge! @request.headers
+        req.url @request.path, @request.params
+        req.body = @request.body unless @request.body.empty?
+      end
+      @response.body
+    rescue Faraday::Error::ClientError => e
+      handle_client_error e
+    rescue Faraday::Error::TimeoutError, Timeout::Error => e
+      raise e
+    ensure
+      @request = nil
+    end
+
+    private
+
+    def method_missing(symbol, *args)
+      @request.send(symbol, *args) and self
+    rescue NoMethodError => e
+      raise e
+    end
+
+    def api_url(version)
+      "http://api.iactionable.com/v#{version}/"
+    end
+
+    def handle_client_error(e)
+      # http://iactionable.com/api/response-codes/
+      case e.response[:status]
+      when 400
+        raise IActionable::Error::BadRequest.new(e.response)
+      when 401
+        raise IActionable::Error::Unauthorized.new(e.response)
+      when 500
+        raise IActionable::Error::Internal.new(e.response)
+      end
+    end
+  end
+end