tangocard 0.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NDYyMGMwNGRhZmQ4ZjlhOGFjZjcwZDNlOTRhZjBkOWNiYjQ5M2IyMA==
+  data.tar.gz: !binary |-
+    YjZiYTE0ZTNkZGNiNzVlY2NkZTk4YTMxZWJjNzgwNzM5MTI5NjE0MA==
+SHA512:
+  metadata.gz: !binary |-
+    OGVjODkzNWM1NWMwZTNkYzI2ZWY4ZjZiNzMzOWI4Zjc5YzFjMjNiOGJkNzFl
+    MmQyOWRmNDJlNjgyODcyZjNhNzFmM2M2ZTY0YjcwODJhNzM2ZmE3MTJhMjBi
+    NmVhMTE3MzUwODI3OWY2NzQyNDI5NTRhNmFiNTVjYTMxNmNkODA=
+  data.tar.gz: !binary |-
+    Y2Q1N2QzNTI1M2EyNWY5N2UyYzU4NWZlZGI0NmY4YTllMDM4YmY5ZGYxZjNk
+    NTNjMjIzMjNhMjE0ZTkyZTY4NTg4OTUwMWE5Yzk0NzRiNmIzZjA0ZTczYzE0
+    MDE0MWE2YmIyYjY5NTAzZDdjYmFiYzFhOGZhYThjMzhkYzYxNWI=

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2013 Raphael Crawford-Marks and Smartly, Inc.
+
+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.rdoc

@@ -0,0 +1,10 @@
+= Tangocard
+
+Ruby Wrapper for Tango Card RaaS API.
+
+Tango Card provides a RaaS API for developers (https://github.com/tangocarddev/RaaS). This gem provides commonsense Ruby
+objects to wrap the JSON endpoints of the RaaS API.
+
+This project is developed and maintained by Smartly, Inc. - makers of http://bonus.ly.
+
+This project uses the MIT-LICENSE.

data/Rakefile

@@ -0,0 +1,27 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Tangocard'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+
+
+
+Bundler::GemHelper.install_tasks
+

data/lib/tangocard.rb

@@ -0,0 +1,37 @@
+require 'httparty'
+require 'money'
+require 'ostruct'
+
+module Tangocard
+  class Configuration
+    attr_accessor :name, :key, :base_uri, :default_brands, :local_images, :sku_blacklist
+
+    def initialize
+      self.name = nil
+      self.key = nil
+      self.base_uri = "https://sandbox.tangocard.com"
+      self.default_brands = ['Tango Card']
+      self.local_images = {}
+      self.sku_blacklist = []
+    end
+  end
+
+  def self.configuration
+    @configuration ||=  Configuration.new
+  end
+
+  def self.configure
+    yield(configuration) if block_given?
+  end
+end
+
+require 'tangocard/response'
+require 'tangocard/raas'
+require 'tangocard/account'
+require 'tangocard/account_create_failed_exception'
+require 'tangocard/account_not_found_exception'
+require 'tangocard/brand'
+require 'tangocard/order'
+require 'tangocard/order_create_failed_exception'
+require 'tangocard/order_not_found_exception'
+require 'tangocard/reward'

data/lib/tangocard/account.rb

@@ -0,0 +1,57 @@
+# Wrapper for Tangocard RaaS Account
+# https://github.com/tangocarddev/RaaS#account-resources
+class Tangocard::Account
+  attr_reader :customer, :identifier, :email, :available_balance
+
+  private_class_method :new
+
+  # parsed_response={"success"=>true, "account"=>{"identifier"=>"test1", "email"=>"test@test.com", "customer"=>"bonusly", "available_balance"=>0}}
+  def self.find(customer, identifier)
+    response = Tangocard::Raas.show_account({'customer' => customer, 'identifier' => identifier})
+    if response.success?
+      new(response.parsed_response['account'])
+    else
+      raise Tangocard::AccountNotFoundException, "Tangocard - Error finding account: #{response.error_message}"
+    end
+  end
+
+  def self.create(customer, identifier, email)
+    response = Tangocard::Raas.create_account({'customer' => customer, 'identifier' => identifier, 'email' => email})
+    if response.success?
+      new(response.parsed_response['account'])
+    else
+      raise Tangocard::AccountCreateFailedException, "Tangocard - Error finding account: #{response.error_message}"
+    end
+  end
+
+  def self.find_or_create(customer, identifier, email)
+    begin
+      find(customer, identifier)
+    rescue Tangocard::AccountNotFoundException => e
+      create(customer, identifier, email)
+    end
+  end
+
+  # {"identifier"=>"test1", "email"=>"test@test.com", "customer"=>"bonusly", "available_balance"=>0}
+  def initialize(params)
+    @customer = params['customer']
+    @email = params['email']
+    @identifier = params['identifier']
+    @available_balance = params['available_balance'].to_i
+  end
+
+  def balance
+    @available_balance
+  end
+
+  def fund!(amount, client_ip, credit_card)
+    params = {
+        'amount' => amount,
+        'client_ip' => client_ip,
+        'credit_card' => credit_card,
+        'customer' => customer,
+        'account_identifier' => identifier
+    }
+    Tangocard::Raas.fund_account(params)
+  end
+end

data/lib/tangocard/account_create_failed_exception.rb

@@ -0,0 +1,3 @@
+class Tangocard::AccountCreateFailedException < Exception
+
+end

data/lib/tangocard/account_not_found_exception.rb

@@ -0,0 +1,3 @@
+class Tangocard::AccountNotFoundException < Exception
+
+end

data/lib/tangocard/brand.rb

@@ -0,0 +1,40 @@
+# Documentation: https://github.com/tangocarddev/RaaS
+class Tangocard::Brand
+  attr_reader :description, :rewards
+
+  def self.all
+    result = Tangocard::Raas.rewards_index.parsed_response
+    result['brands'].map{|p| Tangocard::Brand.new(p)}
+  end
+
+  def self.default_brands
+    self.all.select{|b| Tangocard.configuration.default_brands.include?(b.description)}
+  end
+
+  def self.find(brand_name)
+    self.all.select{|b| b.description == brand_name}.first
+  end
+
+  def initialize(params)
+    @description = params['description']
+    @image_url = params['image_url']
+    @rewards = params['rewards'].map{|p| Tangocard::Reward.new(p)}
+  end
+
+  # Some brands don't have logo images provided by the API, so we do this.
+  def image_url
+    Tangocard.configuration.local_images[description] || @image_url
+  end
+
+  def purchasable_rewards(balance_in_cents)
+    rewards.select{|r| r.purchasable?(balance_in_cents) && !Tangocard.configuration.sku_blacklist.include?(r.sku)}
+  end
+
+  def has_purchasable_rewards?(balance_in_cents)
+    purchasable_rewards(balance_in_cents).any?
+  end
+
+  def variable_price?
+    rewards.select{|r| r.variable_price? }.any?
+  end
+end

data/lib/tangocard/order.rb

@@ -0,0 +1,95 @@
+# Wrapper for Tangocard RaaS Order
+# https://github.com/tangocarddev/RaaS#order-resources
+class Tangocard::Order
+  attr_reader :order_id,
+              :account_identifier,
+              :customer,
+              :sku,
+              :amount,
+              :reward_message,
+              :reward_from,
+              :delivered_at,
+              :recipient
+
+  private_class_method :new
+
+  #{
+  #    "success"=>true,
+  #    "order"=> {
+  #        "order_id"=>"113-08258652-15",
+  #        "account_identifier"=>"ElliottTest",
+  #        "customer"=>"ElliottTest",
+  #        "sku"=>"APPL-E-1500-STD",
+  #        "amount"=>1500,
+  #        "reward_message"=>"testing",
+  #        "reward_subject"=>"RaaS Sandbox Test",
+  #        "reward_from"=>"Elliott",
+  #        "delivered_at"=>"2013-08-15T17:42:18+00:00",
+  #        "recipient"=> {
+  #            "name"=>"Elliott",
+  #            "email"=>"elliott@tangocard.com"
+  #        },
+  #        "reward"=> {
+  #            "token"=>"520d12fa655b54.34581245",
+  #            "number"=>"1111111111111256"
+  #        }
+  #    }
+  #}
+
+  def self.all(params = {})
+    response = Tangocard::Raas.orders_index(params)
+    if response.success?
+      response.parsed_response['orders'].map{|o| new(o)}
+    else
+      []
+    end
+  end
+
+  def self.find(order_id)
+    response = Tangocard::Raas.show_order({'order_id' => order_id})
+    if response.success?
+      new(response.parsed_response['order'])
+    else
+      raise Tangocard::OrderNotFoundException, "Order (#{order_id}) not found. Error message: #{response.error_message}"
+    end
+  end
+
+  def self.create(params)
+    response = Tangocard::Raas.create_order(params)
+    if response.success?
+      new(response.parsed_response['order'])
+    else
+      raise Tangocard::OrderCreateFailedException, "#{response.error_message}"
+    end
+  end
+
+  def initialize(params)
+    @order_id = params['order_id']
+    @account_identifier = params['account_identifier']
+    @customer = params['customer']
+    @sku = params['sku']
+    @amount = params['amount']
+    @reward_message = params['reward_message']
+    @reward_subject = params['reward_subject']
+    @reward_from = params['reward_from']
+    @delivered_at = params['delivered_at']
+    @recipient = params['recipient']
+    @reward = params['reward']
+  end
+
+  def reward
+    if @reward.nil?
+      begin
+        @reward = Tangocard::Order.find(self.order_id).reward
+      rescue Tangocard::OrderNotFoundException => e
+        nil
+      end
+    else
+      @reward
+    end
+  end
+
+  def identifier
+    @account_identifier
+  end
+end

data/lib/tangocard/order_create_failed_exception.rb

@@ -0,0 +1,3 @@
+class Tangocard::OrderCreateFailedException < Exception
+
+end

data/lib/tangocard/order_not_found_exception.rb

@@ -0,0 +1,3 @@
+class Tangocard::OrderNotFoundException < Exception
+
+end

data/lib/tangocard/raas.rb

@@ -0,0 +1,50 @@
+# Documentation: https://github.com/tangocarddev/RaaS
+class Tangocard::Raas
+  include HTTParty
+  base_uri Tangocard.configuration.base_uri
+
+  # https://github.com/tangocarddev/RaaS/blob/master/account_create.schema.json
+  def self.create_account(params)
+    Tangocard::Response.new(post('/raas/v1/accounts', {:body => params.to_json}.merge(basic_auth_param)))
+  end
+
+  def self.show_account(params)
+    Tangocard::Response.new(get("/raas/v1/accounts/#{params['customer']}/#{params['identifier']}", basic_auth_param))
+  end
+
+  # https://github.com/tangocarddev/RaaS/blob/master/fund_create.schema.json
+  def self.fund_account(params)
+    Tangocard::Response.new(post('/raas/v1/funds', {:body => params.to_json}.merge(basic_auth_param)))
+  end
+
+  def self.rewards_index
+    Tangocard::Response.new(get('/raas/v1/rewards', basic_auth_param))
+  end
+
+  # https://github.com/tangocarddev/RaaS/blob/master/order_create.schema.json
+  def self.create_order(params)
+    Tangocard::Response.new(post('/raas/v1/orders', {:body => params.to_json}.merge(basic_auth_param)))
+  end
+
+  def self.show_order(params)
+    Tangocard::Response.new(get("/raas/v1/orders/#{params['order_id']}", basic_auth_param))
+  end
+
+  def self.orders_index(params = {})
+    query_string = ""
+    if params.any?
+      query_string = "?"
+      params.keys.each_with_index do |k,i|
+        query_string += "&" unless i == 0
+        query_string += "#{k}=#{params[k]}"
+      end
+    end
+    Tangocard::Response.new(get("/raas/v1/orders#{query_string}", basic_auth_param))
+  end
+
+  private
+
+  def self.basic_auth_param
+    {:basic_auth => {:username => Tangocard.configuration.name, :password => Tangocard.configuration.key}}
+  end
+end

data/lib/tangocard/response.rb

@@ -0,0 +1,29 @@
+# Tangocard RaaS Response Wrapper
+# https://github.com/tangocarddev/RaaS#responses
+class Tangocard::Response
+  attr_reader :raw_response
+
+  def initialize(raw_response)
+    @raw_response = raw_response
+  end
+
+  def parsed_response
+    raw_response.parsed_response
+  end
+
+  def code
+    raw_response.code
+  end
+
+  def success?
+    parsed_response['success']
+  end
+
+  def error_message
+    parsed_response['error_message']
+  end
+
+  def invalid_inputs
+    parsed_response['invalid_inputs']
+  end
+end

data/lib/tangocard/reward.rb

@@ -0,0 +1,34 @@
+# Documentation: https://github.com/tangocarddev/RaaS
+class Tangocard::Reward
+  attr_reader :description, :sku, :currency_type, :unit_price, :available, :min_price, :max_price
+
+  def initialize(params)
+    @description = params['description']
+    @sku = params['sku']
+    @currency_type = params['currency_type']
+    @unit_price = params['unit_price'].to_i
+    @available = params['available']
+    @min_price = params['min_price'].to_i
+    @max_price = params['max_price'].to_i
+  end
+
+  def variable_price?
+    self.unit_price == -1
+  end
+
+  def purchasable?(balance_in_cents)
+    return false unless available
+
+    if variable_price?
+      min_price <= balance_in_cents
+    else
+      unit_price <= balance_in_cents
+    end
+  end
+
+  def price_in_usd(field_name)
+    return nil unless [:min_price, :max_price, :unit_price].include?(field_name)
+
+    Money.new(self.send(field_name), "USD")
+  end
+end

data/lib/tangocard/version.rb

@@ -0,0 +1,3 @@
+module Tangocard
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification
+name: tangocard
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Raphael Crawford-Marks
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+- !ruby/object:Gem::Dependency
+  name: money
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 5.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 5.1.1
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! "Tango Card provides a RaaS API for developers (https://github.com/tangocarddev/RaaS).
+  This gem\n                   provides commonsense Ruby objects to wrap the JSON
+  endpoints of the RaaS API."
+email:
+- raphael@bonus.ly
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tangocard/account.rb
+- lib/tangocard/account_create_failed_exception.rb
+- lib/tangocard/account_not_found_exception.rb
+- lib/tangocard/brand.rb
+- lib/tangocard/order.rb
+- lib/tangocard/order_create_failed_exception.rb
+- lib/tangocard/order_not_found_exception.rb
+- lib/tangocard/raas.rb
+- lib/tangocard/response.rb
+- lib/tangocard/reward.rb
+- lib/tangocard/version.rb
+- lib/tangocard.rb
+- MIT-LICENSE
+- Rakefile
+- README.rdoc
+homepage: http://bonus.ly
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.4
+signing_key: 
+specification_version: 4
+summary: Ruby Wrapper for Tango Card RaaS API.
+test_files: []