tradier 0.1.0

data/spec/tradier/api/utils/expiration_spec.rb

@@ -0,0 +1,8 @@
+require 'spec_helper'
+
+describe Tradier::API::Utils::Expiration do
+  it 'returns an empty array when response is null' do
+    expirations = Tradier::API::Utils::Expiration.new(:expirations => 'null')
+    expect(expirations.body).to be_empty
+  end
+end

data/spec/tradier/api/watchlists_spec.rb

@@ -0,0 +1,164 @@
+require 'spec_helper'
+
+describe Tradier::API::Watchlists do
+
+  before do
+    @client = Tradier::Client.new
+  end
+
+  describe "#watchlists" do
+    before do
+      stub_get("/v1/watchlists").
+        to_return(:body => fixture("watchlists.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "requests the correct resource" do
+      @client.watchlists
+      expect(a_get("/v1/watchlists")).to have_been_made
+    end
+
+    it "returns an array of 'Tradier::Watchlist' objects" do
+      watchlists = @client.watchlists
+      expect(watchlists).to be_an Array
+      expect(watchlists.size).to eq(3)
+      expect(watchlists.first).to be_a Tradier::Watchlist
+    end
+  end
+
+  describe "#watchlist" do
+    before do
+      stub_get("/v1/watchlists/default").
+        to_return(:body => fixture("watchlist.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "requests the correct resource" do
+      @client.watchlist('default')
+      expect(a_get("/v1/watchlists/default")).to have_been_made
+    end
+
+    it "returns a 'Tradier::Watchlist' object" do
+      watchlist = @client.watchlist('default')
+      expect(watchlist).to be_a Tradier::Watchlist
+    end
+  end
+
+  describe "#delete_watchlist" do
+    before do
+      stub_delete("/v1/watchlists/default").
+        to_return(:body => '', :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "requests the correct resource" do
+      @client.delete_watchlist('default')
+      expect(a_delete("/v1/watchlists/default")).to have_been_made
+    end
+
+    it "returns a 'Tradier::Watchlist' object" do
+      status = @client.delete_watchlist('default')
+      expect(status).to be_true
+    end
+  end
+
+  describe "#create_watchlist" do
+    before do
+      stub_post("/v1/watchlists").
+        to_return(:body => fixture('watchlist.json'), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "requests the correct resource" do
+      @client.create_watchlist(:name => 'default')
+      expect(a_post("/v1/watchlists")).to have_been_made
+    end
+
+    it "returns a 'Tradier::Watchlist' object" do
+      status = @client.create_watchlist(:name => 'default')
+      expect(status).to be_a Tradier::Watchlist
+    end
+  end
+
+  describe "#update_watchlist" do
+    before do
+      stub_put("/v1/watchlists/default").
+        to_return(:body => fixture('watchlist.json'), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "requests the correct resource" do
+      @client.update_watchlist('default', :symbols => 'AAPL,GOOG')
+      expect(a_put("/v1/watchlists/default")).to have_been_made
+    end
+
+    it "returns a 'Tradier::Watchlist' object" do
+      status = @client.update_watchlist('default', :symbols => 'AAPL,GOOG')
+      expect(status).to be_a Tradier::Watchlist
+    end
+  end
+
+  describe '#watchlist_item' do
+    before do
+      stub_get("/v1/watchlists/default/symbols/aapl").
+        to_return(:body => fixture('watchlist_item.json'), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "requests the correct resource" do
+      @client.watchlist_item('default', 'aapl')
+      expect(a_get("/v1/watchlists/default/symbols/aapl")).to have_been_made
+    end
+
+    it "returns a 'Tradier::WatchlistItem' object" do
+      status = @client.watchlist_item('default', 'aapl')
+      expect(status).to be_a Tradier::WatchlistItem
+    end
+  end
+
+  describe '#add_watchlist_item' do
+    before do
+      stub_post("/v1/watchlists/default/symbols").
+        to_return(:body => fixture('watchlist_item.json'), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "requests the correct resource" do
+      @client.add_watchlist_item('default', :symbols => 'aapl')
+      expect(a_post("/v1/watchlists/default/symbols")).to have_been_made
+    end
+
+    it "returns a 'Tradier::Watchlist' object" do
+      status = @client.add_watchlist_item('default', :symbols => 'aapl')
+      expect(status).to be_a Tradier::WatchlistItem
+    end
+  end
+
+  describe '#remove_watchlist_item' do
+    before do
+      stub_delete("/v1/watchlists/default/symbols/aapl").
+        to_return(:headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "requests the correct resource" do
+      @client.remove_watchlist_item('default', 'aapl')
+      expect(a_delete("/v1/watchlists/default/symbols/aapl")).to have_been_made
+    end
+
+    it "returns a 'Tradier::WatchlistItem' object" do
+      status = @client.remove_watchlist_item('default', 'aapl')
+      expect(status).to be_true
+    end
+  end
+
+  describe '#update_watchlist_item' do
+    before do
+      stub_put("/v1/watchlists/default/symbols/aapl").
+        to_return(:body => fixture('watchlist_item.json'), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "requests the correct resource" do
+      @client.update_watchlist_item('default', 'aapl', :shares => 100)
+      expect(a_put("/v1/watchlists/default/symbols/aapl")).to have_been_made
+    end
+
+    it "returns a 'Tradier::Watchlist' object" do
+      status = @client.update_watchlist_item('default', 'aapl', :shares => 100)
+      expect(status).to be_a Tradier::WatchlistItem
+    end
+  end
+
+end

data/spec/tradier/balance_spec.rb

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

data/spec/tradier/base_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe Tradier::Base do
+
+  describe '#attrs' do
+    it 'returns a hash of attributes' do
+      expect(Tradier::Base.new(:id => 1).attrs).to eq({:id => 1})
+    end
+  end
+
+end

data/spec/tradier/calendar_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+describe Tradier::Calendar do
+
+  describe "#month" do
+    it "returns the month when set" do
+      calendar = Tradier::Calendar.new({ :calendar => { :days => { :month => 6 }}})
+      expect(calendar.month).to eq(6)
+    end
+    it "returns nil when month is not set" do
+      calendar = Tradier::Calendar.new({ :calendar => { :days => {}}})
+      expect(calendar.month).to be_nil
+    end
+  end
+
+  describe "#year" do
+    it "returns the year when set" do
+      calendar = Tradier::Calendar.new({ :calendar => { :days => { :year => 2013 }}})
+      expect(calendar.year).to eq(2013)
+    end
+    it "returns nil when year is not set" do
+      calendar = Tradier::Calendar.new({ :calendar => { :days => {}}})
+      expect(calendar.year).to be_nil
+    end
+  end
+
+end

data/spec/tradier/client_spec.rb

@@ -0,0 +1,125 @@
+require 'spec_helper'
+
+describe Tradier::Client do
+
+  subject do
+    Tradier::Client.new(:access_token => "AT")
+  end
+
+  context "with module configuration" do
+
+    before do
+      Tradier.configure do |config|
+        Tradier::Configurable.keys.each do |key|
+          config.send("#{key}=", key)
+        end
+      end
+    end
+
+    after do
+      Tradier.reset!
+    end
+
+    it "inherits the module configuration" do
+      client = Tradier::Client.new
+      Tradier::Configurable.keys.each do |key|
+        expect(client.instance_variable_get(:"@#{key}")).to eq key
+      end
+    end
+
+    context "with class configuration" do
+
+      before do
+        @configuration = {
+          :connection_options => {:timeout => 10},
+          :access_token => "AT",
+          :endpoint => 'https://api.tradierbrokerage.com/',
+          :middleware => Proc.new{},
+          :version => 'v2'
+        }
+      end
+
+      context "during initialization" do
+        it "overrides the module configuration" do
+          client = Tradier::Client.new(@configuration)
+          Tradier::Configurable.keys.each do |key|
+            expect(client.instance_variable_get(:"@#{key}")).to eq @configuration[key]
+          end
+        end
+      end
+
+      context "after initialization" do
+        it "overrides the module configuration after initialization" do
+          client = Tradier::Client.new
+          client.configure do |config|
+            @configuration.each do |key, value|
+              config.send("#{key}=", value)
+            end
+          end
+          Tradier::Configurable.keys.each do |key|
+            expect(client.instance_variable_get(:"@#{key}")).to eq @configuration[key]
+          end
+        end
+      end
+
+    end
+  end
+
+  describe "#delete" do
+    before do
+      stub_delete("/v1/custom/delete").with(:query => {:deleted => "object"})
+    end
+    it "allows custom delete requests" do
+      subject.delete("/custom/delete", {:deleted => "object"})
+      expect(a_delete("/v1/custom/delete").with(:query => {:deleted => "object"})).to have_been_made
+    end
+  end
+
+  describe "#put" do
+    before do
+      stub_put("/v1/custom/put").with(:body => {:updated => "object"})
+    end
+    it "allows custom put requests" do
+      subject.put("/custom/put", {:updated => "object"})
+      expect(a_put("/v1/custom/put").with(:body => {:updated => "object"})).to have_been_made
+    end
+  end
+
+  describe "#credentials?" do
+    it "returns true if all credentials are present" do
+      client = Tradier::Client.new(:access_token => "AT")
+      expect(client.credentials?).to be_true
+    end
+    it "returns false if any credentials are missing" do
+      client = Tradier::Client.new
+      expect(client.credentials?).to be_false
+    end
+  end
+
+  describe "#connection" do
+    it "looks like Faraday connection" do
+      expect(subject.send(:connection)).to respond_to(:run_request)
+    end
+    it "memoizes the connection" do
+      c1, c2 = subject.send(:connection), subject.send(:connection)
+      expect(c1.object_id).to eq c2.object_id
+    end
+  end
+
+  describe "#request" do
+    it "encodes the entire body when no uploaded media is present" do
+      stub_get("/v1/markets/quotes").with(:query => {:symbols => "AAPL"}).to_return(:body => fixture("quote.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      subject.quotes("AAPL")
+      expect(a_get("/v1/markets/quotes").with(:query => {:symbols => "AAPL"})).to have_been_made
+    end
+    it "catches Faraday errors" do
+      subject.stub(:connection).and_raise(Faraday::Error::ClientError.new("Oops"))
+      expect{subject.send(:request, :get, "/path")}.to raise_error Tradier::Error::ClientError
+    end
+    it "catches MultiJson::DecodeError errors" do
+      subject.stub(:connection).and_raise(MultiJson::DecodeError.new("unexpected token", [], "<!DOCTYPE html>"))
+      expect{subject.send(:request, :get, "/path")}.to raise_error Tradier::Error::DecodeError
+    end
+  end
+
+end

data/spec/tradier/clock_spec.rb

@@ -0,0 +1,73 @@
+require 'spec_helper'
+
+describe Tradier::Clock do
+
+  describe "#date" do
+    it "returns the date when set" do
+      clock = Tradier::Clock.new({ :date => '2013-07-04' })
+      expect(clock.date).to be_a Date
+      expect(clock.date.to_s).to eq('2013-07-04')
+    end
+    it "returns nil when date is not set" do
+      clock = Tradier::Clock.new('clock' => {})
+      expect(clock.date).to be_nil
+    end
+  end
+
+  describe "#time" do
+    it "returns the timestamp when set" do
+      clock = Tradier::Clock.new({ :timestamp => 1372103978 })
+      expect(clock.time).to be_a Time
+      expect(clock.time.utc.to_s).to eq('2013-06-24 19:59:38 UTC')
+    end
+    it "returns nil when time is not set" do
+      clock = Tradier::Clock.new('clock' => {})
+      expect(clock.time).to be_nil
+    end
+  end
+
+  describe "#description" do
+    it "returns the date when set" do
+      clock = Tradier::Clock.new({ :description => 'Market is closed.' })
+      expect(clock.description).to eq('Market is closed.')
+    end
+    it "returns nil when description is not set" do
+      clock = Tradier::Clock.new('clock' => {})
+      expect(clock.description).to be_nil
+    end
+  end
+
+  describe "#next_change" do
+    it "returns the date when set" do
+      clock = Tradier::Clock.new({ :next_change => '08:00' })
+      expect(clock.next_change).to eq('08:00')
+    end
+    it "returns nil when next_change is not set" do
+      clock = Tradier::Clock.new('clock' => {})
+      expect(clock.next_change).to be_nil
+    end
+  end
+
+  describe "#next_state" do
+    it "returns the date when set" do
+      clock = Tradier::Clock.new({ :next_state => 'premarket' })
+      expect(clock.next_state).to eq('premarket')
+    end
+    it "returns nil when next_state is not set" do
+      clock = Tradier::Clock.new('clock' => {})
+      expect(clock.next_state).to be_nil
+    end
+  end
+
+  describe "#state" do
+    it "returns the date when set" do
+      clock = Tradier::Clock.new({ :state => 'closed' })
+      expect(clock.state).to eq('closed')
+    end
+    it "returns nil when state is not set" do
+      clock = Tradier::Clock.new('clock' => {})
+      expect(clock.state).to be_nil
+    end
+  end
+
+end

data/spec/tradier/error/client_error_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe Tradier::Error::ClientError do
+
+  before do
+    @client = Tradier::Client.new
+  end
+
+  Tradier::Error::ClientError.errors.each do |status, exception|
+    context "when HTTP status is #{status}" do
+      before do
+        stub_get("/v1/markets/quotes").
+          with(:query => {:symbols => 'AAPL'}).
+          to_return(:status => status, :body => "Oops! We got a #{exception}")
+      end
+      it "raises #{exception.name}" do
+        expect{@client.quotes('AAPL')}.to raise_error exception
+      end
+    end
+  end
+
+end

data/spec/tradier/error/server_error_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe Tradier::Error::ServerError do
+
+  before do
+    @client = Tradier::Client.new
+  end
+
+  Tradier::Error::ServerError.errors.each do |status, exception|
+    context "when HTTP status is #{status}" do
+      before do
+        stub_get("/v1/markets/quotes").
+          with(:query => {:symbols => 'AAPL'}).
+          to_return(:status => status)
+      end
+      it "raises #{exception.name}" do
+        expect{@client.quotes('AAPL')}.to raise_error exception
+      end
+    end
+  end
+
+end