armor_payments 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e9ae49ac2caa04bfb73d0346bd9c92b84fe4f0e1
+  data.tar.gz: 29ea37edd11f94a17a774d916313d595aee355ee
+SHA512:
+  metadata.gz: 00d147bcaf1634320188c2baa9a01c1667646a7a44a6dfc863ed1b874069069e649f9b36b426f047fb7d65c932861395e3c1a8f2c9ce601225ee407559ef1624
+  data.tar.gz: 303ddf688969c99d82361b6f53166f3fb969a4640583061a425b6410e4473578e4e69c152027d797bd2d03a9b454f59465e24d5113a3c43b0dbdf417fc8e208d

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

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

data/.ruby-gemset

@@ -0,0 +1 @@
+armor_payments

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.0.0

data/Gemfile

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

data/Guardfile

@@ -0,0 +1,15 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :bundler do
+  watch('Gemfile')
+  watch(/^.+\.gemspec/)
+end
+
+guard :rspec do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+
+end
+

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Matt Wilson
+
+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,115 @@
+# ArmorPayments
+
+This is intended to be a clean, idiomatic client for the [Armor Payments API](http://armorpayments.com/api/index.html). This will handle generating the authenticated headers and constructing the properly nested request URI, as well as parsing any response JSON for you.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'armor_payments'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install armor_payments
+
+## Usage
+
+The Armor Payments API is REST-ish and nested, so the client relies on chaining. We return an `Excon::Response` object, with the added nice-ness that we've parsed the JSON response body for you if possible.
+
+```ruby
+require 'armor_payments'
+
+client = ArmorPayments::API.new 'your-key', 'your-secret', should_use_sandbox
+
+# There are three top-level resources: accounts, users, and orders
+# Querying users and orders requires an account_id
+
+client.accounts.all
+client.accounts.get(account_id)
+
+client.users(account_id).all
+client.users(account_id).get(user_id)
+
+client.orders(account_id).all
+client.orders(account_id).get(order_id)
+
+# From accounts, we chain bank accounts
+
+client.accounts.bankaccounts(account_id).all
+client.accounts.bankaccounts(account_id).get(bank_account_id)
+
+# From orders, many things chain: documents, notes, disputes, shipments, payment instructions, order events
+
+client.orders(account_id).documents(order_id).all
+client.orders(account_id).documents(order_id).get(document_id)
+
+client.orders(account_id).notes(order_id).all
+client.orders(account_id).notes(order_id).get(note_id)
+
+client.orders(account_id).disputes(order_id).all
+client.orders(account_id).disputes(order_id).get(dispute_id)
+
+client.orders(account_id).shipments(order_id).all
+client.orders(account_id).shipments(order_id).get(shipment_id)
+
+client.orders(account_id).paymentinstructions(order_id).all
+
+client.orders(account_id).orderevents(order_id).all
+client.orders(account_id).orderevents(order_id).get(event_id)
+
+# From disputes, further things chain: documents, notes, offers
+
+client.orders(account_id).disputes(order_id).documents(dispute_id).all
+client.orders(account_id).disputes(order_id).documents(dispute_id).get(document_id)
+
+client.orders(account_id).disputes(order_id).notes(dispute_id).all
+client.orders(account_id).disputes(order_id).notes(dispute_id).get(note_id)
+
+client.orders(account_id).disputes(order_id).offers(dispute_id).all
+client.orders(account_id).disputes(order_id).offers(dispute_id).get(offer_id)
+
+# From offers, documents and notes chain
+
+client.orders(account_id).disputes(order_id).offers(dispute_id).
+  documents(offer_id).all
+client.orders(account_id).disputes(order_id).offers(dispute_id).
+  documents(offer_id).get(document_id)
+
+client.orders(account_id).disputes(order_id).offers(dispute_id).
+  notes(offer_id).all
+client.orders(account_id).disputes(order_id).offers(dispute_id).
+  notes(offer_id).get(note_id)
+```
+
+Some of the resource endpoints support Create/Update `POST` operations, and this client aims to support those as well:
+
+```ruby
+client.accounts.create(your_data)
+client.accounts.update(account_id, your_data)
+
+client.accounts.bankaccounts(account_id).create(your_data)
+
+client.orders(account_id).create(your_data)
+
+client.orders(account_id).shipments(order_id).create(your_data)
+
+client.{object-path}.documents.create(your_data)
+
+client.{object-path}.notes.create(your_data)
+
+client.{object-path}.orders.update(order_id, your_data)
+
+client.{object-path}.offers.update(offer_id, your_data)
+```
+
+## Contributing
+
+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

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/armor_payments.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'armor_payments/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "armor_payments"
+  spec.version       = ArmorPayments::VERSION
+  spec.authors       = ["Matt Wilson"]
+  spec.email         = ["mhw@hypomodern.com"]
+  spec.description   = 'Ruby gem for interacting with Armor Payments.'
+  spec.summary       = 'Ruby gem for interacting with Armor Payments.'
+  spec.homepage      = "http://github.com/hypomodern/armor_payments"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency 'bundler', "~> 1.3"
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'guard-rspec'
+  spec.add_development_dependency 'guard-bundler'
+  spec.add_development_dependency 'vcr'
+  spec.add_development_dependency 'timecop'
+
+  spec.add_dependency 'excon'
+end

data/lib/armor_payments.rb

@@ -0,0 +1,5 @@
+require 'armor_payments/version'
+require 'armor_payments/api'
+
+module ArmorPayments
+end

data/lib/armor_payments/api.rb

@@ -0,0 +1,44 @@
+require 'excon'
+require 'json'
+require 'armor_payments/authenticator'
+require 'armor_payments/api/resource'
+require 'armor_payments/api/accounts'
+require 'armor_payments/api/orders'
+require 'armor_payments/api/documents'
+require 'armor_payments/api/notes'
+require 'armor_payments/api/disputes'
+require 'armor_payments/api/offers'
+require 'armor_payments/api/users'
+require 'armor_payments/api/paymentinstructions'
+require 'armor_payments/api/shipments'
+require 'armor_payments/api/orderevents'
+require 'armor_payments/api/bankaccounts'
+
+module ArmorPayments
+  class API
+
+    attr_accessor :authenticator, :sandbox
+
+    def initialize api_key, api_secret, sandbox = false
+      self.authenticator = ArmorPayments::Authenticator.new(api_key, api_secret)
+      self.sandbox = sandbox
+    end
+
+    def armor_host
+      "https://#{sandbox ? 'sandbox' : 'api'}.armorpayments.com"
+    end
+
+    def accounts
+      @accounts ||= ArmorPayments::Accounts.new(armor_host, authenticator, '')
+    end
+
+    def orders account_id
+      ArmorPayments::Orders.new(armor_host, authenticator, accounts.uri(account_id))
+    end
+
+    def users account_id
+      ArmorPayments::Users.new(armor_host, authenticator, accounts.uri(account_id))
+    end
+
+  end
+end

data/lib/armor_payments/api/accounts.rb

@@ -0,0 +1,19 @@
+module ArmorPayments
+  class Accounts < Resource
+
+    def create data
+      headers = authenticator.secure_headers 'post', uri
+      request :post, { path: uri, headers: headers, body: JSON.generate(data) }
+    end
+    
+    def update account_id, data
+      headers = authenticator.secure_headers 'post', uri(account_id)
+      request :post, { path: uri(account_id), headers: headers, body: JSON.generate(data) }
+    end
+
+    def bankaccounts account_id
+      ArmorPayments::BankAccounts.new(host, authenticator, uri(account_id))
+    end
+
+  end
+end

data/lib/armor_payments/api/bankaccounts.rb

@@ -0,0 +1,10 @@
+module ArmorPayments
+  class BankAccounts < Resource
+
+    def create data
+      headers = authenticator.secure_headers 'post', uri
+      request :post, { path: uri, headers: headers, body: JSON.generate(data) }
+    end
+
+  end
+end

data/lib/armor_payments/api/disputes.rb

@@ -0,0 +1,17 @@
+module ArmorPayments
+  class Disputes < Resource
+
+    def documents dispute_id
+      ArmorPayments::Documents.new(host, authenticator, uri(dispute_id))
+    end
+
+    def notes dispute_id
+      ArmorPayments::Notes.new(host, authenticator, uri(dispute_id))
+    end
+
+    def offers dispute_id
+      ArmorPayments::Offers.new(host, authenticator, uri(dispute_id))
+    end
+
+  end
+end

data/lib/armor_payments/api/documents.rb

@@ -0,0 +1,10 @@
+module ArmorPayments
+  class Documents < Resource
+
+    def create data
+      headers = authenticator.secure_headers 'post', uri
+      request :post, { path: uri, headers: headers, body: JSON.generate(data) }
+    end
+
+  end
+end

data/lib/armor_payments/api/notes.rb

@@ -0,0 +1,10 @@
+module ArmorPayments
+  class Notes < Resource
+
+    def create data
+      headers = authenticator.secure_headers 'post', uri
+      request :post, { path: uri, headers: headers, body: JSON.generate(data) }
+    end
+
+  end
+end

data/lib/armor_payments/api/offers.rb

@@ -0,0 +1,18 @@
+module ArmorPayments
+  class Offers < Resource
+
+    def update offer_id, data
+      headers = authenticator.secure_headers 'post', uri(offer_id)
+      request :post, { path: uri(offer_id), headers: headers, body: JSON.generate(data) }
+    end
+
+    def documents offer_id
+      ArmorPayments::Documents.new(host, authenticator, uri(offer_id))
+    end
+
+    def notes offer_id
+      ArmorPayments::Notes.new(host, authenticator, uri(offer_id))
+    end
+
+  end
+end

data/lib/armor_payments/api/orderevents.rb

@@ -0,0 +1,5 @@
+module ArmorPayments
+  class OrderEvents < Resource
+
+  end
+end

data/lib/armor_payments/api/orders.rb

@@ -0,0 +1,39 @@
+module ArmorPayments
+  class Orders < Resource
+
+    def create data
+      headers = authenticator.secure_headers 'post', uri
+      request :post, { path: uri, headers: headers, body: JSON.generate(data) }
+    end
+    
+    def update order_id, data
+      headers = authenticator.secure_headers 'post', uri(order_id)
+      request :post, { path: uri(order_id), headers: headers, body: JSON.generate(data) }
+    end
+
+    def documents order_id
+      ArmorPayments::Documents.new(host, authenticator, uri(order_id))
+    end
+
+    def notes order_id
+      ArmorPayments::Notes.new(host, authenticator, uri(order_id))
+    end
+
+    def disputes order_id
+      ArmorPayments::Disputes.new(host, authenticator, uri(order_id))
+    end
+
+    def orderevents order_id
+      ArmorPayments::OrderEvents.new(host, authenticator, uri(order_id))
+    end
+
+    def paymentinstructions order_id
+      ArmorPayments::PaymentInstructions.new(host, authenticator, uri(order_id))
+    end
+
+    def shipments order_id
+      ArmorPayments::Shipments.new(host, authenticator, uri(order_id))
+    end
+
+  end
+end

data/lib/armor_payments/api/paymentinstructions.rb

@@ -0,0 +1,5 @@
+module ArmorPayments
+  class PaymentInstructions < Resource
+
+  end
+end

data/lib/armor_payments/api/resource.rb

@@ -0,0 +1,44 @@
+module ArmorPayments
+  class Resource
+    attr_accessor :host, :authenticator, :uri_root
+
+    def initialize host, authenticator, uri_root
+      self.host           = host
+      self.authenticator  = authenticator
+      self.uri_root       = uri_root
+    end
+
+    def connection
+      @connection ||= Excon.new(host, headers: { 'Accept' => 'application/json' })
+    end
+
+    def resource_name
+      self.class.to_s.downcase.split('::').last
+    end
+
+    def uri object_id = nil
+      base = "#{uri_root}/#{resource_name}"
+      base += "/#{object_id}" if object_id
+      base
+    end
+
+    # If possible, parse the JSON
+    def request method, params
+      response = connection.send(method, params)
+      if response.get_header('Content-Type') =~ /json/i
+        response.body = JSON.parse response.body
+      end
+      response
+    end
+
+    def all
+      headers = authenticator.secure_headers 'get', uri
+      request :get, { path: uri, headers: headers }
+    end
+
+    def get object_id
+      headers = authenticator.secure_headers 'get', uri(object_id)
+      request :get, { path: uri(object_id), headers: headers }
+    end
+  end
+end

data/lib/armor_payments/api/shipments.rb

@@ -0,0 +1,10 @@
+module ArmorPayments
+  class Shipments < Resource
+
+    def create data
+      headers = authenticator.secure_headers 'post', uri
+      request :post, { path: uri, headers: headers, body: JSON.generate(data) }
+    end
+
+  end
+end

data/lib/armor_payments/api/users.rb

@@ -0,0 +1,10 @@
+module ArmorPayments
+  class Users < Resource
+
+    def update user_id, data
+      headers = authenticator.secure_headers 'post', uri(user_id)
+      request :post, { path: uri(user_id), headers: headers, body: JSON.generate(data) }
+    end
+
+  end
+end

data/lib/armor_payments/authenticator.rb

@@ -0,0 +1,30 @@
+require 'digest/sha2'
+
+module ArmorPayments
+  class Authenticator
+
+    attr_accessor :api_key, :api_secret
+
+    def initialize key, secret
+      self.api_key = key
+      self.api_secret = secret
+    end
+
+    def secure_headers method, uri
+      {
+        'x-armorpayments-apikey'           => api_key,
+        'x-armorpayments-requesttimestamp' => current_timestamp,
+        'x-armorpayments-signature'        => request_signature(method, uri)
+      }
+    end
+
+    def current_timestamp
+      Time.now.utc.iso8601
+    end
+
+    def request_signature method, uri
+      Digest::SHA512.hexdigest "#{api_secret}:#{method.to_s.upcase}:#{uri}:#{current_timestamp}"
+    end
+
+  end
+end

data/lib/armor_payments/version.rb

@@ -0,0 +1,3 @@
+module ArmorPayments
+  VERSION = "0.1.0"
+end

data/spec/armor_payments/api/accounts_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+module ArmorPayments
+  describe Accounts do
+    let(:authenticator) { Authenticator.new('my-api-key', 'my-secret-code') }
+    let(:host) { 'https://sandbox.armorpayments.com' }
+    let(:accounts) { Accounts.new(host, authenticator, '') }
+
+    describe "#uri" do
+      it "returns '/accounts' if given no id" do
+        accounts.uri.should == '/accounts'
+      end
+
+      it "returns '/accounts/:id' if given an id" do
+        accounts.uri(456).should == '/accounts/456'
+      end
+    end
+
+    describe "#create" do
+
+      it "makes POST with /accounts and JSONified data" do
+        accounts.should_receive(:request).with( :post, hash_including(path: '/accounts', body: '{"name":"Bobby Lee"}'))
+        accounts.create({ 'name' => 'Bobby Lee'})
+      end
+
+    end
+
+  end
+end

data/spec/armor_payments/api/disputes_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+module ArmorPayments
+  describe Disputes do
+    let(:authenticator) { Authenticator.new('my-api-key', 'my-secret-code') }
+    let(:host) { 'https://sandbox.armorpayments.com' }
+    let(:disputes) { Disputes.new(host, authenticator, '/accounts/1234/orders/56') }
+
+    describe "#uri" do
+      it "returns '/accounts/:aid/orders/:oid/disputes' if given no id" do
+        disputes.uri.should == '/accounts/1234/orders/56/disputes'
+      end
+
+      it "returns '/accounts/:aid/disputes/:dispute_id' if given an id" do
+        disputes.uri(78).should == '/accounts/1234/orders/56/disputes/78'
+      end
+    end
+
+  end
+end

data/spec/armor_payments/api/documents_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+module ArmorPayments
+  describe Documents do
+    let(:authenticator) { Authenticator.new('my-api-key', 'my-secret-code') }
+    let(:host) { 'https://sandbox.armorpayments.com' }
+    let(:documents) { Documents.new(host, authenticator, '/accounts/123/orders/456') }
+
+    describe "#create" do
+
+      it "makes POST with the right uri and JSONified data" do
+        documents.should_receive(:request).with( :post, hash_including(path: '/accounts/123/orders/456/documents', body: '{"name":"Bobby Lee"}'))
+        documents.create({ 'name' => 'Bobby Lee'})
+      end
+
+    end
+
+  end
+end

data/spec/armor_payments/api/notes_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+module ArmorPayments
+  describe Notes do
+    let(:authenticator) { Authenticator.new('my-api-key', 'my-secret-code') }
+    let(:host) { 'https://sandbox.armorpayments.com' }
+    let(:notes) { Notes.new(host, authenticator, '/accounts/123/orders/456') }
+
+    describe "#create" do
+
+      it "makes POST with the right uri and JSONified data" do
+        notes.should_receive(:request).with( :post, hash_including(path: '/accounts/123/orders/456/notes', body: '{"name":"Bobby Lee"}'))
+        notes.create({ 'name' => 'Bobby Lee'})
+      end
+
+    end
+
+  end
+end

data/spec/armor_payments/api/offers_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+module ArmorPayments
+  describe Offers do
+    let(:authenticator) { Authenticator.new('my-api-key', 'my-secret-code') }
+    let(:host) { 'https://sandbox.armorpayments.com' }
+    let(:offers) { Offers.new(host, authenticator, '/accounts/1234') }
+
+    describe "#update" do
+      it "makes POST with the right uri and JSONified data" do
+        offers.should_receive(:request).with(
+          :post,
+          hash_including(path: '/accounts/1234/offers/90', body: '{"name":"Bobby Lee"}')
+        )
+        offers.update(90, { 'name' => 'Bobby Lee'})
+      end
+    end
+
+  end
+end

data/spec/armor_payments/api/orders_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+module ArmorPayments
+  describe Orders do
+    let(:authenticator) { Authenticator.new('my-api-key', 'my-secret-code') }
+    let(:host) { 'https://sandbox.armorpayments.com' }
+    let(:orders) { Orders.new(host, authenticator, '/accounts/1234') }
+
+    describe "#uri" do
+      it "returns '/accounts/:aid/orders' if given no id" do
+        orders.uri.should == '/accounts/1234/orders'
+      end
+
+      it "returns '/accounts/:aid/orders/:order_id' if given an id" do
+        orders.uri(456).should == '/accounts/1234/orders/456'
+      end
+    end
+
+    describe "#update" do
+      it "makes POST with the right uri and JSONified data" do
+        orders.should_receive(:request).with(
+          :post,
+          hash_including(path: '/accounts/1234/orders/90', body: '{"name":"Bobby Lee"}')
+        )
+        orders.update(90, { 'name' => 'Bobby Lee'})
+      end
+    end
+
+  end
+end

data/spec/armor_payments/api/resource_spec.rb

@@ -0,0 +1,78 @@
+require 'spec_helper'
+
+module ArmorPayments
+  describe Resource do
+    let(:authenticator) { Authenticator.new('my-api-key', 'my-secret-code') }
+    let(:host) { 'https://sandbox.armorpayments.com' }
+    let(:uri_root) { '/wibble/123' }
+    let(:resource) { Resource.new(host, authenticator, uri_root) }
+    let(:successful_response) { Excon::Response.new(status: 200, body: '{"whee":42}', headers: { 'Content-Type' => 'application/json' }) }
+
+    describe "#uri" do
+      it "returns '/%{uri_root}/resource_name' if given no id" do
+        resource.uri.should == '/wibble/123/resource'
+      end
+
+      it "returns '/%{uri_root}/resource_name/:id' if given an id" do
+        resource.uri(456).should == '/wibble/123/resource/456'
+      end
+    end
+
+    describe "#request" do
+      context "on a response with a JSON body" do
+        it "returns the parsed JSON body" do
+          resource.connection.stub(:get).and_return(successful_response)
+          response = resource.request('get', {})
+          response.body.should == { 'whee' => 42 }
+        end
+      end
+
+      context "on a response without JSON" do
+        it "returns the full response object" do
+          failed_response = Excon::Response.new(status: 502, body: 'Gateway Timeout')
+          resource.connection.stub(:get).and_return(failed_response)
+          response = resource.request('get', {})
+          response.body.should == 'Gateway Timeout'
+        end
+      end
+    end
+
+    context "smoketest" do
+      describe "#all" do
+        it "queries the host for all of the resources, with approprate headers" do
+          Timecop.freeze(2014, 2, 22, 12, 0, 0) do
+            resource.connection.should_receive(:get).with({
+              path: '/wibble/123/resource',
+              headers: {
+                "X_ARMORPAYMENTS_APIKEY"            => "my-api-key",
+                "X_ARMORPAYMENTS_REQUESTTIMESTAMP"  => "2014-02-22T17:00:00Z",
+                "X_ARMORPAYMENTS_SIGNATURE"         => "ec41629dc204b449c71bf89d1be4630f5353e37869197f5a926539f6fc676ebcccdb5426fb3f01a01fa7dc9551d38d152e41294a5147b15e460d09ff60cf1562"
+              }
+            }).and_return(successful_response)
+
+            resource.all
+          end
+        end
+      end
+
+      describe "#get" do
+        it "queries the host for a specific resource, with approprate headers" do
+          Timecop.freeze(2014, 2, 22, 12, 0, 0) do
+            resource.connection.should_receive(:get).with({
+              path: '/wibble/123/resource/456',
+              headers: {
+                "X_ARMORPAYMENTS_APIKEY"            => "my-api-key",
+                "X_ARMORPAYMENTS_REQUESTTIMESTAMP"  => "2014-02-22T17:00:00Z",
+                "X_ARMORPAYMENTS_SIGNATURE"         => "48886620cfebb95ffd9ee351f4f68d4f103a8f4bdc0e3301f7ee709ec2cf3c19588ae1b67aa8ee38305de802651fb10093cf1af40f467ac936185d551a58a844"
+              }
+            }).and_return(successful_response)
+
+            resource.get(456)
+          end
+        end
+      end
+
+    end
+
+  end
+end

data/spec/armor_payments/api/users_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+module ArmorPayments
+  describe Users do
+    let(:authenticator) { Authenticator.new('my-api-key', 'my-secret-code') }
+    let(:host) { 'https://sandbox.armorpayments.com' }
+    let(:users) { Users.new(host, authenticator, '/accounts/1234') }
+
+    describe "#uri" do
+      it "returns '/users' if given no id" do
+        users.uri.should == '/accounts/1234/users'
+      end
+
+      it "returns '/users/:id' if given an id" do
+        users.uri(456).should == '/accounts/1234/users/456'
+      end
+    end
+
+  end
+end

data/spec/armor_payments/api_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+module ArmorPayments
+  describe API do
+    let(:client) { ArmorPayments::API.new('my-key', 'my-secret', true) }
+
+    describe "#armor_host" do
+      context "in sandbox mode" do
+        it "returns https://sandbox.armorpayments.com" do
+          client.sandbox.should be_true
+          client.armor_host.should == "https://sandbox.armorpayments.com"
+        end
+      end
+
+      context "*not* in sandbox mode" do
+        it "returns https://api.armorpayments.com" do
+          client.sandbox = false
+          client.armor_host.should == "https://api.armorpayments.com"
+        end
+      end
+    end
+
+  end
+end

data/spec/armor_payments/authenticator_spec.rb

@@ -0,0 +1,51 @@
+require 'spec_helper'
+require 'armor_payments/authenticator'
+
+module ArmorPayments
+  describe Authenticator do
+    let(:authenticator) { Authenticator.new('my-api-key', 'my-secret-code') }
+
+    describe "#current_timestamp" do
+      it "returns the current time in iso8601 format" do
+        Timecop.freeze(2014, 2, 22, 12, 0, 0) do
+          authenticator.current_timestamp.should == '2014-02-22T17:00:00Z'
+        end
+      end
+    end
+
+    describe "#request_signature" do
+      it "hands a concatenated string encompassing the secret, request method, uri, and date to the digest service" do
+        Timecop.freeze(2014, 2, 22, 12, 0, 0) do
+          the_beast = "#{authenticator.api_secret}:GET:/accounts:#{authenticator.current_timestamp}"
+          Digest::SHA512.should_receive(:hexdigest).with(the_beast)
+          authenticator.request_signature('get', '/accounts')
+        end
+      end
+
+      it "returns a SHA512 hash value" do
+        Timecop.freeze(2014, 2, 22, 12, 0, 0) do
+          authenticator.request_signature("get", "/accounts").should ==
+            "777990373678937074c1b357d632e0ea3439d0e834e573c03076ee557f526565f9ac2b38483b3e41024b96ec2644d60b4f70f0d9c760b2ebeb9827f9b335d069"
+        end
+      end
+    end
+
+    describe "#secure_headers" do
+      it "returns a hash with the required headers in" do
+        required_headers = %w( X_ARMORPAYMENTS_APIKEY X_ARMORPAYMENTS_REQUESTTIMESTAMP X_ARMORPAYMENTS_SIGNATURE )
+        authenticator.secure_headers('get', '/accounts').keys.sort.should == required_headers.sort
+      end
+
+      it "assigns the correct value for each of the headers" do
+        Timecop.freeze(2014, 2, 22, 12, 0, 0) do
+          authenticator.secure_headers('get', '/accounts').should == {
+            "X_ARMORPAYMENTS_APIKEY"            => "my-api-key",
+            "X_ARMORPAYMENTS_SIGNATURE"         => "777990373678937074c1b357d632e0ea3439d0e834e573c03076ee557f526565f9ac2b38483b3e41024b96ec2644d60b4f70f0d9c760b2ebeb9827f9b335d069",
+            "X_ARMORPAYMENTS_REQUESTTIMESTAMP"  => "2014-02-22T17:00:00Z"
+          }
+        end
+      end
+    end
+
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+require 'armor_payments'
+require 'timecop'
+require 'vcr'
+
+Timecop.safe_mode = true
+
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end
+
+VCR.configure do |c|
+  c.cassette_library_dir     = 'spec/cassettes'
+  c.hook_into                :excon
+  c.default_cassette_options = { record: :new_episodes }
+  c.configure_rspec_metadata!
+end

metadata

@@ -0,0 +1,204 @@
+--- !ruby/object:Gem::Specification
+name: armor_payments
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Matt Wilson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-11-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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'
+- !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'
+- !ruby/object:Gem::Dependency
+  name: guard-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'
+- !ruby/object:Gem::Dependency
+  name: guard-bundler
+  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'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  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'
+- !ruby/object:Gem::Dependency
+  name: timecop
+  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'
+- !ruby/object:Gem::Dependency
+  name: excon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby gem for interacting with Armor Payments.
+email:
+- mhw@hypomodern.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .ruby-gemset
+- .ruby-version
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- armor_payments.gemspec
+- lib/armor_payments.rb
+- lib/armor_payments/api.rb
+- lib/armor_payments/api/accounts.rb
+- lib/armor_payments/api/bankaccounts.rb
+- lib/armor_payments/api/disputes.rb
+- lib/armor_payments/api/documents.rb
+- lib/armor_payments/api/notes.rb
+- lib/armor_payments/api/offers.rb
+- lib/armor_payments/api/orderevents.rb
+- lib/armor_payments/api/orders.rb
+- lib/armor_payments/api/paymentinstructions.rb
+- lib/armor_payments/api/resource.rb
+- lib/armor_payments/api/shipments.rb
+- lib/armor_payments/api/users.rb
+- lib/armor_payments/authenticator.rb
+- lib/armor_payments/version.rb
+- spec/armor_payments/api/accounts_spec.rb
+- spec/armor_payments/api/disputes_spec.rb
+- spec/armor_payments/api/documents_spec.rb
+- spec/armor_payments/api/notes_spec.rb
+- spec/armor_payments/api/offers_spec.rb
+- spec/armor_payments/api/orders_spec.rb
+- spec/armor_payments/api/resource_spec.rb
+- spec/armor_payments/api/users_spec.rb
+- spec/armor_payments/api_spec.rb
+- spec/armor_payments/authenticator_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/hypomodern/armor_payments
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.2
+signing_key: 
+specification_version: 4
+summary: Ruby gem for interacting with Armor Payments.
+test_files:
+- spec/armor_payments/api/accounts_spec.rb
+- spec/armor_payments/api/disputes_spec.rb
+- spec/armor_payments/api/documents_spec.rb
+- spec/armor_payments/api/notes_spec.rb
+- spec/armor_payments/api/offers_spec.rb
+- spec/armor_payments/api/orders_spec.rb
+- spec/armor_payments/api/resource_spec.rb
+- spec/armor_payments/api/users_spec.rb
+- spec/armor_payments/api_spec.rb
+- spec/armor_payments/authenticator_spec.rb
+- spec/spec_helper.rb