tastytrade 0.2.0 → 0.3.0

data/spec/tastytrade/models/live_order_spec.rb

@@ -0,0 +1,295 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe Tastytrade::Models::LiveOrder do
+  let(:live_order_data) do
+    {
+      "id" => "12345",
+      "account-number" => "5WV12345",
+      "status" => "Live",
+      "cancellable" => true,
+      "editable" => true,
+      "edited" => false,
+      "time-in-force" => "Day",
+      "order-type" => "Limit",
+      "size" => 100,
+      "price" => "150.50",
+      "price-effect" => "Debit",
+      "underlying-symbol" => "AAPL",
+      "underlying-instrument-type" => "Equity",
+      "created-at" => "2024-01-15T09:30:00.000Z",
+      "updated-at" => "2024-01-15T09:30:05.000Z",
+      "received-at" => "2024-01-15T09:30:00.000Z",
+      "live-at" => "2024-01-15T09:30:05.000Z",
+      "legs" => [
+        {
+          "symbol" => "AAPL",
+          "instrument-type" => "Equity",
+          "action" => "Buy",
+          "quantity" => 100,
+          "remaining-quantity" => 100,
+          "fills" => []
+        }
+      ]
+    }
+  end
+
+  let(:filled_order_data) do
+    live_order_data.merge(
+      "status" => "Filled",
+      "cancellable" => false,
+      "editable" => false,
+      "filled-at" => "2024-01-15T09:35:00.000Z",
+      "terminal-at" => "2024-01-15T09:35:00.000Z",
+      "legs" => [
+        {
+          "symbol" => "AAPL",
+          "instrument-type" => "Equity",
+          "action" => "Buy",
+          "quantity" => 100,
+          "remaining-quantity" => 0,
+          "fill-quantity" => 100,
+          "fill-price" => "150.45",
+          "fills" => [
+            {
+              "ext-exec-id" => "exec123",
+              "fill-id" => "fill123",
+              "quantity" => 100,
+              "fill-price" => "150.45",
+              "filled-at" => "2024-01-15T09:35:00.000Z"
+            }
+          ]
+        }
+      ]
+    )
+  end
+
+  let(:partially_filled_order_data) do
+    live_order_data.merge(
+      "legs" => [
+        {
+          "symbol" => "AAPL",
+          "instrument-type" => "Equity",
+          "action" => "Buy",
+          "quantity" => 100,
+          "remaining-quantity" => 60,
+          "fill-quantity" => 40,
+          "fill-price" => "150.48",
+          "fills" => [
+            {
+              "ext-exec-id" => "exec124",
+              "fill-id" => "fill124",
+              "quantity" => 40,
+              "fill-price" => "150.48",
+              "filled-at" => "2024-01-15T09:32:00.000Z"
+            }
+          ]
+        }
+      ]
+    )
+  end
+
+  describe "#initialize" do
+    subject(:live_order) { described_class.new(live_order_data) }
+
+    it "parses basic attributes correctly" do
+      expect(live_order.id).to eq("12345")
+      expect(live_order.account_number).to eq("5WV12345")
+      expect(live_order.status).to eq("Live")
+      expect(live_order.cancellable).to be true
+      expect(live_order.editable).to be true
+      expect(live_order.edited).to be false
+    end
+
+    it "parses order details correctly" do
+      expect(live_order.time_in_force).to eq("Day")
+      expect(live_order.order_type).to eq("Limit")
+      expect(live_order.size).to eq(100)
+      expect(live_order.price).to eq(BigDecimal("150.50"))
+      expect(live_order.price_effect).to eq("Debit")
+      expect(live_order.underlying_symbol).to eq("AAPL")
+      expect(live_order.underlying_instrument_type).to eq("Equity")
+    end
+
+    it "parses timestamps correctly" do
+      expect(live_order.created_at).to be_a(Time)
+      expect(live_order.updated_at).to be_a(Time)
+      expect(live_order.received_at).to be_a(Time)
+      expect(live_order.live_at).to be_a(Time)
+    end
+
+    it "parses legs correctly" do
+      expect(live_order.legs).to be_an(Array)
+      expect(live_order.legs.size).to eq(1)
+      leg = live_order.legs.first
+      expect(leg).to be_a(Tastytrade::Models::LiveOrderLeg)
+      expect(leg.symbol).to eq("AAPL")
+      expect(leg.action).to eq("Buy")
+      expect(leg.quantity).to eq(100)
+      expect(leg.remaining_quantity).to eq(100)
+    end
+  end
+
+  describe "status check methods" do
+    context "with a live order" do
+      subject(:live_order) { described_class.new(live_order_data) }
+
+      it "#cancellable? returns true" do
+        expect(live_order.cancellable?).to be true
+      end
+
+      it "#editable? returns true" do
+        expect(live_order.editable?).to be true
+      end
+
+      it "#terminal? returns false" do
+        expect(live_order.terminal?).to be false
+      end
+
+      it "#working? returns true" do
+        expect(live_order.working?).to be true
+      end
+
+      it "#filled? returns false" do
+        expect(live_order.filled?).to be false
+      end
+
+      it "#cancelled? returns false" do
+        expect(live_order.cancelled?).to be false
+      end
+    end
+
+    context "with a filled order" do
+      subject(:filled_order) { described_class.new(filled_order_data) }
+
+      it "#cancellable? returns false" do
+        expect(filled_order.cancellable?).to be false
+      end
+
+      it "#editable? returns false" do
+        expect(filled_order.editable?).to be false
+      end
+
+      it "#terminal? returns true" do
+        expect(filled_order.terminal?).to be true
+      end
+
+      it "#working? returns false" do
+        expect(filled_order.working?).to be false
+      end
+
+      it "#filled? returns true" do
+        expect(filled_order.filled?).to be true
+      end
+    end
+  end
+
+  describe "quantity methods" do
+    context "with an unfilled order" do
+      subject(:order) { described_class.new(live_order_data) }
+
+      it "#remaining_quantity returns total remaining" do
+        expect(order.remaining_quantity).to eq(100)
+      end
+
+      it "#filled_quantity returns 0" do
+        expect(order.filled_quantity).to eq(0)
+      end
+    end
+
+    context "with a partially filled order" do
+      subject(:order) { described_class.new(partially_filled_order_data) }
+
+      it "#remaining_quantity returns correct value" do
+        expect(order.remaining_quantity).to eq(60)
+      end
+
+      it "#filled_quantity returns correct value" do
+        expect(order.filled_quantity).to eq(40)
+      end
+    end
+
+    context "with a filled order" do
+      subject(:order) { described_class.new(filled_order_data) }
+
+      it "#remaining_quantity returns 0" do
+        expect(order.remaining_quantity).to eq(0)
+      end
+
+      it "#filled_quantity returns total quantity" do
+        expect(order.filled_quantity).to eq(100)
+      end
+    end
+  end
+end
+
+RSpec.describe Tastytrade::Models::LiveOrderLeg do
+  let(:unfilled_leg_data) do
+    {
+      "symbol" => "AAPL",
+      "instrument-type" => "Equity",
+      "action" => "Buy",
+      "quantity" => 100,
+      "remaining-quantity" => 100,
+      "fills" => []
+    }
+  end
+
+  let(:partially_filled_leg_data) do
+    {
+      "symbol" => "AAPL",
+      "instrument-type" => "Equity",
+      "action" => "Buy",
+      "quantity" => 100,
+      "remaining-quantity" => 60,
+      "fill-quantity" => 40,
+      "fill-price" => "150.48",
+      "fills" => [
+        {
+          "ext-exec-id" => "exec124",
+          "fill-id" => "fill124",
+          "quantity" => 40,
+          "fill-price" => "150.48",
+          "filled-at" => "2024-01-15T09:32:00.000Z"
+        }
+      ]
+    }
+  end
+
+  describe "#filled_quantity" do
+    it "calculates correctly for unfilled leg" do
+      leg = described_class.new(unfilled_leg_data)
+      expect(leg.filled_quantity).to eq(0)
+    end
+
+    it "calculates correctly for partially filled leg" do
+      leg = described_class.new(partially_filled_leg_data)
+      expect(leg.filled_quantity).to eq(40)
+    end
+  end
+
+  describe "#filled?" do
+    it "returns false for unfilled leg" do
+      leg = described_class.new(unfilled_leg_data)
+      expect(leg.filled?).to be false
+    end
+
+    it "returns false for partially filled leg" do
+      leg = described_class.new(partially_filled_leg_data)
+      expect(leg.filled?).to be false
+    end
+  end
+
+  describe "#partially_filled?" do
+    it "returns false for unfilled leg" do
+      leg = described_class.new(unfilled_leg_data)
+      expect(leg.partially_filled?).to be false
+    end
+
+    it "returns true for partially filled leg" do
+      leg = described_class.new(partially_filled_leg_data)
+      expect(leg.partially_filled?).to be true
+    end
+  end
+end

data/spec/tastytrade/models/order_response_spec.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+RSpec.describe Tastytrade::Models::OrderResponse do
+  let(:order_response_data) do
+    {
+      "id" => "123456",
+      "account-number" => "5WX12345",
+      "status" => "Filled",
+      "buying-power-effect" => "-15050.00",
+      "fee-calculation" => {
+        "total-fees" => "0.65",
+        "regulatory-fees" => "0.01"
+      },
+      "price" => "150.50",
+      "price-effect" => "Debit",
+      "value" => "-15050.00",
+      "value-effect" => "Debit",
+      "time-in-force" => "Day",
+      "order-type" => "Limit",
+      "cancellable" => false,
+      "editable" => false,
+      "edited" => false,
+      "warnings" => [],
+      "errors" => [],
+      "legs" => [
+        {
+          "action" => "Buy to Open",
+          "symbol" => "AAPL",
+          "quantity" => 100,
+          "instrument-type" => "Equity",
+          "remaining-quantity" => 0,
+          "fills" => [],
+          "execution-price" => "150.50"
+        }
+      ],
+      "updated-at" => "2023-01-01T10:00:00Z",
+      "created-at" => "2023-01-01T09:59:00Z"
+    }
+  end
+
+  describe "#initialize" do
+    it "parses all order response attributes" do
+      response = described_class.new(order_response_data)
+
+      expect(response.order_id).to eq("123456")
+      expect(response.account_number).to eq("5WX12345")
+      expect(response.status).to eq("Filled")
+      expect(response.buying_power_effect).to eq(BigDecimal("-15050.00"))
+      expect(response.fee_calculations).to be_a(Hash)
+      expect(response.price).to eq(BigDecimal("150.50"))
+      expect(response.price_effect).to eq("Debit")
+      expect(response.value).to eq(BigDecimal("-15050.00"))
+      expect(response.value_effect).to eq("Debit")
+      expect(response.time_in_force).to eq("Day")
+      expect(response.order_type).to eq("Limit")
+      expect(response.cancellable).to be false
+      expect(response.editable).to be false
+      expect(response.edited).to be false
+      expect(response.warnings).to be_empty
+      expect(response.errors).to be_empty
+      expect(response.legs).to be_an(Array)
+      expect(response.updated_at).to be_a(Time)
+      expect(response.created_at).to be_a(Time)
+    end
+
+    it "handles missing optional fields" do
+      minimal_data = {
+        "id" => "123456",
+        "account-number" => "5WX12345",
+        "status" => "Pending"
+      }
+
+      response = described_class.new(minimal_data)
+      expect(response.order_id).to eq("123456")
+      expect(response.buying_power_effect).to be_nil
+      expect(response.price).to be_nil
+      expect(response.warnings).to be_empty
+      expect(response.legs).to be_empty
+    end
+  end
+
+  describe "leg parsing" do
+    it "parses order legs correctly" do
+      response = described_class.new(order_response_data)
+      leg = response.legs.first
+
+      expect(leg).to be_a(Tastytrade::Models::OrderLegResponse)
+      expect(leg.action).to eq("Buy to Open")
+      expect(leg.symbol).to eq("AAPL")
+      expect(leg.quantity).to eq(100)
+      expect(leg.instrument_type).to eq("Equity")
+      expect(leg.remaining_quantity).to eq(0)
+      expect(leg.execution_price).to eq(BigDecimal("150.50"))
+    end
+  end
+end

data/spec/tastytrade/models/order_status_spec.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe Tastytrade::Models::OrderStatus do
+  describe "constants" do
+    it "defines submission phase statuses" do
+      expect(described_class::RECEIVED).to eq("Received")
+      expect(described_class::ROUTED).to eq("Routed")
+      expect(described_class::IN_FLIGHT).to eq("In Flight")
+      expect(described_class::CONTINGENT).to eq("Contingent")
+    end
+
+    it "defines working phase statuses" do
+      expect(described_class::LIVE).to eq("Live")
+      expect(described_class::CANCEL_REQUESTED).to eq("Cancel Requested")
+      expect(described_class::REPLACE_REQUESTED).to eq("Replace Requested")
+    end
+
+    it "defines terminal phase statuses" do
+      expect(described_class::FILLED).to eq("Filled")
+      expect(described_class::CANCELLED).to eq("Cancelled")
+      expect(described_class::REJECTED).to eq("Rejected")
+      expect(described_class::EXPIRED).to eq("Expired")
+      expect(described_class::REMOVED).to eq("Removed")
+    end
+  end
+
+  describe ".submission?" do
+    it "returns true for submission statuses" do
+      expect(described_class.submission?("Received")).to be true
+      expect(described_class.submission?("Routed")).to be true
+      expect(described_class.submission?("In Flight")).to be true
+      expect(described_class.submission?("Contingent")).to be true
+    end
+
+    it "returns false for non-submission statuses" do
+      expect(described_class.submission?("Live")).to be false
+      expect(described_class.submission?("Filled")).to be false
+      expect(described_class.submission?("Cancelled")).to be false
+    end
+  end
+
+  describe ".working?" do
+    it "returns true for working statuses" do
+      expect(described_class.working?("Live")).to be true
+      expect(described_class.working?("Cancel Requested")).to be true
+      expect(described_class.working?("Replace Requested")).to be true
+    end
+
+    it "returns false for non-working statuses" do
+      expect(described_class.working?("Received")).to be false
+      expect(described_class.working?("Filled")).to be false
+      expect(described_class.working?("Cancelled")).to be false
+    end
+  end
+
+  describe ".terminal?" do
+    it "returns true for terminal statuses" do
+      expect(described_class.terminal?("Filled")).to be true
+      expect(described_class.terminal?("Cancelled")).to be true
+      expect(described_class.terminal?("Rejected")).to be true
+      expect(described_class.terminal?("Expired")).to be true
+      expect(described_class.terminal?("Removed")).to be true
+    end
+
+    it "returns false for non-terminal statuses" do
+      expect(described_class.terminal?("Live")).to be false
+      expect(described_class.terminal?("Received")).to be false
+      expect(described_class.terminal?("Routed")).to be false
+    end
+  end
+
+  describe ".cancellable?" do
+    it "returns true only for Live status" do
+      expect(described_class.cancellable?("Live")).to be true
+    end
+
+    it "returns false for other statuses" do
+      expect(described_class.cancellable?("Received")).to be false
+      expect(described_class.cancellable?("Filled")).to be false
+      expect(described_class.cancellable?("Cancel Requested")).to be false
+    end
+  end
+
+  describe ".editable?" do
+    it "returns true only for Live status" do
+      expect(described_class.editable?("Live")).to be true
+    end
+
+    it "returns false for other statuses" do
+      expect(described_class.editable?("Received")).to be false
+      expect(described_class.editable?("Filled")).to be false
+      expect(described_class.editable?("Replace Requested")).to be false
+    end
+  end
+
+  describe ".valid?" do
+    it "returns true for all valid statuses" do
+      all_statuses = described_class::ALL_STATUSES
+      all_statuses.each do |status|
+        expect(described_class.valid?(status)).to be true
+      end
+    end
+
+    it "returns false for invalid statuses" do
+      expect(described_class.valid?("Invalid")).to be false
+      expect(described_class.valid?("Unknown")).to be false
+      expect(described_class.valid?("")).to be false
+      expect(described_class.valid?(nil)).to be false
+    end
+  end
+end