balanced 0.3.2 → 0.3.3

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 1.9.3

data/CONTRIBUTORS

@@ -3,3 +3,4 @@ Marshall Jones
 Alex Notov
 Josh Deeden
 Ivan Lyutov
+Alex Sharp

data/README.md

@@ -2,6 +2,8 @@
 
 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:
@@ -25,9 +27,11 @@ See https://www.balancedpayments.com/docs/ruby for tutorials and documentation.
 
 1. Fork it
 2. Create your feature branch (`git checkout -b my-new-feature`)
-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
+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
@@ -54,5 +58,7 @@ spec/cassettes.  To clear them and regenerate:
 ### 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
+ 
+    export AMAZON_ACCESS_KEY_ID='xxx'
+    export AMAZON_SECRET_ACCESS_KEY='yyy' 
+    ./upload_docs.rb

data/balanced.gemspec

@@ -18,6 +18,8 @@ Gem::Specification.new do |gem|
   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.add_development_dependency("yard")
+  gem.add_development_dependency("ruby-debug19")
 
   gem.files         = `git ls-files`.split($\)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }

data/lib/balanced/resources/account.rb

@@ -7,6 +7,18 @@ module Balanced
   class Account
     include Balanced::Resource
 
+    class MoreInformationRequiredError < StandardError
+      attr_reader :response
+
+      def initialize(response)
+        @response = response
+      end
+
+      def redirect_uri
+        response.headers['Location']
+      end
+    end
+
     def initialize attributes = {}
       Balanced::Utils.stringify_keys! attributes
       unless attributes.has_key? 'uri'
@@ -15,8 +27,16 @@ module Balanced
       super attributes
     end
 
+    def save
+      the_response = super
+      if response.status == 300
+        raise MoreInformationRequiredError, response
+      end
+      the_response
+    end
+
     # Returns a new Debit that represents a flow of money from this
-    # Account to your Marketplace.
+    # Account to your Marketplace's escrow account.
     #
     # @return [Debit]
     def debit (amount=nil,

data/lib/balanced/resources/bank_account.rb

@@ -15,7 +15,7 @@ module Balanced
       super attributes
     end
 
-    # Creates a Debit of funds from this BankAccount to your Marketplace.
+    # Creates a Debit of funds from this BankAccount to your Marketplace's escrow account.
     #
     # @param [String] appears_on_statement_as If nil then Balanced will use
     #    the +domain_name+ property from your Marketplace.
@@ -24,7 +24,7 @@ module Balanced
       self.account.debit(amount, appears_on_statement_as, meta, description, self.uri)
     end
 
-    # Creates a Credit of funds from your Marketplace to this Account.
+    # Creates a Credit of funds from your Marketplace's escrow account to this Account.
     #
     # @return [Credit]
     def credit amount, description=nil, meta={}

data/lib/balanced/resources/card.rb

@@ -13,7 +13,7 @@ module Balanced
       super attributes
     end
 
-    # Creates a Debit of funds from this Card to your Marketplace.
+    # Creates a Debit of funds from this Card to your Marketplace's escrow account.
     #
     # If +appears_on_statement_as+ is nil, then Balanced will use the
     # +domain_name+ property from your Marketplace.

data/lib/balanced/resources/credit.rb

@@ -1,6 +1,6 @@
 module Balanced
-  # A Credit represents a transfer of funds from your Marketplace to a
-  # Merchant's Account within your Marketplace.
+  # A Credit represents a transfer of funds from your Marketplace's
+  # escrow account to a Merchant's Account within your Marketplace.
   #
   # By default, a Credit is sent to the most recently added funding
   # destination associated with an Account. You may specify a specific

data/lib/balanced/resources/debit.rb

@@ -1,6 +1,6 @@
 module Balanced
   # A Debit represents a transfer of funds from a buyer's Account to your
-  # Marketplace.
+  # Marketplace's escrow account.
   #
   # A Debit may be created directly, or it will be created as a side-effect
   # of capturing a Hold. If you create a Debit directly it will implicitly

data/lib/balanced/resources/refund.rb

@@ -2,7 +2,7 @@ module Balanced
   # A Refund represents a reversal of funds from a Debit. A Debit can have
   # many Refunds associated with it up to the total amount of the original
   # Debit. Funds are returned to your Marketplace's Merchant Account
-  # proportional to the amoun of the Refund.
+  # proportional to the amount of the Refund.
   #
   class Refund
     include Balanced::Resource

data/lib/balanced/resources/resource.rb

@@ -20,18 +20,23 @@ module Balanced
       elsif !Balanced.is_collection(uri)
         method = :put
       end
-      response = Balanced.send(method, uri, self.attributes)
-      reload response
+      @response = Balanced.send(method, uri, self.attributes)
+      reload @response
     end
 
+    def response
+      @response
+    end
+    private :response
+
     def destroy
       Balanced.delete @attributes[:uri]
     end
 
-    def reload response = nil
-      if response
-        return if response.body.to_s.length.zero?
-        fresh = self.class.construct_from_response response.body
+    def reload the_response = nil
+      if the_response
+        return if the_response.body.to_s.length.zero?
+        fresh = self.class.construct_from_response the_response.body
       else
         fresh = self.find(@attributes[:uri])
       end
@@ -77,6 +82,7 @@ module Balanced
 
     def construct_from_response payload
       payload = Balanced::Utils.hash_with_indifferent_read_access payload
+      return payload if payload[:uri].nil?
       klass = Balanced.from_uri(payload[:uri])
       instance = klass.new payload
       payload.each do |name, value|

data/lib/balanced/version.rb

@@ -1,3 +1,3 @@
 module Balanced
-  VERSION = '0.3.2'
+  VERSION = '0.3.3'
 end

data/spec/spec_helper.rb

@@ -1,6 +1,6 @@
 require 'rubygems'
 require 'bundler/setup'
-
+require 'ruby-debug'
 require 'balanced'
 require 'vcr'
 

data/upload_docs.rb

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+
+require 'aws/s3'
+require 'yard'
+
+# cheap
+args = [
+  'doc',
+  '-e',
+  'doc/balanced_plugin.rb',
+  '-p',
+  'doc/balanced_templates/',
+  '--one-file',
+  '--query',
+  "object.to_s != 'Balanced::Account::MoreInformationRequiredError'",
+  'lib/balanced/resources/account.rb',
+  'lib/balanced/resources/api_key.rb',
+  'lib/balanced/resources/bank_account.rb',
+  'lib/balanced/resources/card.rb',
+  'lib/balanced/resources/credit.rb',
+  'lib/balanced/resources/debit.rb',
+  'lib/balanced/resources/hold.rb',
+  'lib/balanced/resources/marketplace.rb',
+  'lib/balanced/resources/merchant.rb',
+  'lib/balanced/resources/transaction.rb'
+]
+
+YARD::CLI::CommandParser.run(*args)
+
+AWS::S3::Base.establish_connection!(
+  :access_key_id     => ENV['AWS_ACCESS_KEY_ID'], 
+  :secret_access_key => ENV['AWS_SECRET_ACCESS_KEY']
+)
+
+puts AWS::S3::S3Object.store('docs/ruby_api_reference.html', 
+  open('doc/index.html'), 
+  'justice.web',
+  :access => :public_read
+)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: balanced
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-18 00:00:00.000000000 Z
+date: 2012-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -107,6 +107,38 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ruby-debug19
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: ! "Balanced is the payments platform for marketplaces.\n    Integrate
   a payments experience just like Amazon for your marketplace.\n    Forget about dealing
   with banking systems, compliance, fraud, and security.\n    "
@@ -119,6 +151,7 @@ files:
 - .gitignore
 - .rbenv-version
 - .rspec
+- .travis.yml
 - CONTRIBUTORS
 - Gemfile
 - Guardfile
@@ -162,6 +195,7 @@ files:
 - spec/client_spec.rb
 - spec/spec_helper.rb
 - spec/utils_spec.rb
+- upload_docs.rb
 homepage: https://balancedpayments.com
 licenses: []
 post_install_message: