balanced 0.2.5 → 0.3.0

data/.gitignore

@@ -1,5 +1,6 @@
 *.gem
 *.rbc
+*~
 .bundle
 .config
 coverage
@@ -23,3 +24,6 @@ werk
 
 # lib
 Gemfile.lock
+
+# vcr cassettes
+spec/cassettes

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/CONTRIBUTORS

@@ -0,0 +1,4 @@
+Mahmoud Abdelkader
+Marshall Jones
+Alex Notov
+Josh Deeden

data/Gemfile

@@ -1,4 +1,7 @@
 source 'https://rubygems.org'
 
+
 # Specify your gem's dependencies in balanced.gemspec
 gemspec
+
+gem 'rspec'

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/README.md

@@ -1,6 +1,6 @@
 # Balanced
 
-TODO: Write a gem description
+Online Marketplace Payments
 
 ## Installation
 
@@ -18,7 +18,8 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+See https://www.balancedpayments.com/docs/ruby for tutorials and documentation.
+
 
 ## Contributing
 
@@ -27,3 +28,31 @@ TODO: Write usage instructions here
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. 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
+
+    yard doc -e doc/balanced_plugin.rb -p doc/balanced_templates/ 'lib/**/resources.rb' --one-file

data/balanced.gemspec

@@ -14,7 +14,10 @@ Gem::Specification.new do |gem|
   gem.add_dependency("faraday", '~> 0.8')
   gem.add_dependency("faraday_middleware", '~> 0.8.7')
 
-  gem.add_development_dependency("rspec", '~> 2.0')
+  gem.add_development_dependency("rspec", '~> 2.10')
+  gem.add_development_dependency("vcr", '~> 2.2.0')
+  gem.add_development_dependency("guard", '~> 1.1.1')
+  gem.add_development_dependency("guard-rspec", '~> 1.0.0')
 
   gem.files         = `git ls-files`.split($\)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }

data/examples/examples.rb

@@ -6,6 +6,16 @@ rescue NameError
   raise "wtf"
 end
 
+host = ENV['BALANCED_HOST'] or nil
+options = {}
+if host then
+  options[:scheme] = 'http'
+  options[:host] = host
+  options[:port] = 5000
+end
+
+Balanced.configure(nil, options)
+
 puts "create our new api key"
 api_key = Balanced::ApiKey.new.save
 puts "Our secret is: ", api_key.secret
@@ -99,6 +109,12 @@ puts "ok lets invalid a card"
 card['is_valid'] = false
 card.save
 
-raise "This card is NOT VALID" if card.is_valid
+raise "This card is INCORRECTLY VALID" if card.is_valid
+
+puts "invalidating a bank account"
+bank_account['is_valid'] = false
+bank_account.save
+
+raise "This card is INCORRECTLY VALID" if bank_account.is_valid
 
-puts "and there you have it :)"
+puts "and there you have it :)"

data/lib/balanced.rb

@@ -1,8 +1,9 @@
+$:.unshift File.join(File.dirname(__FILE__), "balanced", "resources")
+
 require 'uri'
 require 'balanced/version' unless defined? Balanced::VERSION
 require 'balanced/client'
 require 'balanced/utils'
-require 'balanced/base'
 require 'balanced/resources'
 
 module Balanced
@@ -17,34 +18,15 @@ module Balanced
 
   class << self
 
-    attr_accessor 'client'
-    attr_accessor 'config'
+    attr_accessor :client
+    attr_accessor :config
 
     def configure(api_key=nil, options={})
-      options = @config.merge! options
-      @config = options
-      @client = Balanced::Client.new(api_key, @config)
-    end
-
-    def get uri, params = {}
-      self.client.get uri, params
-    end
-
-    def post uri, data = {}
-      self.client.post uri, data
-    end
-
-    def put uri, data = {}
-      self.client.put uri, data
-    end
-
-    def delete uri
-      self.client.delete uri
+      @client = Balanced::Client.new(api_key, @config.merge(options))
     end
 
     def split_the_uri uri
-      parsed_uri = URI.parse(uri)
-      parsed_uri.path.sub(/\/$/, '').split('/')
+      URI.parse(uri).path.sub(/\/$/, '').split('/')
     end
 
     def from_uri uri
@@ -72,9 +54,18 @@ module Balanced
       end
       true
     end
+
+    def method_missing(method, *args, &block)
+      case method
+        when :get, :post, :put, :delete
+          self.client.send method, *args
+        else
+          super
+      end
+    end
   end
 
   # configure on import so we don't have to configure for creating
   # an api key
   configure
-end
+end

data/lib/balanced/client.rb

@@ -14,17 +14,15 @@ module Balanced
       :logging_level => 'WARN',
     }
 
-    attr :api_key, true
     attr_reader :conn
-    attr_accessor :config
+    attr_accessor :api_key, :config
 
     def initialize(api_key, options={})
       @api_key = api_key.nil? ? api_key : api_key.strip
-      @config = DEFAULTS.merge! options
+      @config = DEFAULTS.merge options
       build_conn
     end
 
-
     def build_conn
       logger = Logger.new(STDOUT)
       logger.level = Logger.const_get(DEFAULTS[:logging_level].to_s)
@@ -37,50 +35,29 @@ module Balanced
         cxn.response :raise_error  # raise exceptions on 40x, 50x responses
         cxn.adapter  Faraday.default_adapter
       end
-      @conn.path_prefix = '/'
-      @conn.headers['User-Agent'] = "balanced-ruby/#{Balanced::VERSION}"
+      conn.path_prefix = '/'
+      conn.headers['User-Agent'] = "balanced-ruby/#{Balanced::VERSION}"
     end
 
-    def inspect  # :nodoc:
-      "<Balanced::Client @api_key=#@api_key, @url=#{url}>"
-    end
+    #def inspect  # :nodoc:
+      #"<Balanced::Client @api_key=#{api_key}, @url=#{url}>"
+    #end
 
     def url
-      _url = URI::HTTP.build(
-        :host => @config[:host],
-        :port => @config[:port],
-      )
-      # wow. yes, this is what you actually have to do.
-      _url.scheme = @config[:scheme]
-      _url
-    end
-
-    # wtf..
-    def get *args
-      op(:get, *args)
-    end
-
-    def post *args
-      op(:post, *args)
-    end
-
-    def put *args
-      op(:put, *args)
-    end
-
-    def delete *args
-      op(:delete, *args)
+      URI::HTTPS.build :host => config[:host], :port => config[:port]
     end
 
     private
 
-    def op (method, *args)
-      unless @api_key.nil?
-        @conn.basic_auth(@api_key, '')
+    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
-      @conn.send(method, *args)
     end
 
   end
-
-end
+end

data/lib/balanced/resources.rb

@@ -1,241 +1,13 @@
-module Balanced
-
-  class ApiKey < Resource
-  end
-
-  class Account < Resource
-
-
-    def initialize attributes = {}
-      Balanced::Utils.stringify_keys! attributes
-      unless attributes.has_key? 'uri'
-        attributes['uri'] = Balanced::Marketplace.my_marketplace.send(self.class.collection_name + '_uri')
-      end
-      super attributes
-    end
-
-    def debit (amount=nil,
-        appears_on_statement_as=nil,
-        hold_uri=nil,
-        meta={},
-        description=nil,
-        source_uri=nil)
-      debit = Debit.new(
-          :uri => self.debits_uri,
-          :amount => amount,
-          :appears_on_statement_as => appears_on_statement_as,
-          :hold_uri => hold_uri,
-          :meta => meta,
-          :description => description,
-          :source_uri => source_uri,
-      )
-      debit.save
-    end
-
-    def hold amount, meta={}, source_uri=nil
-      hold = Hold.new(
-          :uri => self.holds_uri,
-          :amount => amount,
-          :meta => meta,
-          :source_uri => source_uri,
-      )
-      hold.save
-    end
-
-    def credit amount, description=nil, meta={}, destination_uri=nil
-      credit = Credit.new(
-          :uri => self.credits_uri,
-          :amount => amount,
-          :meta => meta,
-          :description => description,
-          :destination_uri => destination_uri,
-      )
-      credit.save
-    end
-
-    def add_card card_uri
-      self.card_uri = card_uri
-      save
-    end
-
-    def add_bank_account bank_account_uri
-      self.bank_account_uri = bank_account_uri
-      save
-    end
-
-    def promote_to_merchant merchant_data
-      self.merchant = merchant
-      save
-    end
-
-  end
-
-  class Merchant < Resource
-
-    def self.me
-      # TODO: use query
-      response = Balanced.get collection_path
-      return nil if response.body.to_s.length.zero? or response.body['total'] == 0
-      payload = response.body
-      construct_from_response payload['items'][0]
-    end
-
-    def me
-      self.class.me
-    end
-
-  end
-
-  class Marketplace < Resource
-
-    def self.my_marketplace
-      # TODO: use query
-      response = Balanced.get collection_path
-      return nil if response.body.to_s.length.zero? or response.body['total'] == 0
-      payload = response.body
-      construct_from_response payload['items'][0]
-    end
-
-    def my_marketplace
-      self.class.my_marketplace
-    end
-
-    def create_buyer email_address, card_uri, name=nil, meta={}
-      account = Account.new(
-        :uri => self.accounts_uri,
-        :email_address => email_address,
-        :card_uri => card_uri,
-        :name => name,
-        :meta => meta,
-      )
-      account.save
-    end
-
-    def create_merchant email_address, merchant, bank_account_uri=nil, name=nil, meta={}
-      account = Account.new(
-        :uri => self.accounts_uri,
-        :email_address => email_address,
-        :merchant => merchant,
-        :bank_account_uri => bank_account_uri,
-        :name => name,
-        :meta => meta,
-      )
-      account.save
-    end
-
-  end
-
-  class Hold < Resource
-
-    def initialize attributes = {}
-      Balanced::Utils.stringify_keys! attributes
-      unless attributes.has_key? 'uri'
-        attributes['uri'] = Balanced::Marketplace.my_marketplace.send(self.class.collection_name + '_uri')
-      end
-      super attributes
-    end
-
-    def void
-      @is_void = true
-      save
-    end
-
-    def capture amount=nil, appears_on_statement_as=nil, meta={}, description=nil
-      amount ||= self.amount
-      self.account.debit(amount, appears_on_statement_as, self.uri, meta, description)
-    end
-
-  end
-
-  class Debit < Resource
-
-    def initialize attributes = {}
-      Balanced::Utils.stringify_keys! attributes
-      unless attributes.has_key? 'uri'
-        attributes['uri'] = Balanced::Marketplace.my_marketplace.send(self.class.collection_name + '_uri')
-      end
-      super attributes
-    end
-
-    def refund amount=nil, description=nil
-      refund = Refund.new(
-          :uri => self.refunds_uri,
-          :debit_uri => self.uri,
-          :amount => amount,
-          :description => description,
-      )
-      refund.save
-    end
-
-  end
-
-  class Credit < Resource
-    def initialize attributes = {}
-      Balanced::Utils.stringify_keys! attributes
-      unless attributes.has_key? 'uri'
-        attributes['uri'] = Balanced::Marketplace.my_marketplace.send(self.class.collection_name + '_uri')
-      end
-      super attributes
-    end
-
-  end
-
-  class Refund < Resource
-    def initialize attributes = {}
-      Balanced::Utils.stringify_keys! attributes
-      unless attributes.has_key? 'uri'
-        attributes['uri'] = Balanced::Marketplace.my_marketplace.send(self.class.collection_name + '_uri')
-      end
-      super attributes
-    end
-
-  end
-
-  class Transaction < Resource
-    def initialize attributes = {}
-      Balanced::Utils.stringify_keys! attributes
-      unless attributes.has_key? 'uri'
-        attributes['uri'] = Balanced::Marketplace.my_marketplace.send(self.class.collection_name + '_uri')
-      end
-      super attributes
-    end
-
-  end
-
-  class Card < Resource
-    def initialize attributes = {}
-      Balanced::Utils.stringify_keys! attributes
-      unless attributes.has_key? 'uri'
-        attributes['uri'] = Balanced::Marketplace.my_marketplace.send(self.class.collection_name + '_uri')
-      end
-      super attributes
-    end
-
-    def debit amount=nil, appears_on_statement_as=nil, holds_uri=nil, meta={}, description=nil
-      self.account.debit(amount, appears_on_statement_as, holds_uri, meta, description, self.uri)
-    end
-
-    def hold amount=nil, meta=nil
-      self.account.hold(amount, meta, self.uri)
-    end
-  end
-
-  class BankAccount < Resource
-    def initialize attributes = {}
-      Balanced::Utils.stringify_keys! attributes
-      unless attributes.has_key? 'uri'
-        attributes['uri'] = Balanced::Marketplace.my_marketplace.send(self.class.collection_name + '_uri')
-      end
-      super attributes
-    end
-
-    def debit amount, appears_on_statement_as=nil, meta={}, description=nil
-      self.account.debit(amount, appears_on_statement_as, meta, description, self.uri)
-    end
-
-    def credit amount, description=nil, meta={}
-      self.account.credit(amount, description, meta, self.uri)
-    end
-  end
-
-end
+$:.unshift File.join(File.dirname(__FILE__), "balanced", "resources")
+require "resource"
+require "account"
+require "api_key"
+require "bank_account"
+require "card"
+require "credit"
+require "debit"
+require "hold"
+require "marketplace"
+require "merchant"
+require "refund"
+require "transaction"