payout 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3940db8ae3e461215000085dfea8e0ca1fb67e0b
-  data.tar.gz: ede863086c4573132e5499593e3ea38310793da4
+  metadata.gz: 85330fbe4dd8d6e1a4dd4fe9a3ebea9b548387d6
+  data.tar.gz: 5423abe20ab180b944ac6e1d8dbc896b5b1d2e7e
 SHA512:
-  metadata.gz: 08be00a607b6fefeb19f8643d0365d3d83b6064950392255d863985a3332c8025a93dd5a98030e1c6df5f481db47a803763c5676b3aaac9d5dc5ce6bb2636848
-  data.tar.gz: 09b7b34f6c0e0eefaa92565addd1297ae721080024e01c8b33102b4219ab90609b6a41d8c4fce93a20486cb15387f8794ad2732c0221f1be4a62fddbda5c6f79
+  metadata.gz: 9c47bac307a46dacb00bb20e1fc892f7b6649a7894c8c6913c264654933d639fed7216658c5ec7e4423a964cce6e8630f53a03a0453acd187983ccc3342ce17f
+  data.tar.gz: bb4d6d13e77944bbcf7a3eb1c6749a0d61e77c06bc4753b037779018879f118d9700b5781ad6ce67715fc30c052d076e1effb167c27c242d977069f3d9413f9a

data/lib/payout/response.rb

@@ -0,0 +1,80 @@
+require 'json'
+
+##
+# Wraps a RestClient response to provide the Payout SDK interface.
+module Payout
+  class Response
+    class << self
+      # Handles the response from RestClient, including any errors that may be
+      # raised.
+      def handle
+        new(yield)
+      rescue SocketError => e
+        _handle_restclient_connection_error(e)
+      rescue RestClient::ExceptionWithResponse => e
+        _handle_error_with_response(e)
+      rescue RestClient::Exception, Errno::ECONNREFUSED => e
+        _handle_restclient_connection_error(e)
+      end
+
+      private
+
+      def _handle_restclient_connection_error(error)
+        case error
+        when RestClient::RequestTimeout
+          fail TimeoutError
+        when RestClient::ServerBrokeConnection
+          fail ConnectionError, 'The server broke the connection before the ' \
+            'request could complete.'
+        when RestClient::SSLCertificateNotVerified
+          fail ConnectionError, 'Failed to verify SSL certificate.'
+        when SocketError
+          fail ConnectionError, 'An unexpected error occurred when trying to ' \
+            'connect to Payout. This could be a DNS issue. Check that you can ' \
+            'resolve live.payout.com and/or sandbox.payout.com.'
+        else
+          fail ConnectionError, 'An unexpected error occurred when trying to ' \
+            'connect to Payout. Try again or contact us at support@payout.com.'
+        end
+      end
+
+      def _handle_error_with_response(error)
+        if (resp = error.response)
+          fail AuthenticationError, 'invalid credentials' if resp.code == 401
+          new(resp)
+        else
+          _handle_restclient_connection_error(error)
+        end
+      end
+    end # Class Methods
+
+    attr_reader :code
+    attr_reader :body
+
+    def initialize(response)
+      @code = response.code
+      @body = response.body
+      _parse(response.body)
+    end
+
+    def successful?
+      [200, 201].include?(code)
+    end
+
+    def [](key)
+      @_data[key]
+    end
+
+    def to_h
+      @_data.dup
+    end
+
+    private
+
+    def _parse(body)
+      @_data = JSON.parse(body || '{}', symbolize_names: true)
+    rescue JSON::ParserError
+      @_data = {}
+    end
+  end
+end

data/lib/payout/v1/balance.rb

@@ -0,0 +1,13 @@
+module Payout
+  module V1::Balance
+    class << self
+      def retrieve
+        Payout.request(:get, '/v1/balance')
+      end
+
+      def update(params)
+        Payout.request(:put, '/v1/balance', params)
+      end
+    end
+  end # V1::Card
+end # Payout

data/lib/payout/v1/card.rb

@@ -0,0 +1,29 @@
+module Payout
+  module V1::Card
+    class << self
+      def retrieve(token)
+        Payout.request(:get, "/v1/cards/#{token}")
+      end
+
+      def tokenize(params)
+        Payout.request(:post, '/v1/cards', params)
+      end
+
+      def update_customer(params)
+        params = params.dup
+        token = params.delete(:card_token) or
+          fail ArgumentError, 'missing card_token'
+
+        Payout.request(:put, "/v1/cards/#{token}/customer", params)
+      end
+
+      def credit(params)
+        params = params.dup
+        token = params.delete(:card_token) or
+          fail ArgumentError, 'missing card_token'
+
+        Payout.request(:post, "/v1/cards/#{token}/credits", params)
+      end
+    end
+  end # V1::Card
+end # Payout

data/lib/payout/v1/payment.rb

@@ -0,0 +1,13 @@
+module Payout
+  module V1::Payment
+    class << self
+      def search(params = {})
+        Payout.request(:get, '/v1/payments', params)
+      end
+
+      def retrieve(token)
+        Payout.request(:get, "/v1/payments/#{token}")
+      end
+    end
+  end # V1::Card
+end # Payout

data/lib/payout/v1.rb

@@ -0,0 +1,5 @@
+module Payout::V1
+  autoload(:Balance, 'payout/v1/balance')
+  autoload(:Card,    'payout/v1/card')
+  autoload(:Payment, 'payout/v1/payment')
+end

data/lib/payout/version.rb

@@ -0,0 +1,3 @@
+module Payout
+  VERSION = '0.1.0'
+end

data/lib/payout.rb

@@ -0,0 +1,163 @@
+require 'payout/version'
+require 'json'
+require 'base64'
+require 'openssl'
+require 'rest-client'
+
+module Payout
+  autoload(:Response, 'payout/response')
+  autoload(:V1,       'payout/v1')
+
+  class Error < StandardError; end
+  class AuthenticationError < Error; end
+  class VersionError < Error; end
+  class ConnectionError < Error; end
+  class TimeoutError < ConnectionError; end
+
+  DEFAULT_API_VERSION = 1
+  DEFAULT_OPEN_TIMEOUT = 30
+  DEFAULT_READ_TIMEOUT = 80
+  SSL_CA_FILE = File.expand_path('../../data/ca-file.crt', __FILE__).freeze
+
+  class << self
+    def version
+      VERSION
+    end
+
+    def api_version
+      if const_defined?(:API_VERSION)
+        API_VERSION
+      else
+        self.api_version = DEFAULT_API_VERSION
+      end
+    end
+
+    def api_url
+      @api_url || 'https://live.payout.com'
+    end
+
+    def api_token
+      @api_token || fail(AuthenticationError,
+        'Payout.api_token must be defined')
+    end
+
+    def api_secret
+      @api_secret || fail(AuthenticationError,
+        'Payout.api_secret must be defined')
+    end
+
+    def open_timeout
+      @open_timeout || DEFAULT_OPEN_TIMEOUT
+    end
+
+    def read_timeout
+      @read_timeout || DEFAULT_READ_TIMEOUT
+    end
+
+    def api_version=(version)
+      fail ArgumentError, 'must be an integer' unless version.is_a?(Integer)
+      fail ArgumentError, 'must be a positive integer' unless version > 0
+
+      _include_version(version)
+    end
+
+    def api_url=(api_url)
+      if api_url
+        api_url = api_url.dup
+        api_url = api_url[0..-2] if api_url[-1] == '/'
+      end
+
+      @api_url = api_url.freeze
+    end
+
+    def api_token=(token)
+      @api_token = token.dup.freeze
+    end
+
+    def api_secret=(secret)
+      @api_secret = secret.dup.freeze
+    end
+
+    def open_timeout=(timeout)
+      fail ArgumentError, 'must be an integer' unless timeout.is_a?(Integer)
+      @open_timeout = timeout
+    end
+
+    def read_timeout=(timeout)
+      fail ArgumentError, 'must be an integer' unless timeout.is_a?(Integer)
+      @read_timeout = timeout
+    end
+
+    def request(verb, path, params = {})
+      Response.handle { request!(verb, path, params) }
+    end
+
+    def request!(verb, path, params)
+      url = _build_request_url(path)
+      headers = _default_headers
+      body = nil
+
+      case verb
+      when :get, :delete
+        headers[:params] = params if params && params.any?
+      when :post, :put
+        headers[:content_type] = 'application/json'
+        body = params.to_json if params && params.any?
+      else
+        fail ArgumentError, "invalid request verb: #{verb.inspect}"
+      end
+
+      _request(
+        verify_ssl:   OpenSSL::SSL::VERIFY_PEER,
+        ssl_ca_file:  SSL_CA_FILE,
+        open_timeout: open_timeout,
+        read_timeout: read_timeout,
+        method:       verb,
+        url:          url,
+        headers:      headers,
+        payload:      body
+      )
+    end
+
+    private
+
+    def const_missing(name)
+      super if const_defined?(:API_VERSION)
+      self.api_version = DEFAULT_API_VERSION
+      super unless const_defined?(name)
+      const_get(name)
+    end
+
+    def _include_version(version)
+      if const_defined?(:API_VERSION)
+        fail VersionError, 'cannot change version after it has been initialized'
+      end
+
+      unless (version_const = "V#{version}") && const_defined?(version_const)
+        fail ArgumentError, 'unsupported version'
+      end
+
+      include const_get(version_const)
+
+      const_set(:API_VERSION, version)
+    end
+
+    def _build_request_url(path)
+      api_url + (path[0] == '/' ? path : "/#{path}")
+    end
+
+    def _default_headers
+      {
+        authorization: "Basic #{_encoded_credentials}"
+      }
+    end
+
+    def _encoded_credentials
+      Base64.strict_encode64("#{api_token}:#{api_secret}")
+    end
+
+    def _request(request_opts)
+      RestClient::Request.execute(request_opts)
+    end
+  end # Class Methods
+end # Payout

metadata

@@ -1,22 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: payout
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Robert Honer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-01-20 00:00:00.000000000 Z
-dependencies: []
-description: ''
+date: 2016-01-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !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'
+description: 
 email:
 - robert@payout.com
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- lib/payout.rb
+- lib/payout/response.rb
+- lib/payout/v1.rb
+- lib/payout/v1/balance.rb
+- lib/payout/v1/card.rb
+- lib/payout/v1/payment.rb
+- lib/payout/version.rb
 homepage: http://github.com/payout/payout-ruby
 licenses:
 - BSD
@@ -37,8 +72,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.6
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
-summary: ''
+summary: Payout your customers quickly and easily. See www.payout.com for more.
 test_files: []