bandcampbx 0.1.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NDUxODJjY2FlZGE0NGU5ODBiYmQ0NjU5MDFkNjgwOWZlMTYzOTkxMw==
+  data.tar.gz: !binary |-
+    MjcxNjQyNjYwNDg3MjRlMzExZTYyMDk1YWFkMGQ5N2VlMzAwZTRjOA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    OTU2YmJlNTMxYTU1NDE3YjY5NDMwZWUxYTBhMzcxMjYwZDA1OGQ4ZWY4MDYw
+    MDkyZTA2ZjcwM2VkYzc2MjdjM2JhNTc3MTMwYzZkNWM4ZjE0NGY0MWI2MjA2
+    ZTNkMDU2M2IxOGYyYjc5M2MzZjVjNTNlOWVkNjhiNjBkMzFhMGQ=
+  data.tar.gz: !binary |-
+    MjZjODJjNzVmZTJjMzZiMzgwZmQwNTc2MDg2ODI1ZjM4NjZkZTNjNzhkYmY2
+    YjAyNWFkOThkZWNhY2RmMDVmZjUzNzM3ODI5ZWM0N2UwZDlmZjgzMjc5OWFk
+    ZGY1ZTUzOGY1MjQ5YWY3NGNjMTNmMTNmMDZkYzYyNTIzYTRkYjM=

data/.gitignore

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

data/.rspec

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

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.9.3@bandcampbx --create

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in bandcampbx.gemspec
+gemspec
+
+group :test do
+  gem 'coveralls', require: false
+end

data/LICENSE.md

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Seth Messer
+
+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,17 @@
+#BandCampBX
+
+BandCampBX is a gem for accessing CampBX's Private API
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'bandcampbx', github: 'megalithic/bandcampbx'
+
+And then execute:
+
+    $ bundle
+
+## License
+
+This software is licensed under [the MIT License.](./LICENSE.md)

data/Rakefile

@@ -0,0 +1,13 @@
+begin
+require 'bundler/setup'
+rescue LoadError
+puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bandcampbx.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bandcampbx/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "bandcampbx"
+  spec.version       = BandCampBX::VERSION
+  spec.authors       = ["Seth Messer"]
+  spec.email         = ["seth.messer@gmail.com"]
+  spec.description   = %q{This is a client library for the CampBX API that supports instantiating multiple clients in the same process.}
+  spec.summary       = %q{Outstanding CampBX library.}
+  spec.homepage      = "http://github.com/megalithic/bandcampbx"
+  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_dependency 'net-http-persistent'
+  spec.add_dependency 'multi_json'
+  spec.add_dependency 'json_pure'
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec", '2.14.0.rc1'
+  spec.add_development_dependency "fakeweb"
+  spec.add_development_dependency "pry"
+end

data/lib/bandcampbx.rb

@@ -0,0 +1,14 @@
+require_relative './bandcampbx/version'
+require_relative './bandcampbx/client'
+require 'multi_json'
+require 'json'
+
+module BandCampBX
+  class StandardError < ::StandardError; end
+
+  module Helpers
+    def self.json_parse(string)
+      MultiJson.load(string)
+    end
+  end
+end

data/lib/bandcampbx/client.rb

@@ -0,0 +1,60 @@
+require_relative 'net'
+require_relative 'mapper'
+require 'bigdecimal/util'
+
+module BandCampBX
+  class Client
+    attr_accessor :key
+    attr_accessor :secret
+
+    def initialize(key = nil, secret = nil)
+      @key    = key
+      @secret = secret
+    end
+
+    def balance
+      mapper.map_balance(net.post("myfunds.php"))
+    end
+
+    def orders
+      mapper.map_orders(net.post("myorders.php"))
+    end
+
+    def buy!(quantity, price, order_type)
+      trade!("tradeenter.php", quantity, price, order_type)
+    end
+
+    def sell!(quantity, price, order_type)
+      trade!("tradeenter.php", quantity, price, order_type)
+    end
+
+    def cancel(id, type)
+      wrapping_standard_error do
+        mapper.map_cancel(net.post("tradecancel.php", { id: id.to_s, type: type.to_s }))
+      end
+    end
+
+    private
+    def net
+      @net ||= Net.new(self)
+    end
+
+    def mapper
+      @mapper ||= Mapper.new
+    end
+
+    def trade!(endpoint, quantity, price, order_type)
+      wrapping_standard_error do
+        mapper.map_order(net.post(endpoint, { price: price.to_digits, quantity: quantity.to_digits, order_type: order_type.to_s }))
+      end
+    end
+
+    def wrapping_standard_error &block
+      begin
+        yield
+      rescue ::StandardError => e
+        raise BandCampBX::StandardError.new(e.message)
+      end
+    end
+  end
+end

data/lib/bandcampbx/entities/balance.rb

@@ -0,0 +1,21 @@
+require_relative './base'
+
+module BandCampBX
+  module Entities
+    class Balance < Base
+      def self.mappings
+        {
+          usd_balance: map_decimal,
+          btc_balance: map_decimal,
+          usd_reserved: map_decimal,
+          btc_reserved: map_decimal,
+          usd_available: map_decimal,
+          btc_available: map_decimal,
+          fee: map_decimal
+        }
+      end
+
+      setup_readers
+    end
+  end
+end

data/lib/bandcampbx/entities/base.rb

@@ -0,0 +1,58 @@
+require 'bigdecimal'
+
+module BandCampBX
+  module Entities
+    class Base
+      def self.setup_readers
+        keys.each {|k| attr_reader k.to_sym }
+      end
+
+      def self.keys
+        self.mappings.keys
+      end
+
+      def initialize(hash)
+        check_for_errors(hash)
+        map_instance_variables(hash)
+      end
+
+      def inspect
+        inspect_string = "#<#{self.class}:#{self.object_id} "
+        self.class.keys.each do |key|
+          inspect_string << "#{key}: #{send(key).inspect} "
+        end
+        inspect_string << " >"
+        inspect_string
+      end
+
+      def self.map_time
+        ->(val) { Time.parse(val) }
+      end
+
+      def self.map_int
+        ->(val) { val.to_i }
+      end
+
+      def self.map_decimal
+        ->(val) { BigDecimal(val) }
+      end
+
+      private
+      def map_instance_variables(hash)
+        self.class.keys.each do |key|
+          instance_variable_set("@#{key}", self.class.mappings[key].call(hash[key.to_s].to_s))
+        end
+      end
+
+      def check_for_errors(hash)
+        if hash.has_key?("error")
+          if hash["error"].has_key?("__all__")
+            raise BandCampBX::StandardError.new(hash["error"]["__all__"].join(".  "))
+          else
+            raise BandCampBX::StandardError.new("CampBX API Error #404")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bandcampbx/entities/order.rb

@@ -0,0 +1,34 @@
+require_relative './base'
+
+module BandCampBX
+  module Entities
+    class Order < Base
+      class InvalidTypeError < StandardError; end
+
+      def self.map_type
+        ->(val) do
+          case val.to_s
+          when '0'
+            :buy
+          when '1'
+            :sell
+          else
+            raise InvalidTypeError
+          end
+        end
+      end
+
+      def self.mappings
+        {
+          id: map_int,
+          datetime: map_time,
+          type: map_type,
+          price: map_decimal,
+          amount: map_decimal
+        }
+      end
+
+      setup_readers
+    end
+  end
+end

data/lib/bandcampbx/mapper.rb

@@ -0,0 +1,37 @@
+require_relative './entities/balance'
+require_relative './entities/order'
+
+module BandCampBX
+  class Mapper
+    def initialize
+    end
+
+    def map_balance(json)
+      Entities::Balance.new(parsed(json))
+    end
+
+    def map_orders(json)
+      parsed(json).map{|o| map_order(o) }
+    end
+
+    def map_order(order)
+      Entities::Order.new(parsed(order))
+    end
+
+    def map_cancel(result)
+      parsed(result) == 'true'
+    end
+
+    private
+    # Allow passing either a String or anything else in.  If it's not a string,
+    # we assume we've already parsed it and just give it back to you.  This
+    # allows us to handle things like collections more easily.
+    def parsed(json)
+      if(json.is_a?(String))
+        BandCampBX::Helpers.json_parse(json)
+      else
+        json
+      end
+    end
+  end
+end

data/lib/bandcampbx/net.rb

@@ -0,0 +1,56 @@
+require 'net/http/persistent'
+
+module BandCampBX
+  class Net
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    def secret
+      client.secret
+    end
+
+    def key
+      client.key
+    end
+
+    def post(endpoint, options={})
+      raw_post(endpoint, options)
+      # map_response(raw_post(endpoint, options))
+    end
+
+    private
+    def url_for(endpoint)
+      base_url + endpoint
+    end
+
+    def base_url
+      'https://campbx.com/api/'
+    end
+
+    def auth_options
+      {
+        user: key,
+        pass: secret
+      }
+    end
+
+    # # For some crazy reason, CampBX is returning ruby hash strings rather than
+    # # JSON objects right now ಠ_ಠ  I'm just going to gsub '=>' to ':' to 'solve'
+    # # it for now.  Not thrilled with this.
+    # def map_response(wish_this_were_reliably_json)
+    #   wish_this_were_reliably_json.gsub('=>', ':')
+    # end
+
+    def raw_post(endpoint, options)
+      uri = URI url_for(endpoint)
+      http = ::Net::HTTP::Persistent.new 'bandcampbx'
+      post = ::Net::HTTP::Post.new uri.path
+      post.set_form_data options.merge(auth_options)
+      http.request(uri, post).body
+    end
+  end
+end
+

data/lib/bandcampbx/version.rb

@@ -0,0 +1,3 @@
+module BandCampBX
+  VERSION = "0.1.1"
+end

data/spec/integration/client_spec.rb

@@ -0,0 +1,105 @@
+require_relative '../spec_helper'
+
+describe "Integrating a client" do
+  subject{ Client.new }
+
+  before do
+    subject.secret = '1'
+    subject.key = '2'
+  end
+
+  it "handles #balance" do
+    example_balance = <<-JSON
+      {
+        "usd_balance": "12.34",
+        "btc_balance": "23.45",
+        "usd_reserved": "1.11",
+        "btc_reserved": "2.22",
+        "usd_available": "11.23",
+        "btc_available": "21.23",
+        "fee": "0.5"
+      }
+    JSON
+
+    FakeWeb.register_uri(:post, "https://campbx.com/api/myfunds.php", body: example_balance)
+
+    bal = subject.balance
+    expect(bal.usd_balance).to eq(BigDecimal('12.34'))
+  end
+
+  it "handles #orders" do
+    example_orders = <<-JSON
+      [
+        {
+          "id": "1",
+          "datetime": "1234567",
+          "type": 0,
+          "price": "12.34",
+          "quantity": "100"
+        }
+      ]
+    JSON
+
+    FakeWeb.register_uri(:post, "https://campbx.com/api/myorders.php", body: example_orders)
+
+    orders = subject.orders
+    expect(orders[0].type).to eq(:buy)
+  end
+
+  context "handling #buy!" do
+    it "succeeds properly" do
+      example_buy_response = <<-JSON
+        {
+          "id": "1",
+          "datetime": "1234567",
+          "type": "0",
+          "price": "12.34",
+          "quantity": "100"
+        }
+      JSON
+
+      FakeWeb.register_uri(:post, "https://campbx.com/api/tradeenter.php", body: example_buy_response)
+
+      buy = subject.buy!(BigDecimal('1'), BigDecimal('100'), "QuickBuy")
+      expect(buy.type).to eq(:buy)
+    end
+
+    it "fails properly" do
+      example_buy_response = <<-JSON
+        {"error":{"__all__":["Minimum order quantity is 0.1"]}}
+      JSON
+
+      FakeWeb.register_uri(:post, "https://campbx.com/api/tradeenter.php", body: example_buy_response)
+
+      expect{ subject.buy!(BigDecimal('0.01'), BigDecimal('100'), 'QuickBuy') }.to raise_error(BandCampBX::StandardError, "Minimum order quantity is 0.1")
+    end
+  end
+
+  it "handles #sell!" do
+    example_sell_response = <<-JSON
+      {
+        "id": "1",
+        "datetime": "1234567",
+        "type": "1",
+        "price": "12.34",
+        "quantity": "100"
+      }
+    JSON
+
+    FakeWeb.register_uri(:post, "https://campbx.com/api/tradeenter.php", body: example_sell_response)
+
+    sell = subject.sell!(BigDecimal('1'), BigDecimal('100'), "QuickSell")
+    expect(sell.type).to eq(:sell)
+  end
+
+  it "handles #cancel" do
+    example_cancel_response = <<-JSON
+      "true"
+    JSON
+
+    FakeWeb.register_uri(:post, "https://campbx.com/api/tradecancel.php", body: example_cancel_response)
+
+    cancel = subject.cancel(12345, "Buy")
+    expect(cancel).to eq(true)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+require 'coveralls'
+Coveralls.wear!
+
+require 'rspec'
+require 'rspec/autorun'
+require 'bundler'
+Bundler.setup
+
+require 'fakeweb'
+FakeWeb.allow_net_connect = %r[coveralls\.io] # Only allow the coveralls api call through
+
+require 'multi_json'
+def json_parse(string)
+  MultiJson.load(string)
+end
+
+require 'pry'
+
+require_relative '../lib/bandcampbx'
+include BandCampBX

data/spec/unit/bandcampbx/client_spec.rb

@@ -0,0 +1,139 @@
+require_relative '../../spec_helper'
+
+describe BandCampBX::Client do
+  subject(:client) { described_class.new }
+  let(:net){ client.send(:net) }
+  let(:mapper){ client.send(:mapper) }
+
+  before do
+    client.key = '1'
+    client.secret = '2'
+  end
+
+  describe '#initialize' do
+    it 'does not require any initial parameters' do
+      expect { described_class.new }.not_to raise_error
+    end
+
+    it 'allows specifying key/secret on initialize' do
+      client = described_class.new('KEY', 'SECRET')
+
+      expect(client.key).to eql('KEY')
+      expect(client.secret).to eql('SECRET')
+    end
+  end
+
+  describe '#balance' do
+    let(:api_balance_response){ double }
+    let(:balance_object){ double }
+
+    before do
+      net.stub(:post).and_return(api_balance_response)
+      mapper.stub(:map_balance).and_return(balance_object)
+      client.balance
+    end
+
+    it 'requests the balance from the API' do
+      expect(net).to have_received(:post).with('myfunds.php')
+    end
+
+    it 'maps the API response to a Balance object' do
+      expect(mapper).to have_received(:map_balance).with(api_balance_response)
+    end
+
+    it 'returns the mapped object' do
+      expect(client.balance).to eq(balance_object)
+    end
+  end
+
+  describe '#orders' do
+    let(:api_orders_response){ double }
+    let(:order_object){ double }
+
+    before do
+      net.stub(:post).and_return(api_orders_response)
+      mapper.stub(:map_orders).and_return([order_object])
+      client.orders
+    end
+
+    it 'requests open orders from the API' do
+      expect(net).to have_received(:post).with('myorders.php')
+    end
+
+    it 'maps the API response to an array of Order objects' do
+      expect(mapper).to have_received(:map_orders).with(api_orders_response)
+    end
+  end
+
+  describe 'buy!' do
+    let(:api_buy_response){ double }
+    let(:order_object){ double }
+
+    before do
+      net.stub(:post).and_return(api_buy_response)
+      mapper.stub(:map_order).and_return(order_object)
+    end
+
+    it 'submits a buy order to the API' do
+      client.buy!(BigDecimal('100'), BigDecimal('1'), "QuickBuy")
+      expect(net).to have_received(:post).with('tradeenter.php', { quantity: '100.0', price: '1.0', order_type: 'QuickBuy' })
+    end
+
+    it 'maps the API response to an Order object' do
+      client.buy!(BigDecimal('100'), BigDecimal('1'), "QuickBuy")
+      expect(mapper).to have_received(:map_order).with(api_buy_response)
+    end
+
+    it 'wraps exceptions in its own class' do
+      net.stub(:post).and_raise(StandardError)
+      expect{ client.buy!(BigDecimal('100'), BigDecimal('1'), "QuickBuy") }.to raise_error(BandCampBX::StandardError)
+    end
+  end
+
+  describe 'sell!' do
+    let(:api_sell_response){ double }
+    let(:order_object){ double }
+
+    before do
+      net.stub(:post).and_return(api_sell_response)
+      mapper.stub(:map_order).and_return(order_object)
+      client.sell!(BigDecimal('100'), BigDecimal('1'), "QuickSell")
+    end
+
+    it 'submits a sell order to the API' do
+      expect(net).to have_received(:post).with('tradeenter.php', { quantity: '100.0', price: '1.0', order_type: 'QuickSell' })
+    end
+
+    it 'maps the API response to an Order object' do
+      expect(mapper).to have_received(:map_order).with(api_sell_response)
+    end
+
+    it 'wraps exceptions in its own class' do
+      net.stub(:post).and_raise(StandardError)
+      expect{ client.sell!(BigDecimal('100'), BigDecimal('1'), "QuickSell") }.to raise_error(BandCampBX::StandardError)
+    end
+  end
+
+  describe 'cancel' do
+    let(:api_cancel_response){ double }
+
+    before do
+      net.stub(:post).and_return(api_cancel_response)
+      mapper.stub(:map_cancel).and_return(true)
+      client.cancel(1234, "Buy")
+    end
+
+    it 'submits a cancel order to the API' do
+      expect(net).to have_received(:post).with('tradecancel.php', { id: '1234', type: 'Buy' })
+    end
+
+    it 'maps the API response to a boolean' do
+      expect(mapper).to have_received(:map_cancel).with(api_cancel_response)
+    end
+
+    it 'wraps exceptions in its own class' do
+      net.stub(:post).and_raise(StandardError)
+      expect{ client.cancel(123, "Buy") }.to raise_error(BandCampBX::StandardError)
+    end
+  end
+end

data/spec/unit/bandcampbx/entities/balance_spec.rb

@@ -0,0 +1,48 @@
+require_relative '../../../spec_helper'
+
+describe BandCampBX::Entities::Balance do
+  let(:balance_hash){
+    {
+      "usd_balance" => "111.12",
+      "btc_balance" => "211.23",
+      "usd_reserved" => "1.20",
+      "btc_reserved" => "2.30",
+      "usd_available" => "5.50",
+      "btc_available" => "6.60",
+      "fee" => "1.11"
+    }
+  }
+  subject(:balance) { described_class.new(balance_hash) }
+
+  it "has a usd_balance" do
+    expect(balance.usd_balance).to eq(BigDecimal('111.12'))
+  end
+
+  it "has a btc_balance" do
+    expect(balance.btc_balance).to eq(BigDecimal('211.23'))
+  end
+
+  it "has a usd_reserved" do
+    expect(balance.usd_reserved).to eq(BigDecimal('1.20'))
+  end
+
+  it "has a btc_reserved" do
+    expect(balance.btc_reserved).to eq(BigDecimal('2.30'))
+  end
+
+  it "has a usd_available" do
+    expect(balance.usd_available).to eq(BigDecimal('5.50'))
+  end
+
+  it "has a btc_available" do
+    expect(balance.btc_available).to eq(BigDecimal('6.60'))
+  end
+
+  it "has a fee" do
+    expect(balance.fee).to eq(BigDecimal('1.11'))
+  end
+
+  it "can be inspected" do
+    expect { balance.inspect }.to_not raise_error
+  end
+end

data/spec/unit/bandcampbx/entities/order_spec.rb

@@ -0,0 +1,68 @@
+require_relative '../../../spec_helper'
+
+describe BandCampBX::Entities::Order do
+  subject{ described_class.new(order_hash) }
+
+  context "a successful order" do
+    let(:order_hash){
+      {
+        "id" => "1",
+        "datetime" => 1234567,
+        "type" => 0,
+        "price" => "1.23",
+        "amount" => "10"
+      }
+    }
+
+    it "has an id" do
+      expect(subject.id).to eq(1)
+    end
+
+    describe "type" do
+      it "maps 0 to :buy" do
+        expect(subject.type).to eq(:buy)
+      end
+
+      it "maps 1 to :sell" do
+        order = described_class.new(order_hash.merge({"type" => 1}))
+        expect(order.type).to eq(:sell)
+      end
+
+      it "raises InvalidTypeError for other values" do
+        expect { described_class.new(order_hash.merge({"type" => 2})) }.to raise_error(BandCampBX::Entities::Order::InvalidTypeError)
+      end
+    end
+  end
+
+  context "an unsuccessful order" do
+    context "with an __all__ key" do
+      let(:order_hash){
+        # Don't get mad at me, not my fault CampBX errors look like this
+        {
+          "error" => {
+            "__all__" => ["Minimum order size is $1"]
+          }
+        }
+      }
+
+      it "raises an appropriate error" do
+        expect{ subject }.to raise_error(BandCampBX::StandardError, "Minimum order size is $1")
+      end
+    end
+
+    context "without an __all__ key" do
+      let(:order_hash){
+        # Don't get mad at me, not my fault CampBX errors look like this
+        {
+          "error" => {
+            "neg" => ["Minimum order size is $1"]
+          }
+        }
+      }
+
+      it "raises an appropriate error" do
+        expect{ subject }.to raise_error(BandCampBX::StandardError, "CampBX API Error #404")
+      end
+    end
+  end
+end

data/spec/unit/bandcampbx/mapper_spec.rb

@@ -0,0 +1,44 @@
+require_relative '../../spec_helper'
+
+describe BandCampBX::Mapper do
+  subject(:mapper) { described_class.new }
+  let(:json_object){ '{"foo": "bar"}' }
+  let(:json_array){ '[{"foo": "bar"}]' }
+
+  describe '#map_balance' do
+    let(:balance) { double }
+
+    before do
+      Entities::Balance.stub(:new).and_return(balance)
+    end
+
+    it "maps a balance API response into a Balance entity" do
+      mapper.map_balance(json_object)
+      expect(Entities::Balance).to have_received(:new).with(json_parse(json_object))
+    end
+
+    it "returns the mapped Balance entity" do
+      expect(mapper.map_balance(json_object)).to eq(balance)
+    end
+  end
+
+  describe '#map_orders' do
+    let(:order) { double }
+
+    before do
+      Entities::Order.stub(:new).and_return(order)
+    end
+
+    it "maps an open_orders API response into an array of Order entities" do
+      mapper.map_orders(json_array)
+      expect(Entities::Order).to have_received(:new).with(json_parse(json_array)[0])
+    end
+  end
+
+  describe '#map_cancel' do
+    it "maps a cancel API response to a boolean" do
+      expect(mapper.map_cancel('"true"')).to eq(true)
+      expect(mapper.map_cancel('"false"')).to eq(false)
+    end
+  end
+end

data/spec/unit/bandcampbx/net_spec.rb

@@ -0,0 +1,43 @@
+require_relative '../../spec_helper'
+
+describe BandCampBX::Net do
+  let(:client){ double }
+  subject(:net) { described_class.new(client) }
+
+  before do
+    client.stub(:secret).and_return(1)
+    client.stub(:key).and_return(2)
+  end
+
+  it 'gets instantiated with a client' do
+    expect(net.client).to eq(client)
+  end
+
+  it 'defers to its client for secret' do
+    expect(net.secret).to eq(1)
+  end
+
+  it 'defers to its client for key' do
+    expect(net.key).to eq(2)
+  end
+
+  describe '#post' do
+    describe 'any_endpoint' do
+      let(:example_balance) do
+        <<-JSON
+          {
+            "foo": "bar"
+          }
+        JSON
+      end
+
+      before do
+        FakeWeb.register_uri(:post, "https://campbx.com/api/myfunds.php", body: example_balance)
+      end
+
+      it "queries the appropriate endpoint and returns its body as a string" do
+        expect(json_parse(net.post('myfunds.php'))).to eq(json_parse(example_balance))
+      end
+    end
+  end
+end

data/spec/unit/bandcampbx_spec.rb

@@ -0,0 +1,13 @@
+require_relative '../spec_helper'
+
+describe BandCampBX do
+  it "should be an instance rather than a singleton" do
+    client = BandCampBX::Client.new
+    expect(client.key).to eq(nil)
+    expect(client.secret).to eq(nil)
+    client.key = '1'
+    client.secret = '2'
+    expect(client.key).to eq('1')
+    expect(client.secret).to eq('2')
+  end
+end

data/travis.yml

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

metadata

@@ -0,0 +1,190 @@
+--- !ruby/object:Gem::Specification
+name: bandcampbx
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Seth Messer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-http-persistent
+  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'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  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'
+- !ruby/object:Gem::Dependency
+  name: json_pure
+  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'
+- !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: 2.14.0.rc1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.14.0.rc1
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  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: pry
+  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'
+description: This is a client library for the CampBX API that supports instantiating
+  multiple clients in the same process.
+email:
+- seth.messer@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- bandcampbx.gemspec
+- lib/bandcampbx.rb
+- lib/bandcampbx/client.rb
+- lib/bandcampbx/entities/balance.rb
+- lib/bandcampbx/entities/base.rb
+- lib/bandcampbx/entities/order.rb
+- lib/bandcampbx/mapper.rb
+- lib/bandcampbx/net.rb
+- lib/bandcampbx/version.rb
+- spec/integration/client_spec.rb
+- spec/spec_helper.rb
+- spec/unit/bandcampbx/client_spec.rb
+- spec/unit/bandcampbx/entities/balance_spec.rb
+- spec/unit/bandcampbx/entities/order_spec.rb
+- spec/unit/bandcampbx/mapper_spec.rb
+- spec/unit/bandcampbx/net_spec.rb
+- spec/unit/bandcampbx_spec.rb
+- travis.yml
+homepage: http://github.com/megalithic/bandcampbx
+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.0.6
+signing_key: 
+specification_version: 4
+summary: Outstanding CampBX library.
+test_files:
+- spec/integration/client_spec.rb
+- spec/spec_helper.rb
+- spec/unit/bandcampbx/client_spec.rb
+- spec/unit/bandcampbx/entities/balance_spec.rb
+- spec/unit/bandcampbx/entities/order_spec.rb
+- spec/unit/bandcampbx/mapper_spec.rb
+- spec/unit/bandcampbx/net_spec.rb
+- spec/unit/bandcampbx_spec.rb