balanced-ach 0.1

data/CONTRIBUTORS

@@ -0,0 +1 @@
+Mahmoud Abdelkader

data/Gemfile

@@ -0,0 +1,19 @@
+source :rubygems
+
+# Specify your gem's dependencies in balanced.gemspec
+
+gem "faraday"
+gem "faraday_middleware"
+
+group :development do
+  gem "yard"
+  gem "ruby-debug19"
+  gem "guard", '~> 1.1.1'
+  gem "guard-rspec", '~> 1.0.0'
+end
+
+group :test do
+  gem "rspec", '~> 2.10'
+  gem "rake", '~> 0.9.2'
+  gem "vcr", '~> 2.2.0'
+end

data/Gemfile.lock

@@ -0,0 +1,64 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    archive-tar-minitar (0.5.2)
+    columnize (0.3.6)
+    diff-lcs (1.1.3)
+    faraday (0.8.0)
+      multipart-post (~> 1.1)
+    faraday_middleware (0.8.7)
+      faraday (>= 0.7.4, < 0.9)
+    ffi (1.0.11)
+    guard (1.1.1)
+      listen (>= 0.4.2)
+      thor (>= 0.14.6)
+    guard-rspec (1.0.1)
+      guard (>= 1.1)
+    linecache19 (0.5.12)
+      ruby_core_source (>= 0.1.4)
+    listen (0.4.6)
+      rb-fchange (~> 0.0.5)
+      rb-fsevent (~> 0.9.1)
+      rb-inotify (~> 0.8.8)
+    multipart-post (1.1.5)
+    rake (0.9.2.2)
+    rb-fchange (0.0.5)
+      ffi
+    rb-fsevent (0.9.1)
+    rb-inotify (0.8.8)
+      ffi (>= 0.5.0)
+    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)
+    ruby-debug-base19 (0.11.25)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby_core_source (>= 0.1.4)
+    ruby-debug19 (0.11.6)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby-debug-base19 (>= 0.11.19)
+    ruby_core_source (0.1.5)
+      archive-tar-minitar (>= 0.5.2)
+    thor (0.15.3)
+    vcr (2.2.2)
+    yard (0.8.2.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  faraday
+  faraday_middleware
+  guard (~> 1.1.1)
+  guard-rspec (~> 1.0.0)
+  rake (~> 0.9.2)
+  rspec (~> 2.10)
+  ruby-debug19
+  vcr (~> 2.2.0)
+  yard

data/Guardfile

@@ -0,0 +1,7 @@
+ignore %r{^doc}
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/balanced/(.+)\.rb$})  { |m| "spec/balanced/#{m[1]}_spec.rb" }
+  watch(%r{^lib/balanced/resources/(.+)\.rb$})  { |m| "spec/balanced/resources/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Mahmoud Abdelkader
+
+MIT License
+
+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.md

@@ -0,0 +1,64 @@
+# Balanced
+
+Online Marketplace Payments
+
+[![Build Status](https://secure.travis-ci.org/balanced/balanced-ruby.png)](http://travis-ci.org/balanced/balanced-ruby)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'balanced'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install balanced
+
+## Usage
+
+See https://www.balancedpayments.com/docs/ruby for tutorials and documentation.
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Write your code **and unit tests**
+4. Ensure all tests still pass (`bundle exec rspec`)
+5. Commit your changes (`git commit -am 'Add some feature'`)
+6. Push to the branch (`git push origin my-new-feature`)
+7. Create new pull request
+
+
+### Specs
+
+The spec suite is a work in progress.  Existing specs can either be run
+using [guard](https://github.com/guard/guard) or rake.
+
+Guard
+
+    $ bundle exec guard
+
+Rake
+
+    $ rake spec
+
+We use [VCR](https://www.relishapp.com/myronmarston/vcr/docs) to stub
+out and save http interactions.  Cassettes are not stored in the repo.
+They are generated the first time the spec suite is run and stored in
+spec/cassettes.  To clear them and regenerate:
+
+    $ rm -rf spec/cassettes
+
+
+### Building Documentation
+
+Documentation is build using YARD - http://rubydoc.info/docs/yard
+ 
+    export AMAZON_ACCESS_KEY_ID='xxx'
+    export AMAZON_SECRET_ACCESS_KEY='yyy' 
+    ./upload_docs.rb

data/Rakefile

@@ -0,0 +1,12 @@
+#!/usr/bin/env rake
+require "rake"
+require "rspec/core/rake_task"
+require "bundler/gem_tasks"
+
+desc "Run spec suite"
+RSpec::Core::RakeTask.new(:spec) { |t| }
+
+desc "Default the task to run the spec"
+task :default => [:spec]
+
+

data/balanced.gemspec

@@ -0,0 +1,22 @@
+#!/usr/bin/env gem build
+# -*- encoding: utf-8 -*-
+require "base64"
+require File.expand_path('../lib/balanced/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Mahmoud Abdelkader"]
+  gem.email         = ["bWFobW91ZEBwb3VuZHBheS5jb20="].map { |i| Base64.decode64(i) }
+  gem.description   = %q{Balanced ACH experimental API}
+  gem.summary       = %q{Sign up on https://balancedpayments.com/}
+  gem.homepage      = "https://balancedpayments.com"
+
+  gem.add_dependency("faraday", '~> 0.8')
+  gem.add_dependency("faraday_middleware", '~> 0.8.7')
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "balanced-ach"
+  gem.require_paths = %w(lib)
+  gem.version       = Balanced::VERSION
+end

data/lib/balanced.rb

@@ -0,0 +1,84 @@
+$:.unshift File.join(File.dirname(__FILE__), "balanced", "resources")
+$:.unshift File.join(File.dirname(__FILE__), "balanced", "response")
+
+require 'uri'
+require 'balanced/version' unless defined? Balanced::VERSION
+require 'balanced/client'
+require 'balanced/utils'
+require 'balanced/resources'
+require 'balanced/error'
+
+module Balanced
+
+  @client = nil
+  @config = {
+      :scheme => 'https',
+      :host => 'x.balancedpayments.com',
+      :port => 443,
+      :version => 'a0',
+  }
+
+  class << self
+
+    attr_accessor :client
+    attr_accessor :config
+
+    def configure(api_key=nil, options={})
+      @client = Balanced::Client.new(api_key, @config.merge(options))
+    end
+
+    def is_configured_with_api_key?
+      !@client.api_key.nil?
+    end
+
+    def split_the_uri uri
+      URI.parse(uri).path.sub(/\/$/, '').split('/')
+    end
+
+    def from_uri uri
+      split_uri = split_the_uri(uri)
+      # this is such an ugly hack, basically, we're trying to
+      # see if we have the symbol that matches the capitalized
+      #
+      class_name = Balanced::Utils.classify(split_uri[-1])
+      begin
+        klass = Balanced.const_get class_name
+      rescue NameError
+        class_name = Utils.classify(split_uri[-2])
+        klass = Balanced.const_get(class_name)
+      end
+      klass
+    end
+
+    def is_collection uri
+      split_uri = split_the_uri(uri)
+      class_name = Balanced::Utils.classify(split_uri[-1])
+      begin
+        Balanced.const_get class_name
+      rescue NameError
+        return false
+      end
+      true
+    end
+
+    def get(*args, &block)
+      self.client.get *args
+    end
+
+    def post(*args, &block)
+      self.client.post *args
+    end
+
+    def put(*args, &block)
+      self.client.put *args
+    end
+
+    def delete(*args, &block)
+      self.client.delete *args
+    end
+  end
+
+  # configure on import so we don't have to configure for creating
+  # an api key
+  configure
+end

data/lib/balanced/client.rb

@@ -0,0 +1,82 @@
+require "logger"
+require "uri"
+require "faraday"
+require "faraday_middleware"
+require "balanced_exception_middleware"
+
+
+module Balanced
+  class Client
+
+    DEFAULTS = {
+      :scheme => 'http',
+      :host => 'localhost',
+      :port => 5000,
+      :version => 'v1',
+      :logging_level => 'WARN',
+      :connection_timeout => 2,
+      :read_timeout => 5,
+      :logger => nil
+    }
+
+    attr_reader :conn
+    attr_accessor :api_key, :config
+
+    def initialize(api_key, options={})
+      @api_key = api_key.nil? ? api_key : api_key.strip
+      @config = DEFAULTS.merge options
+      build_conn
+    end
+
+    def build_conn
+      if config[:logger]
+        logger = config[:logger]
+      else
+        logger = Logger.new(STDOUT)
+        logger.level = Logger.const_get(config[:logging_level].to_s)
+      end
+
+      Faraday.register_middleware :response,
+          :handle_balanced_errors => lambda {Faraday::Response::RaiseBalancedError}
+
+      options = {
+        :request => {
+          :open_timeout => config[:connection_timeout],
+          :timeout => config[:read_timeout]
+        }
+      }
+      @conn = Faraday.new(url, options) do |cxn|
+        cxn.request  :json
+
+        cxn.response :logger, logger
+        cxn.response :handle_balanced_errors
+        cxn.response :json
+        # cxn.response :raise_error  # raise exceptions on 40x, 50x responses
+        cxn.adapter  Faraday.default_adapter
+      end
+      conn.path_prefix = '/'
+      conn.headers['User-Agent'] = "balanced-ach-ruby/#{Balanced::VERSION}"
+    end
+
+    #def inspect  # :nodoc:
+      #"<Balanced::Client @api_key=#{api_key}, @url=#{url}>"
+    #end
+
+    def url
+      URI::HTTP.build :host => config[:host], :port => config[:port]
+    end
+
+    private
+
+    def method_missing(method, *args, &block)
+      case method
+      when :get, :post, :put, :delete
+        conn.basic_auth(api_key, '') unless api_key.nil?
+        conn.send method, *args
+      else
+        super
+      end
+    end
+
+  end
+end

data/lib/balanced/error.rb

@@ -0,0 +1,85 @@
+module Balanced
+
+  # Custom error class for rescuing from all Balanced errors
+  class Error < StandardError
+    attr_reader :response
+
+    def initialize(response)
+      @response = response
+      super error_message
+    end
+
+    def body
+      Utils.hash_with_indifferent_read_access response[:body]
+    end
+
+    def error_message
+      set_attrs
+      extra = body[:additional] ? " -- #{body[:additional]}" : ""
+      "#{self.class.name}(#{response[:status]})::#{body[:status]}:: "\
+      "#{response[:method].to_s.upcase} #{response[:url].to_s}: "\
+      "#{body[:category_code]}: #{body[:description]} #{extra}"
+    end
+
+    private
+    def set_attrs
+      body.keys.each do |name|
+        self.class.instance_eval {
+          define_method(name) { body[name] }                       # Get.
+          define_method("#{name}?") { !!body[name].nil? }          # Present.
+        }
+      end
+    end
+  end
+
+  class MoreInformationRequired < Error
+    def redirect_uri
+      response.headers['Location']
+    end
+
+    def error_message
+      set_attrs
+      "#{self.class.name} :: #{response[:method].to_s.upcase} #{response[:url].to_s}: "\
+      "#{response[:status]}: \n#{body[:friendly_html]}"
+    end
+  end
+
+  # Raised when Balanced returns a 400 HTTP status code
+  class BadRequest < Error; end
+
+  # Raised when Balanced returns a 401 HTTP status code
+  class Unauthorized < Error; end
+
+  # Raised when Balanced returns a 402 HTTP status code
+  class PaymentRequired < Error; end
+
+  # Raised when Balanced returns a 403 HTTP status code
+  class Forbidden < Error; end
+
+  # Raised when Balanced returns a 404 HTTP status code
+  class NotFound < Error; end
+
+  # Raised when Balanced returns a 405 HTTP status code
+  class MethodNotAllowed < Error; end
+
+  # Raised when Balanced returns a 409 HTTP status code
+  class Conflict < Error; end
+
+  # Raised when Balanced returns a 410 HTTP status code
+  class Gone < Error; end
+
+  # Raised when Balanced returns a 500 HTTP status code
+  class InternalServerError < Error; end
+
+  # Raised when Balanced returns a 501 HTTP status code
+  class NotImplemented < Error; end
+
+  # Raised when Balanced returns a 502 HTTP status code
+  class BadGateway < Error; end
+
+  # Raised when Balanced returns a 503 HTTP status code
+  class ServiceUnavailable < Error; end
+
+  # Raised when Balanced returns a 504 HTTP status code
+  class GatewayTimeout < Error; end
+end