tradier 0.1.0

data/spec/tradier/error_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Tradier::Error do
+
+  describe "#initialize" do
+    it "wraps another error class" do
+      begin
+        raise Faraday::Error::ClientError.new("Oops")
+      rescue Faraday::Error::ClientError
+        begin
+          raise Tradier::Error
+        rescue Tradier::Error => error
+          expect(error.message).to eq "Oops"
+          expect(error.wrapped_exception.class).to eq Faraday::Error::ClientError
+        end
+      end
+    end
+  end
+
+  describe "#errors" do
+    it "lists descendant errors" do
+      expect(Tradier::Error.errors).to have_key(403)
+    end
+  end
+
+end

data/spec/tradier/option_quote_spec.rb

@@ -0,0 +1,61 @@
+require 'spec_helper'
+
+describe Tradier::OptionQuote do
+
+  describe "#==" do
+    it "returns true when objects symbols are the same" do
+      quote = Tradier::OptionQuote.new(:symbol => 'AAPL150117C01000000')
+      other = Tradier::OptionQuote.new(:symbol => 'AAPL150117C01000000')
+      expect(quote == other).to be_true
+    end
+    it "returns false when objects IDs are different" do
+      quote = Tradier::OptionQuote.new(:symbol => 'AAPL150117C01000000')
+      other = Tradier::OptionQuote.new(:symbol => 'AAPL150117P01000000')
+      expect(quote == other).to be_false
+    end
+  end
+
+  describe '#put?' do
+    it 'returns true when the option is a put' do
+      quote = Tradier::OptionQuote.new(:symbol => 'AAPL150117P01000000')
+      expect(quote.put?).to be_true
+    end
+
+    it 'returns false when the option is a call' do
+      quote = Tradier::OptionQuote.new(:symbol => 'AAPL150117C01000000')
+      expect(quote.put?).to be_false
+    end
+  end
+
+  describe '#call?' do
+    it 'returns true when the option is a call' do
+      quote = Tradier::OptionQuote.new(:symbol => 'AAPL150117C01000000')
+      expect(quote.call?).to be_true
+    end
+
+    it 'returns false when the option is a call' do
+      quote = Tradier::OptionQuote.new(:symbol => 'AAPL150117P01000000')
+      expect(quote.call?).to be_false
+    end
+  end
+
+  describe '#expiration_date' do
+    it "returns the expiration_date when set" do
+      quote = Tradier::OptionQuote.new(:expiration_date => '2013-07-04')
+      expect(quote.expiration_date).to be_a Date
+      expect(quote.expiration_date.to_s).to eq('2013-07-04')
+    end
+    it "returns nil when expirationdate is not set" do
+      quote = Tradier::OptionQuote.new(:symbol => 'AAPL150117P01000000')
+      expect(quote.expiration_date).to be_nil
+    end
+  end
+
+  describe '#underlier' do
+    it 'returns the underlying symbol for the option' do
+      quote = Tradier::OptionQuote.new(:symbol => 'AAPL150117C01000000')
+      expect(quote.underlier).to eq('AAPL')
+    end
+  end
+
+end

data/spec/tradier/order_spec.rb

@@ -0,0 +1,43 @@
+require 'spec_helper'
+
+describe Tradier::Order do
+  describe '.from_response' do
+    context 'new order' do
+      let(:response) { MultiJson.decode(fixture('placed_order.json'), :symbolize_keys => true) }
+      let(:order) { Tradier::Order.from_response(response) }
+
+      it 'populates the order id' do
+        expect(order.id).to eq(2038)
+      end
+
+      it 'populates the order status' do
+        expect(order.status).to eq('OK')
+      end
+    end
+
+    context 'previewed order' do
+      let(:response) { MultiJson.decode(fixture('order_with_warnings.json'), :symbolize_keys => true) }
+      let(:order) { Tradier::Order.from_response(response) }
+
+      it 'populates the order side' do
+        expect(order.side).to eq('Buy')
+      end
+
+      it 'populates the order status' do
+        expect(order.status).to eq('Bad Request')
+      end
+
+      it 'populates the order symbol' do
+        expect(order.symbol).to eq('AAPL')
+      end
+
+      it 'populates the order time_in_force' do
+        expect(order.time_in_force).to eq('Day')
+      end
+
+      it 'populates the order type' do
+        expect(order.type).to eq('Market')
+      end
+    end
+  end
+end

data/spec/tradier/position_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Tradier::Position do
+end

data/spec/tradier/profile_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe Tradier::Profile do
+
+  describe "#name" do
+    it "returns the name when set" do
+      profile = Tradier::Profile.new(:profile => { :name => 'Elaine Benes'})
+      expect(profile.name).to eq('Elaine Benes')
+    end
+    it "returns nil when name is not set" do
+      profile = Tradier::Profile.new({})
+      expect(profile.name).to be_nil
+    end
+  end
+
+  describe '#accounts' do
+    it "returns the accounts when set" do
+      profile = Tradier::Profile.new(:profile => { :account => [{:account_number => '123456789', :type => 'Cash'}] })
+      expect(profile.accounts).to be_an Array
+      expect(profile.accounts.first).to be_a Tradier::Account
+    end
+    it "returns nil when accounts is not set" do
+      profile = Tradier::Profile.new({})
+      expect(profile.accounts).to be_nil
+    end
+  end
+
+end

data/spec/tradier/quote_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe Tradier::Quote do
+
+  describe "#==" do
+    it "returns true when objects symbols are the same" do
+      quote = Tradier::Quote.new({ :symbol => 'AAPL' })
+      other = Tradier::Quote.new({ :symbol => 'AAPL' })
+      expect(quote == other).to be_true
+    end
+    it "returns false when objects IDs are different" do
+      quote = Tradier::Quote.new({ :symbol => 'AAPL' })
+      other = Tradier::Quote.new({ :symbol => 'GE' })
+      expect(quote == other).to be_false
+    end
+  end
+
+  describe "#symbol" do
+    it "returns the symbol when set" do
+      quote = Tradier::Quote.new({ :symbol => 'AAPL' })
+      expect(quote.symbol).to eq('AAPL')
+    end
+    it "returns nil when symbol is not set" do
+      quote = Tradier::Quote.new('Quote' => {})
+      expect(quote.symbol).to be_nil
+    end
+  end
+
+end

data/spec/tradier/symbol_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+describe Tradier::Symbol do
+
+  describe '.parse' do
+    it 'raises an expection when passed a numeric string' do
+      expect { Tradier::Symbol.parse('123') }.to raise_error(ArgumentError)
+    end
+
+    it 'raises an expection when passed an unparseable' do
+      expect { Tradier::Symbol.parse('#%$@###') }.to raise_error(ArgumentError)
+    end
+
+    it 'allows a root symbol to be parsed' do
+      symbol = Tradier::Symbol.parse('AAPL')
+      expect(symbol).to be_valid
+    end
+  end
+
+  describe '#description' do
+    it 'returns the text description of an option' do
+      symbol = Tradier::Symbol.parse('AAPL130622C00280000')
+      expect(symbol.description).to eq('AAPL Jun 22 2013 $280.00 CALL')
+    end
+  end
+
+  describe '#expiration' do
+    it 'returns a Date object' do
+      symbol = Tradier::Symbol.parse('AAPL130622C00280000')
+      expect(symbol.expiration).to be_a(Date)
+    end
+  end
+
+  describe '#strike_price' do
+    it 'returns the strike price as a Fixnum' do
+      symbol = Tradier::Symbol.parse('AAPL130622C00280000')
+      expect(symbol.strike_price).to eq(280.00)
+    end
+  end
+
+  describe '#to_s' do
+    it 'returns the original symbol' do
+      symbol = Tradier::Symbol.parse('AAPL130622C00280000')
+      expect(symbol.to_s).to eq('AAPL130622C00280000')
+    end
+  end
+
+  describe '#underlier' do
+    it 'returns the root symbol' do
+      symbol = Tradier::Symbol.parse('AAPL130622C00280000')
+      expect(symbol.underlier).to eq('AAPL')
+    end
+  end
+end

data/spec/tradier/watchlist_item_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe Tradier::WatchlistItem do
+  describe '#symbol' do
+    it "returns the symbol when set" do
+      item = Tradier::WatchlistItem.new({ :symbol => 'AAPL' })
+      expect(item.symbol).to eq('AAPL')
+    end
+    it "returns nil when symbol is not set" do
+      item = Tradier::WatchlistItem.new({ :price => 1.00 })
+      expect(item.symbol).to be_nil
+    end
+  end
+
+  describe '#shares' do
+    it "returns the shares when set" do
+      item = Tradier::WatchlistItem.new({ :shares => 100 })
+      expect(item.shares).to eq(100)
+    end
+    it "returns nil when shares is not set" do
+      item = Tradier::WatchlistItem.new({ :symbol => 'AAPL' })
+      expect(item.shares).to be_nil
+    end
+  end
+
+  describe '#purchase_price' do
+    it "returns the purchase_price when set" do
+      item = Tradier::WatchlistItem.new({ :purchase_price => 100 })
+      expect(item.purchase_price).to eq(100)
+    end
+    it "returns nil when purchase_price is not set" do
+      item = Tradier::WatchlistItem.new({ :symbol => 'AAPL' })
+      expect(item.purchase_price).to be_nil
+    end
+  end
+
+  describe "#purchase_date" do
+    it "returns the purchase_date when set" do
+      clock = Tradier::WatchlistItem.new({ :purchase_date => '2013-07-04' })
+      expect(clock.purchase_date).to be_a Date
+      expect(clock.purchase_date.to_s).to eq('2013-07-04')
+    end
+    it "returns nil when purchase_date is not set" do
+      clock = Tradier::WatchlistItem.new({ :symbol => 'AAPL' })
+      expect(clock.purchase_date).to be_nil
+    end
+  end
+end

data/spec/tradier/watchlist_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+describe Tradier::Watchlist do
+  describe '#id' do
+    it "returns the id when set" do
+      watchlist = Tradier::Watchlist.new({ :id => 'default' })
+      expect(watchlist.id).to eq('default')
+    end
+    it "returns nil when id is not set" do
+      watchlist = Tradier::Watchlist.new({ :name => 'Default' })
+      expect(watchlist.id).to be_nil
+    end
+  end
+
+  describe '#name' do
+    it "returns the name when set" do
+      watchlist = Tradier::Watchlist.new({ :name => 'Default' })
+      expect(watchlist.name).to eq('Default')
+    end
+    it "returns nil when name is not set" do
+      watchlist = Tradier::Watchlist.new({ :id => 'default' })
+      expect(watchlist.name).to be_nil
+    end
+  end
+
+  describe '#items' do
+    it "returns an array of watchlist items" do
+      response = {:items => { :item => [{:symbol => 'AAPL'}, { :symbol => 'GE'}]}}
+      watchlist = Tradier::Watchlist.new(response)
+      expect(watchlist.items).to be_an Array
+      expect(watchlist.items.size).to eq(2)
+      expect(watchlist.items.first).to be_a Tradier::WatchlistItem
+    end
+  end
+end

data/spec/tradier_spec.rb

@@ -0,0 +1,105 @@
+require 'spec_helper'
+
+describe Tradier do
+
+  after do
+    Tradier.reset!
+  end
+
+  context "when delegating to a client" do
+
+    before do
+      stub_get("/v1/markets/quotes").
+        with(:query => {:symbols => "AAPL"}).
+        to_return(:body => fixture("quote.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "requests the correct resource" do
+      Tradier.quotes('AAPL')
+      expect(a_get("/v1/markets/quotes").with(:query => {:symbols => "AAPL"})).to have_been_made
+    end
+
+    it "returns the same results as a client" do
+      expect(Tradier.quotes('AAPL')).to eq Tradier::Client.new.quotes('AAPL')
+    end
+
+  end
+
+  describe ".respond_to?" do
+    it "delegates to Tradier::Client" do
+      expect(Tradier.respond_to?(:quotes)).to be_true
+    end
+    it "takes an optional argument" do
+      expect(Tradier.respond_to?(:quotes, true)).to be_true
+    end
+  end
+
+  describe ".client" do
+    it "returns a Tradier::Client" do
+      expect(Tradier.client).to be_a Tradier::Client
+    end
+
+    context "when the options don't change" do
+      it "caches the client" do
+        expect(Tradier.client).to eq Tradier.client
+      end
+    end
+    context "when the options change" do
+      it "busts the cache" do
+        client1 = Tradier.client
+        Tradier.configure do |config|
+          config.access_token = 'abc'
+        end
+        client2 = Tradier.client
+        expect(client1).not_to eq client2
+      end
+    end
+  end
+
+  describe ".configure" do
+    Tradier::Configurable.keys.each do |key|
+      it "sets the #{key.to_s.gsub('_', ' ')}" do
+        Tradier.configure do |config|
+          config.send("#{key}=", key)
+        end
+        expect(Tradier.instance_variable_get(:"@#{key}")).to eq key
+      end
+    end
+
+    context "when invalid credentials are provided" do
+      it "raises a ConfigurationError exception" do
+        expect {
+          Tradier.configure do |config|
+            config.access_token = [12345, 54321]
+          end
+        }.to raise_error
+      end
+    end
+
+    context "when no credentials are provided" do
+      it "does not raise an exception" do
+        expect {
+          Tradier.configure do |config|
+            config.access_token = nil
+          end
+        }.to_not raise_error
+      end
+    end
+  end
+
+  describe ".credentials?" do
+    it "returns true if all oauth credentials are present" do
+      Tradier.configure do |config|
+        config.access_token = 'OT'
+      end
+      expect(Tradier.credentials?).to be_true
+    end
+    it "returns false if any credentials are missing" do
+      Tradier.configure do |config|
+        config.version = 'v2'
+      end
+      expect(Tradier.credentials?).to be_false
+    end
+  end
+
+end

data/tradier.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'tradier/version'
+
+Gem::Specification.new do |gem|
+  gem.name        = 'tradier'
+  gem.version     = Tradier::VERSION
+  gem.homepage    = 'https://github.com/tradier/tradier.rb'
+
+  gem.author      = ["Steve Agalloco", "Jason Barry"]
+  gem.email       = ['steve.agalloco@gmail.com', 'jay@jcbarry.com']
+  gem.description = "Rubygem for interacting with the Tradier API."
+  gem.summary     = gem.description
+
+  gem.license     = 'MIT'
+
+  gem.add_dependency 'faraday', ['~> 0.8', '< 0.10']
+  gem.add_dependency 'faraday_middleware', ['~> 0.8', '< 0.10']
+  gem.add_dependency 'celluloid'
+  gem.add_development_dependency 'bundler', '~> 1'
+
+  gem.files = %w(.yardopts LICENSE.md README.md Rakefile tradier.gemspec)
+  gem.files += Dir.glob("lib/**/*.rb")
+  gem.files += Dir.glob("spec/**/*")
+
+  gem.test_files = Dir.glob("spec/**/*")
+
+  gem.require_paths = ['lib']
+end