dwolla_v2 0.4.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 347bf32bfbb4db49d6341c3db975cf696a97f492
-  data.tar.gz: 38d265059cb4ddac927d141096bd145a76cf2c60
+  metadata.gz: 2db53d14d332c6a4e13f74f7a9986e361b8509e7
+  data.tar.gz: 2c61640b59008a32254807efcc050f6d4256b277
 SHA512:
-  metadata.gz: 053be0c20b5da0da5c421dcb8979ca1aefcc4a6620c8383e2251b0e458042b222c5c76682051d08706fe2a9f9d8e043d8702bcd8781fc6a89397b9982bc532db
-  data.tar.gz: 43695d6c3e63d61003cac1ba3b72735ebc9f7e53b7926b4cec186f01d4e5b0d34e466091a0405cb340a846511f788493d9bf7cbd779d8b9c18cfe6900e89c9be
+  metadata.gz: 47f74c7ce9469f1b9f46422ac6339c3091784da493892e2e2a68ea9a46c6cb25082513eb7455d0d404c22934d62c8c5b967929394c1588762d23fabf3eb6007b
+  data.tar.gz: e0117f0296365e9abec6b5caaa1ceaa3f716fb5e75c6824c35b49f851490abe48dc14fa5aa362e2490af89cbf7ca90d1c267db0d83e552859c3237ea01f851ce

data/README.md

@@ -11,7 +11,7 @@ Dwolla V2 Ruby client. For the V1 Ruby client see [Dwolla/dwolla-ruby](https://g
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'dwolla_v2', '~> 0.4'
+gem 'dwolla_v2', '~> 1.0'
 ```
 
 And then execute:
@@ -22,41 +22,122 @@ Or install it yourself as:
 
     $ gem install dwolla_v2
 
-## Usage
+## `DwollaV2::Client`
 
-#### Creating a client
+### Basic usage
 
 ```ruby
-$dwolla = DwollaV2::Client.new(id: "CLIENT_ID", secret: "CLIENT_SECRET") do |optional_config|
-  optional_config.environment = :sandbox
-  optional_config.on_grant do |token|
-    YourTokenData.create! token
-  end
-  optional_config.faraday do |faraday|
+# config/initializers/dwolla.rb
+$dwolla = DwollaV2::Client.new(id: ENV["DWOLLA_ID"], secret: ENV["DWOLLA_SECRET"])
+```
+
+### Using the sandbox environment (optional)
+
+```ruby
+# config/initializers/dwolla.rb
+$dwolla = DwollaV2::Client.new(id: ENV["DWOLLA_ID"], secret: ENV["DWOLLA_SECRET"]) do |config|
+  config.environment = :sandbox
+end
+```
+
+`environment=` defaults to `:production` and accepts either a String or a Symbol.
+
+### Configure an `on_grant` callback (optional)
+
+An `on_grant` callback is useful for storing new tokens when they are granted. For example, you
+may have a `YourTokenData` ActiveRecord model that you use to store your tokens. The `on_grant`
+callback is called with the `DwollaV2::Token` that was just granted by the server. You can pass
+this to the `create!` method of an ActiveRecord model to create a record using the token's data.
+
+```ruby
+# config/initializers/dwolla.rb
+$dwolla = DwollaV2::Client.new(id: ENV["DWOLLA_ID"], secret: ENV["DWOLLA_SECRET"]) do |config|
+  config.on_grant {|t| YourTokenData.create!(t) }
+end
+```
+
+It is highly recommended that you encrypt any token data you store using
+[attr_encrypted][attr_encrypted] or [vault-rails][vault-rails] (if you use [Vault][vault]). These
+are both configured in your ActiveRecord models.
+
+[attr_encrypted]: https://github.com/attr-encrypted/attr_encrypted
+[vault-rails]: https://github.com/hashicorp/vault-rails
+[vault]: https://www.vaultproject.io/
+
+### Configure Faraday (optional)
+
+DwollaV2 uses [Faraday][faraday] to make HTTP requests. You can configure your own
+[Faraday middleware][faraday-middleware] and adapter when configuring your client. Remember to
+always include an adapter last, even if you want to use the default adapter.
+
+[faraday]: https://github.com/lostisland/faraday
+[faraday-middleware]: https://github.com/lostisland/faraday_middleware
+
+```ruby
+# config/initializers/dwolla.rb
+$dwolla = DwollaV2::Client.new(id: ENV["DWOLLA_ID"], secret: ENV["DWOLLA_SECRET"]) do |config|
+  config.faraday do |faraday|
     faraday.response :logger
     faraday.adapter Faraday.default_adapter
   end
 end
 ```
 
-#### Authorization
+## `DwollaV2::Token`
 
-Get an application token:
+Tokens can be used to make requests to the Dwolla V2 API. There are two types of tokens:
+
+### Application tokens
+
+Application tokens are used to access the API on behalf of a consumer application. API resources that
+belong to an application include: `webhook-subscriptions`, `events`, and `webhooks`. Application
+tokens can be created using the [`client_credentials`][client_credentials] OAuth grant type:
+
+[client_credentials]: https://tools.ietf.org/html/rfc6749#section-4.4
 
 ```ruby
-$dwolla.auths.client scope: "ManageCustomers|Funding"
+application_token = $dwolla.auths.client
+# => #<DwollaV2::Token client=#<DwollaV2::Client id="..." secret="..." environment=:sandbox> access_token="..." expires_in=3600 scope="...">
 ```
 
-Get an account token:
+*Application tokens do not include a `refresh_token`. When an application token expires, generate
+a new one using `$dwolla.auths.client`.*
+
+### Account tokens
+
+Account tokens are used to access the API on behalf of a Dwolla account. API resources that belong
+to an account include `customers`, `funding-sources`, `documents`, `mass-payments`, `mass-payment-items`,
+`transfers`, and `on-demand-authorizations`.
+
+There are two ways to get an account token. One is by generating a token at
+https://uat.dwolla.com/applications (sandbox) or https://www.dwolla.com/applications (production).
+
+You can instantiate a generated token by doing the following:
+
+```ruby
+account_token = $dwolla.tokens.new access_token: "...", refresh_token: "..."
+# => #<DwollaV2::Token client=#<DwollaV2::Client id="..." secret="..." environment=:sandbox> access_token="..." refresh_token="...">
+```
+
+The other way to get an account token is using the [`authorization_code`][authorization_code]
+OAuth grant type. This flow works by redirecting a user to dwolla.com in order to get authorization
+and sending them back to your website with an authorization code which can be exchanged for a token.
+For example:
+
+[authorization_code]: https://tools.ietf.org/html/rfc6749#section-4.1
 
 ```ruby
 class YourAuthController < ApplicationController
+  # redirect the user to dwolla.com for authorization
   def authorize
     redirect_to auth.url
   end
 
+  # https://yoursite.com/callback
   def callback
-    token = auth.callback params
+    # exchange the code for a token
+    token = auth.callback(params)
+    # => #<DwollaV2::Token client=#<DwollaV2::Client id="..." secret="..." environment=:sandbox> access_token="..." refresh_token="..." expires_in=3600 scope="ManageCustomers|Funding" account_id="...">
     session[:account_id] = token.account_id
   end
 
@@ -70,31 +151,51 @@ class YourAuthController < ApplicationController
 end
 ```
 
-Refresh a token:
+### Refreshing tokens
+
+Tokens with `refresh_token`s can be refreshed using `$dwolla.auths.refresh`, which takes a
+`DwollaV2::Token` as its first argument and returns a new token.
 
 ```ruby
-token = $dwolla.auths.refresh expired_token
+refreshed_token = $dwolla.auths.refresh(expired_token)
+# => #<DwollaV2::Token client=#<DwollaV2::Client id="..." secret="..." environment=:sandbox> access_token="..." refresh_token="..." expires_in=3600 scope="ManageCustomers|Funding" account_id="...">
 ```
 
-Initialize a token:
+### Initializing tokens:
+
+`DwollaV2::Token`s can be initialized with the following attributes:
 
 ```ruby
-token_data = YourTokenData.find_by account_id: "ACCOUNT_ID"
-token = $dwolla.tokens.new token_data
+$dwolla.tokens.new access_token: "...",
+                   refresh_token: "...",
+                   expires_in: 123,
+                   scope: "...",
+                   account_id: "..."
+#<DwollaV2::Token client=#<DwollaV2::Client id="..." secret="..." environment=:sandbox> access_token="..." refresh_token="..." expires_in=123 scope="..." account_id="...">
 ```
 
-#### Making requests
+## Requests
+
+`DwollaV2::Token`s can make requests using the `#get`, `#post`, `#put`, and `#delete` methods.
 
 ```ruby
-token.get "/resource", foo: "bar"
-token.post "/resource", foo: "bar"
-token.post "/resource", foo: Faraday::UploadIO.new("/path/to/bar.png", "image/png")
-token.put "/resource", foo: "bar"
-token.put "/resource", foo: Faraday::UploadIO.new("/path/to/bar.png", "image/png")
-token.delete "/resource"
+# GET api.dwolla.com/resource?foo=bar
+token.get "resource", foo: "bar"
+
+# POST api.dwolla.com/resource {"foo":"bar"}
+token.post "resource", foo: "bar"
+
+# POST api.dwolla.com/resource multipart/form-data foo=...
+token.post "resource", foo: Faraday::UploadIO.new("/path/to/bar.png", "image/png")
+
+# PUT api.dwolla.com/resource {"foo":"bar"}
+token.put "resource", foo: "bar"
+
+# DELETE api.dwolla.com/resource
+token.delete "resource"
 ```
 
-In parallel:
+Requests can also be made in parallel:
 
 ```ruby
 foo, bar = nil
@@ -106,50 +207,52 @@ puts foo # only ready after `in_parallel` block has executed
 puts bar # only ready after `in_parallel` block has executed
 ```
 
-#### Responses
+## Responses
 
 Requests return a `DwollaV2::Response`.
 
-**Response status**:
-
 ```ruby
-res = token.post "/customers", customer_params
-res.status # => 201
-```
+res = token.get "/"
+# => #<DwollaV2::Response status=200 headers={"server"=>"cloudflare-nginx", "date"=>"Mon, 28 Mar 2016 15:30:23 GMT", "content-type"=>"application/vnd.dwolla.v1.hal+json; charset=UTF-8", "content-length"=>"150", "connection"=>"close", "set-cookie"=>"__cfduid=d9dcd0f586c166d36cbd45b992bdaa11b1459179023; expires=Tue, 28-Mar-17 15:30:23 GMT; path=/; domain=.dwolla.com; HttpOnly", "x-request-id"=>"69a4e612-5dae-4c52-a6a0-2f921e34a88a", "cf-ray"=>"28ac1f81875941e3-MSP"} {"_links"=>{"events"=>{"href"=>"https://api-uat.dwolla.com/events"}, "webhook-subscriptions"=>{"href"=>"https://api-uat.dwolla.com/webhook-subscriptions"}}}>
 
-**Response headers**:
+res.status
+# => 200
 
-```ruby
-customer = token.post "/customers", customer_params
-customer.headers[:location] # => "https://api.dwolla.com/customers/aa76ca27-1920-4a0a-9bbe-a22085c0010e"
+res.headers
+# => {"server"=>"cloudflare-nginx", "date"=>"Mon, 28 Mar 2016 15:30:23 GMT", "content-type"=>"application/vnd.dwolla.v1.hal+json; charset=UTF-8", "content-length"=>"150", "connection"=>"close", "set-cookie"=>"__cfduid=d9dcd0f586c166d36cbd45b992bdaa11b1459179023; expires=Tue, 28-Mar-17 15:30:23 GMT; path=/; domain=.dwolla.com; HttpOnly", "x-request-id"=>"69a4e612-5dae-4c52-a6a0-2f921e34a88a", "cf-ray"=>"28ac1f81875941e3-MSP"}
+
+res._links.events.href
+# => "https://api-uat.dwolla.com/events"
 ```
 
-**Response body**:
+## Errors
 
-[Enumerable methods](http://ruby-doc.org/core-2.3.0/Enumerable.html), `#==`, and `#[]` are
-forwarded to a response's body. For example:
+If the server returns an error, a `DwollaV2::Error` (or one of its subclasses) will be raised.
+`DwollaV2::Error`s are similar to `DwollaV2::Response`s.
 
 ```ruby
-customer = token.get "/customers/aa76ca27-1920-4a0a-9bbe-a22085c0010e"
-
-customer.collect {|k,v| k }      # => [:_links, :id, ...]
-customer.body.collect {|k,v| k } # => [:_links, :id, ...]
-
-customer == customer.body # => true
-
-customer[:name]      # => John Doe
-customer.body[:name] # => John Doe
+begin
+  token.get "/not-found"
+rescue DwollaV2::NotFoundError => e
+  e
+  # => #<DwollaV2::NotFoundError status=404 headers={"server"=>"cloudflare-nginx", "date"=>"Mon, 28 Mar 2016 15:35:32 GMT", "content-type"=>"application/vnd.dwolla.v1.hal+json; profile=\"http://nocarrier.co.uk/profiles/vnd.error/\"; charset=UTF-8", "content-length"=>"69", "connection"=>"close", "set-cookie"=>"__cfduid=da1478bfdf3e56275cd8a6a741866ccce1459179332; expires=Tue, 28-Mar-17 15:35:32 GMT; path=/; domain=.dwolla.com; HttpOnly", "access-control-allow-origin"=>"*", "x-request-id"=>"667fca74-b53d-43db-bddd-50426a011881", "cf-ray"=>"28ac270abca64207-MSP"} {"code"=>"NotFound", "message"=>"The requested resource was not found."}>
+
+  e.status
+  # => 404
+
+  e.headers
+  # => {"server"=>"cloudflare-nginx", "date"=>"Mon, 28 Mar 2016 15:35:32 GMT", "content-type"=>"application/vnd.dwolla.v1.hal+json; profile=\"http://nocarrier.co.uk/profiles/vnd.error/\"; charset=UTF-8", "content-length"=>"69", "connection"=>"close", "set-cookie"=>"__cfduid=da1478bfdf3e56275cd8a6a741866ccce1459179332; expires=Tue, 28-Mar-17 15:35:32 GMT; path=/; domain=.dwolla.com; HttpOnly", "access-control-allow-origin"=>"*", "x-request-id"=>"667fca74-b53d-43db-bddd-50426a011881", "cf-ray"=>"28ac270abca64207-MSP"}
+
+  e.code
+  # => "NotFound"
+rescue DwollaV2::Error => e
+  # ...
+end
 ```
 
-#### Errors
-
-All errors inherit from `DwollaV2::Error`
+### `DwollaV2::Error` subclasses:
 
-OAuth errors have `error`, `error_description`, and `error_uri` attributes.
-
-Dwolla API errors have `code`, `message`, `_links`, and `_embedded` attributes.
-
-**Error list:**
+*See https://docsv2.dwolla.com/#errors for more info.*
 
 - `DwollaV2::AccessDeniedError`
 - `DwollaV2::InvalidCredentialsError`
@@ -176,6 +279,15 @@ Dwolla API errors have `code`, `message`, `_links`, and `_embedded` attributes.
 - `DwollaV2::MethodNotAllowedError`
 - `DwollaV2::ValidationError`
 
+## Sample code
+
+The following gist contains some sample bootstrapping code:
+
+https://gist.github.com/sausman/df58a196b3bc0381b0e8
+
+If you have any questions regarding your specific implementation we'll do our best to help
+at https://discuss.dwolla.com/.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -192,6 +304,7 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Changelog
 
+- **1.0.0** - Refactor `Error` class to be more like response, add ability to access keys using methods.
 - **0.4.0** - Refactor and document how `DwollaV2::Response` works
 - **0.3.1** - better `DwollaV2::Error` error messages
 - **0.3.0** - ISO8601 values in response body are converted to `Time` objects

data/dwolla_v2.gemspec

@@ -24,6 +24,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "webmock", "~> 1.22"
 
+  spec.add_dependency "hashie", "~> 3.4"
   spec.add_dependency "faraday", "~> 0.9"
   spec.add_dependency "faraday_middleware", "~> 0.10"
 end

data/lib/dwolla_v2.rb

@@ -2,6 +2,9 @@ require "base64"
 require "uri"
 require "json"
 require "forwardable"
+require "ostruct"
+
+require "hashie"
 
 require "faraday"
 require "faraday_middleware"
@@ -14,9 +17,10 @@ require "dwolla_v2/token"
 require "dwolla_v2/response"
 require "dwolla_v2/error"
 require "dwolla_v2/util"
+require "dwolla_v2/super_hash"
 
-require "dwolla_v2/middleware/symbolize_response_body"
-require "dwolla_v2/middleware/parse_iso8601_response_body"
+require "dwolla_v2/middleware/deep_parse_iso8601_response_body"
+require "dwolla_v2/middleware/deep_super_hasherize_response_body"
 require "dwolla_v2/middleware/handle_errors"
 
 # OAuth errors https://tools.ietf.org/html/rfc6749

data/lib/dwolla_v2/auth.rb

@@ -46,11 +46,10 @@ module DwollaV2
 
     def self.request_token client, params
       res = client.conn.post client.token_url, params
-      res_body = Util.deep_symbolize_keys res.body
-      if res.status >= 400 || (res_body.is_a?(Hash) && res_body.has_key?(:error))
-        Error.raise! res_body
+      if !res.body.is_a?(Hash) || res.body.has_key?(:error)
+        Error.raise! res
       else
-        token = Token.new client, res_body
+        token = Token.new client, res.body
         client.on_grant.call token unless client.on_grant.nil?
         token
       end

data/lib/dwolla_v2/client.rb

@@ -1,7 +1,7 @@
 module DwollaV2
   class Client
     ENVIRONMENTS = {
-      :default => {
+      :production => {
         :auth_url  => "https://www.dwolla.com/oauth/v2/authenticate",
         :token_url => "https://www.dwolla.com/oauth/v2/token",
         :api_url   => "https://api.dwolla.com"
@@ -28,13 +28,14 @@ module DwollaV2
     end
 
     def environment= env
+      env = :"#{env}"
       raise ArgumentError.new "invalid environment" unless ENVIRONMENTS.has_key? env
       @environment = env
     end
 
     def environment env = nil
       self.environment = env unless env.nil?
-      @environment || :default
+      @environment || :production
     end
 
     def on_grant &callback
@@ -51,6 +52,9 @@ module DwollaV2
       @conn ||= Faraday.new do |f|
         f.request :basic_auth, id, secret
         f.request :url_encoded
+        f.use HandleErrors
+        f.use DeepSuperHasherizeResponseBody
+        f.use DeepParseIso8601ResponseBody
         f.response :json, :content_type => /\bjson$/
         faraday.call(f) if faraday
         f.adapter Faraday.default_adapter unless faraday
@@ -68,5 +72,9 @@ module DwollaV2
     def api_url
       ENVIRONMENTS[environment][:api_url]
     end
+
+    def inspect
+      Util.pretty_inspect self.class.name, id: id, secret: secret, environment: environment
+    end
   end
 end

data/lib/dwolla_v2/error.rb

@@ -1,38 +1,83 @@
 module DwollaV2
   class Error < StandardError
-    def self.raise! error
-      raise self.new unless error.is_a? Hash
-      if klass = error_class(error[:error] || error[:code])
-        raise klass.new error
+    extend Forwardable
+
+    delegate [:status] => :@response
+    delegate [:to_s, :to_json] => :response_body
+
+    def self.raise! response
+      unless response.respond_to? :body
+        response = turn_into_response(response)
+      end
+      if response.body.is_a?(Hash) && klass = error_class(response.body[:error] || response.body[:code])
+        raise klass, response, caller
       else
-        raise self.new error
+        raise self, response, caller
       end
     end
 
-    def initialize error = nil
-      @error = error
+    def initialize response
+      @response = response
     end
 
-    def message
-      @error[:message]
+    def headers
+      if @response.respond_to? :response_headers
+        @response.response_headers
+      elsif @response.respond_to? :headers
+        @response.headers
+      end
+    end
+
+    def respond_to? method, include_private = false
+      super || response_body.respond_to?(method)
+    end
+
+    def is_a? klass
+      super || response_body.is_a?(klass)
+    end
+
+    def kind_of? klass
+      super || response_body.kind_of?(klass)
     end
 
-    def [] key
-      @error[key] rescue nil
+    def == other
+      super || response_body == other
     end
 
-    def method_missing method
-      @error[method] rescue nil
+    def method_missing method, *args, &block
+      if response_body.respond_to? method
+        response_body.public_send method, *args, &block
+      else
+        super
+      end
+    end
+
+    def message
+      to_s
     end
 
-    def to_s
-      @error.to_s
+    def to_str
+      nil
+    end
+
+    def inspect
+      Util.pretty_inspect self.class.name, { status: status, headers: headers }, response_body
     end
 
     private
 
+    def self.turn_into_response response
+      OpenStruct.new status: nil,
+                     headers: nil,
+                     body: Util.deep_super_hasherize(Util.deep_parse_iso8601_values response)
+    end
+
     def self.error_class error_code
       DwollaV2.const_get "#{Util.classify(error_code).chomp("Error")}Error" rescue false
     end
+
+    def response_body
+      @response.body
+    end
   end
 end

data/lib/dwolla_v2/middleware/{parse_iso8601_response_body.rb → deep_parse_iso8601_response_body.rb}

@@ -1,5 +1,5 @@
 module DwollaV2
-  class ParseIso8601ResponseBody
+  class DeepParseIso8601ResponseBody
     def initialize app
       @app = app
     end

data/lib/dwolla_v2/middleware/{symbolize_response_body.rb → deep_super_hasherize_response_body.rb}

@@ -1,12 +1,12 @@
 module DwollaV2
-  class SymbolizeResponseBody
+  class DeepSuperHasherizeResponseBody
     def initialize app
       @app = app
     end
 
     def call request_env
       @app.call(request_env).on_complete do |response_env|
-        response_env.body = Util.deep_symbolize_keys(response_env.body)
+        response_env.body = Util.deep_super_hasherize(response_env.body)
       end
     end
   end

data/lib/dwolla_v2/middleware/handle_errors.rb

@@ -6,7 +6,7 @@ module DwollaV2
 
     def call request_env
       @app.call(request_env).on_complete do |response_env|
-        Error.raise!(response_env.body) if response_env.status >= 400
+        Error.raise!(response_env) if response_env.status >= 400
       end
     end
   end

data/lib/dwolla_v2/response.rb

@@ -2,23 +2,49 @@ module DwollaV2
   class Response
     extend Forwardable
 
-    # http://ruby-doc.org/core-2.3.0/Enumerable.html
-    ENUMERABLE = \
-      [:all?, :any?, :chunk, :chunk_while, :collect, :collect_concat, :count, :cycle,
-       :detect, :drop, :drop_while, :each_cons, :each_entry, :each_slice, :each_with_index,
-       :each_with_object, :entries, :find, :find_all, :find_index, :first, :flat_map, :grep,
-       :grep_v, :group_by, :include?, :inject, :lazy, :map, :max, :max_by, :member?, :min,
-       :min_by, :minmax, :minmax_by, :none?, :one?, :partition, :reduce, :reject,
-       :reverse_each, :select, :slice_after, :slice_before, :slice_when, :sort, :sort_by,
-       :take, :take_while, :to_a, :to_h, :zip]
-
-    delegate [:status, :headers, :body] => :@response
-    delegate [*ENUMERABLE, :==, :[]] => :response_body
+    delegate [:status] => :@response
+    delegate [:to_s, :to_json] => :response_body
 
     def initialize response
       @response = response
     end
 
+    def headers
+      if @response.respond_to? :response_headers
+        @response.response_headers
+      elsif @response.respond_to? :headers
+        @response.headers
+      end
+    end
+
+    def respond_to? method, include_private = false
+      super || response_body.respond_to?(method)
+    end
+
+    def is_a? klass
+      super || response_body.is_a?(klass)
+    end
+
+    def kind_of? klass
+      super || response_body.kind_of?(klass)
+    end
+
+    def == other
+      super || response_body == other
+    end
+
+    def method_missing method, *args, &block
+      if response_body.respond_to? method
+        response_body.public_send method, *args, &block
+      else
+        super
+      end
+    end
+
+    def inspect
+      Util.pretty_inspect self.class.name, { status: status, headers: headers }, response_body
+    end
+
     private
 
     def response_body

data/lib/dwolla_v2/super_hash.rb

@@ -0,0 +1,12 @@
+module DwollaV2
+  class SuperHash < Hash
+    include Hashie::Extensions::KeyConversion
+    include Hashie::Extensions::MethodAccess
+    include Hashie::Extensions::IndifferentAccess
+    include Hashie::Extensions::DeepFetch
+
+    def == other
+      super(other) || super(self.class[other])
+    end
+  end
+end

data/lib/dwolla_v2/token.rb

@@ -43,6 +43,12 @@ module DwollaV2
       end
     end
 
+    def inspect
+      Util.pretty_inspect self.class.name,
+        client: client, access_token: access_token, refresh_token: refresh_token,
+        expires_in: expires_in, scope: scope, app_id: app_id, account_id: account_id
+    end
+
     private
 
     def conn
@@ -52,8 +58,8 @@ module DwollaV2
         f.request :multipart
         f.request :json
         f.use HandleErrors
-        f.use ParseIso8601ResponseBody
-        f.use SymbolizeResponseBody
+        f.use DeepSuperHasherizeResponseBody
+        f.use DeepParseIso8601ResponseBody
         f.response :json, :content_type => /\bjson$/
         client.faraday.call(f) if client.faraday
         f.adapter Faraday.default_adapter unless client.faraday

data/lib/dwolla_v2/util.rb

@@ -1,10 +1,10 @@
 module DwollaV2
   module Util
-    def self.deep_symbolize_keys obj
+    def self.deep_super_hasherize obj
       if obj.is_a? Hash
-        Hash[obj.map{|k,v| [k.to_sym, deep_symbolize_keys(v)] }]
+        SuperHash[obj.map{|k,v| [k, deep_super_hasherize(v)] }]
       elsif obj.is_a? Array
-        obj.map {|i| deep_symbolize_keys(i) }
+        obj.map {|i| deep_super_hasherize(i) }
       else
         obj
       end
@@ -27,5 +27,14 @@ module DwollaV2
         i.sub(/^(.)/) { $1.capitalize }
       end.join
     end
+
+    def self.pretty_inspect klass_name, attrs, append = nil
+      [
+        "#<#{klass_name}",
+        attrs.map {|k,v| " #{k}=#{v.inspect}" unless v.nil? },
+        (" #{append.is_a?(String) ? append.inspect : append}" unless append.nil?),
+        ">"
+      ].flatten.join
+    end
   end
 end

data/lib/dwolla_v2/version.rb

@@ -1,3 +1,3 @@
 module DwollaV2
-  VERSION = "0.4.0"
+  VERSION = "1.0.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dwolla_v2
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Stephen Ausman
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-03-08 00:00:00.000000000 Z
+date: 2016-03-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -66,6 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.22'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -139,11 +153,12 @@ files:
 - lib/dwolla_v2/errors/unsupported_grant_type_error.rb
 - lib/dwolla_v2/errors/unsupported_response_type_error.rb
 - lib/dwolla_v2/errors/validation_error.rb
+- lib/dwolla_v2/middleware/deep_parse_iso8601_response_body.rb
+- lib/dwolla_v2/middleware/deep_super_hasherize_response_body.rb
 - lib/dwolla_v2/middleware/handle_errors.rb
-- lib/dwolla_v2/middleware/parse_iso8601_response_body.rb
-- lib/dwolla_v2/middleware/symbolize_response_body.rb
 - lib/dwolla_v2/portal.rb
 - lib/dwolla_v2/response.rb
+- lib/dwolla_v2/super_hash.rb
 - lib/dwolla_v2/token.rb
 - lib/dwolla_v2/util.rb
 - lib/dwolla_v2/version.rb