schwab_rb 0.8.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e92f8e69c61f92f34a54eb5ae7b5b07a8734dbe71a221006972a0988aedc5fd5
-  data.tar.gz: a0635b9f44605a22ee31140f8b8601d7f0cf64d28dcdf41e5f711d680efa7dfd
+  metadata.gz: 4886933bb9c99f66735ff9503b0904ac55a605e653550d413713c8d33e412a79
+  data.tar.gz: d4f9476eeb6f97b00d890295e1edb6002c0780f4c34eb1b321d2355d55853e6a
 SHA512:
-  metadata.gz: c30b898de7b8e933960f38c62b82364210ec89abe603b773bf7e0b012e74ce8e3230f6f28c015fc100a46a2a1a7596e6896758f3a695dd9707c63ef92eb1df8d
-  data.tar.gz: 8f0e880a9a0227ad9b02c1d8ed95f9b66d49e2303ac5ad955f8cd9cc7fa0cabd893e72a5091f6990c352eacf5939e9a75eee292cf0f592dbe7c74b53baff897c
+  metadata.gz: 7998b7bbbfac20de7e62b3dc2ccc6472be8a19b2956f2a2f93c1fbd441c0ff0e5713004f27cc96b6b27286aead9457a16aca4d92a62411ea1a662a6f67d9f49f
+  data.tar.gz: e911c3bf6958b4dc0858669e0f38795466a4abf6d202805f6f12fa19ec6a991b1819b8743c682b89e12908595cb856ca8a15bea4b1011a4d6549f9a4a40feb6b

data/.codex/skills/schwab-rb-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: schwab-rb-cli
-description: Use the installed schwab_rb CLI for authentication and price history downloads. Activate when a user wants to run the schwab_rb command, log in to Schwab, fetch market data, troubleshoot CLI installation or environment variables, or save price history from the command line.
+description: Use the installed schwab_rb CLI for authentication, option-chain samples, and price history downloads. Activate when a user wants to run the schwab_rb command, log in to Schwab, fetch market data, troubleshoot CLI installation or environment variables, or save CLI output from the command line.
 ---
 
 # Schwab RB CLI Skill
@@ -9,8 +9,8 @@ Use this skill when the task should be completed through the installed `schwab_r
 
 ## When to use
 
-- The user wants to run `schwab_rb help`, `schwab_rb login`, or `schwab_rb price-history`
-- The user wants to download price history data to JSON or CSV
+- The user wants to run `schwab_rb help`, `schwab_rb login`, `schwab_rb sample`, or `schwab_rb price-history`
+- The user wants to download an option-chain sample or price history data to JSON or CSV
 - The user needs help with CLI installation, `asdf` shims, or missing `SCHWAB_*` environment variables
 - The user wants the agent to verify the CLI works on the local machine
 
@@ -39,7 +39,13 @@ The wrapper only attempts to execute the globally installed `schwab_rb` command
 skills/schwab-rb-cli/scripts/run_schwab_rb.sh login
 ```
 
-5. For data downloads, run:
+5. For option-chain samples, run:
+
+```bash
+skills/schwab-rb-cli/scripts/run_schwab_rb.sh sample --symbol SPX --expiration-date 2026-04-17
+```
+
+6. For price history downloads, run:
 
 ```bash
 skills/schwab-rb-cli/scripts/run_schwab_rb.sh price-history --symbol AAPL --start-date 2026-03-01

data/.codex/skills/schwab-rb-cli/references/cli_examples.md

@@ -5,6 +5,7 @@
 ```bash
 skills/schwab-rb-cli/scripts/run_schwab_rb.sh help
 skills/schwab-rb-cli/scripts/run_schwab_rb.sh help price-history
+skills/schwab-rb-cli/scripts/run_schwab_rb.sh help sample
 ```
 
 ## Authentication
@@ -49,6 +50,25 @@ skills/schwab-rb-cli/scripts/run_schwab_rb.sh price-history \
   --dir /tmp/schwab_rb_data
 ```
 
+## Option-chain samples
+
+Default CSV output:
+
+```bash
+skills/schwab-rb-cli/scripts/run_schwab_rb.sh sample --symbol SPX --expiration-date 2026-04-17
+```
+
+Filter by root and write JSON to a custom directory:
+
+```bash
+skills/schwab-rb-cli/scripts/run_schwab_rb.sh sample \
+  --symbol SPX \
+  --root SPXW \
+  --expiration-date 2026-04-17 \
+  --format json \
+  --dir /tmp/schwab_rb_options
+```
+
 ## Installation troubleshooting
 
 Install the gem from the repo:

data/.rubocop.yml

@@ -41,3 +41,4 @@ Metrics/ClassLength:
 Metrics/ModuleLength:
   Exclude:
     - 'spec/**/*'
+    - 'lib/schwab_rb/option_sample/downloader.rb'

data/README.md

@@ -83,7 +83,7 @@ Before using the gem, ensure you have the following environment variables set:
 - `APP_CALLBACK_URL`: The callback URL for your application.
 - `TOKEN_PATH`: Path to store the authentication token.
 - `SCHWAB_ACCOUNT_NUMBER`: Your Schwab account number.
-- `SCHWAB_LOGFILE`: (Optional) Path to the log file. Defaults to `STDOUT`.
+- `SCHWAB_LOGFILE`: (Optional) Path to the log file. Defaults to `~/.schwab_rb/schwab_rb.log`.
 - `SCHWAB_LOG_LEVEL`: (Optional) Log level for the logger. Defaults to `WARN`. Possible values: `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL`.
 - `SCHWAB_SILENCE_OUTPUT`: (Optional) Set to `true` to disable logging output. Defaults to `false`.
 
@@ -91,7 +91,7 @@ You can also configure logging programmatically:
 
 ```ruby
 SchwabRb.configure do |config|
-  config.logger = Logger.new(STDOUT)
+  config.logger = Logger.new($stdout)
   config.log_level = 'INFO'
   config.silence_output = false
 end

data/examples/fetch_account_numbers.rb

@@ -4,19 +4,19 @@
 # Script to fetch account numbers data and save as fixture
 # Usage: ruby examples/fetch_account_numbers.rb
 
-require_relative '../lib/schwab_rb'
-require 'dotenv'
-require 'json'
-require 'fileutils'
+require_relative "../lib/schwab_rb"
+require "dotenv"
+require "json"
+require "fileutils"
 
 Dotenv.load
 
 def create_client
-  token_path = ENV['TOKEN_PATH'] || 'schwab_token.json'
+  token_path = ENV["TOKEN_PATH"] || "schwab_token.json"
   SchwabRb::Auth.init_client_easy(
-    ENV['SCHWAB_API_KEY'],
-    ENV['SCHWAB_APP_SECRET'], 
-    ENV['APP_CALLBACK_URL'],
+    ENV.fetch("SCHWAB_API_KEY", nil),
+    ENV.fetch("SCHWAB_APP_SECRET", nil),
+    ENV.fetch("APP_CALLBACK_URL", nil),
     token_path
   )
 end
@@ -24,26 +24,23 @@ end
 def fetch_account_numbers
   client = create_client
   puts "Fetching account numbers..."
-  
+
   response = client.get_account_numbers
   parsed_data = JSON.parse(response.body, symbolize_names: true)
-  
+
   # Create fixtures directory if it doesn't exist
-  fixtures_dir = File.join(__dir__, '..', 'spec', 'fixtures')
+  fixtures_dir = File.join(__dir__, "..", "spec", "fixtures")
   FileUtils.mkdir_p(fixtures_dir)
-  
+
   # Save the raw response
-  fixture_file = File.join(fixtures_dir, 'account_numbers.json')
+  fixture_file = File.join(fixtures_dir, "account_numbers.json")
   File.write(fixture_file, JSON.pretty_generate(parsed_data))
-  
+
   puts "Account numbers data saved to: #{fixture_file}"
   puts "Sample data: #{parsed_data.first(2)}"
-  
-rescue => e
+rescue StandardError => e
   puts "Error fetching account numbers: #{e.message}"
   puts e.backtrace.first(3)
 end
 
-if __FILE__ == $0
-  fetch_account_numbers
-end
+fetch_account_numbers if __FILE__ == $PROGRAM_NAME

data/examples/fetch_user_preferences.rb

@@ -4,19 +4,19 @@
 # Script to fetch user preferences data and save as fixture
 # Usage: ruby examples/fetch_user_preferences.rb
 
-require_relative '../lib/schwab_rb'
-require 'dotenv'
-require 'json'
-require 'fileutils'
+require_relative "../lib/schwab_rb"
+require "dotenv"
+require "json"
+require "fileutils"
 
 Dotenv.load
 
 def create_client
-  token_path = ENV['TOKEN_PATH'] || 'schwab_token.json'
+  token_path = ENV["TOKEN_PATH"] || "schwab_token.json"
   SchwabRb::Auth.init_client_easy(
-    ENV['SCHWAB_API_KEY'],
-    ENV['SCHWAB_APP_SECRET'], 
-    ENV['APP_CALLBACK_URL'],
+    ENV.fetch("SCHWAB_API_KEY", nil),
+    ENV.fetch("SCHWAB_APP_SECRET", nil),
+    ENV.fetch("APP_CALLBACK_URL", nil),
     token_path
   )
 end
@@ -24,26 +24,23 @@ end
 def fetch_user_preferences
   client = create_client
   puts "Fetching user preferences..."
-  
+
   response = client.get_user_preferences
   parsed_data = JSON.parse(response.body, symbolize_names: true)
-  
+
   # Create fixtures directory if it doesn't exist
-  fixtures_dir = File.join(__dir__, '..', 'spec', 'fixtures')
+  fixtures_dir = File.join(__dir__, "..", "spec", "fixtures")
   FileUtils.mkdir_p(fixtures_dir)
-  
+
   # Save the raw response
-  fixture_file = File.join(fixtures_dir, 'user_preferences.json')
+  fixture_file = File.join(fixtures_dir, "user_preferences.json")
   File.write(fixture_file, JSON.pretty_generate(parsed_data))
-  
+
   puts "User preferences data saved to: #{fixture_file}"
   puts "Sample data keys: #{parsed_data.keys.first(5)}"
-  
-rescue => e
+rescue StandardError => e
   puts "Error fetching user preferences: #{e.message}"
   puts e.backtrace.first(3)
 end
 
-if __FILE__ == $0
-  fetch_user_preferences
-end
+fetch_user_preferences if __FILE__ == $PROGRAM_NAME

data/examples/place_oco_order.rb

@@ -15,6 +15,8 @@ Dotenv.load
 #
 
 # SchwabRb::Configuration.configure do |config|
+# config.schwab_home = "/path/to/your/schwab_rb_home"
+# config.log_level = "DEBUG"
 # end
 
 CURRENT_ACCT = "TRADING_BROKERAGE_ACCOUNT"
@@ -46,25 +48,30 @@ oco_order = SchwabRb::Orders::OrderFactory.build(
       short_leg_symbol: "SPXW  251020P06530000",
       long_leg_symbol: "SPXW  251020P06510000",
       order_type: SchwabRb::Order::Types::STOP_LIMIT,
-      stop:
-      price: 0.3,
+      price: 2.1,
+      stop_price: 2.0,
       order_instruction: :close,
       credit_debit: :debit,
-      quantity: 1
+      quantity: 2
     },
     {
       strategy_type: SchwabRb::Order::ComplexOrderStrategyTypes::VERTICAL,
       short_leg_symbol: "SPXW  251020C06770000",
       long_leg_symbol: "SPXW  251020C06790000",
       order_type: SchwabRb::Order::Types::STOP_LIMIT,
-      price: 0.3,
+      price: 2.1,
+      stop_price: 2.0,
       order_instruction: :close,
       credit_debit: :debit,
-      quantity: 1
+      quantity: 2
     }
   ]
 )
 
 built_order = oco_order.build
 
-response = client.place_order(built_order, account_name: CURRENT_ACCT)
+binding.pry
+
+# response = client.place_order(built_order, account_name: CURRENT_ACCT)
+
+binding.pry

data/lib/schwab_rb/cli/app.rb

@@ -1,12 +1,9 @@
 # frozen_string_literal: true
 
-require "csv"
 require "date"
 require "json"
 require "optparse"
 require "pathname"
-require "fileutils"
-require "time"
 
 module SchwabRb
   module CLI
@@ -18,33 +15,6 @@ module SchwabRb
       DEFAULT_HISTORY_DIR = "~/.schwab_rb/data/history"
       DEFAULT_OPTIONS_DIR = "~/.schwab_rb/data/options"
       SUPPORTED_FORMATS = %w[csv json].freeze
-      OPTION_SAMPLE_CSV_HEADERS = %w[
-        contract_type
-        symbol
-        description
-        strike
-        expiration_date
-        mark
-        bid
-        bid_size
-        ask
-        ask_size
-        last
-        last_size
-        open_interest
-        total_volume
-        delta
-        gamma
-        theta
-        vega
-        rho
-        volatility
-        theoretical_volatility
-        theoretical_option_value
-        intrinsic_value
-        extrinsic_value
-        underlying_price
-      ].freeze
       PERIOD_TYPES = {
         "day" => SchwabRb::PriceHistory::PeriodTypes::DAY,
         "month" => SchwabRb::PriceHistory::PeriodTypes::MONTH,
@@ -221,14 +191,13 @@ module SchwabRb
 
         validate_option_sample_options!(options)
 
-        output_path = resolve_option_sample_response(options)
+        _, output_path = resolve_option_sample_response(options)
 
         stdout.puts("Saved #{options[:symbol]} option sample to #{output_path}")
         0
       end
       # rubocop:enable Metrics/AbcSize
 
-      # rubocop:disable Metrics/AbcSize
       def resolve_price_history_response(options)
         directory = SchwabRb::PathSupport.expand_path(options.fetch(:dir))
         SchwabRb::PriceHistory::Downloader.resolve(
@@ -245,148 +214,20 @@ module SchwabRb
           period: options[:period]
         )
       end
-      # rubocop:enable Metrics/AbcSize
 
       def resolve_option_sample_response(options)
         directory = SchwabRb::PathSupport.expand_path(options.fetch(:dir))
-        response = fetch_option_sample(build_non_interactive_client, options)
-        FileUtils.mkdir_p(directory)
-        output_path = option_sample_output_path(directory, options, response)
-        write_option_sample(output_path, response, options)
-        output_path
-      end
-
-      def write_option_sample(output_path, response, options)
-        File.write(output_path, serialized_option_sample(response, options))
-      end
-
-      def serialized_option_sample(response, options)
-        case options.fetch(:format)
-        when "json"
-          JSON.pretty_generate(response)
-        when "csv"
-          serialized_option_sample_csv(response, options)
-        else
-          raise Error, "Unsupported format `#{options[:format]}`."
-        end
-      end
-
-      def serialized_option_sample_csv(response, options)
-        sample_timestamp = options.fetch(:timestamp).utc.iso8601
-
-        CSV.generate do |csv|
-          csv << OPTION_SAMPLE_CSV_HEADERS
-          option_sample_rows(response).each do |option|
-            csv << option_sample_csv_row(response, option, sample_timestamp)
-          end
-        end
-      end
-
-      # rubocop:disable Metrics/AbcSize
-      def option_sample_csv_row(response, option, _sample_timestamp)
-        [
-          option[:putCall],
-          option[:symbol],
-          option[:description],
-          option[:strikePrice],
-          normalize_option_date(option[:expirationDate]),
-          option[:mark],
-          option[:bid],
-          option[:bidSize],
-          option[:ask],
-          option[:askSize],
-          option[:last],
-          option[:lastSize],
-          option[:openInterest],
-          option[:totalVolume],
-          option[:delta],
-          option[:gamma],
-          option[:theta],
-          option[:vega],
-          option[:rho],
-          option[:volatility],
-          option[:theoreticalVolatility],
-          option[:theoreticalOptionValue],
-          option[:intrinsicValue],
-          option[:extrinsicValue],
-          response[:underlyingPrice]
-        ]
-      end
-      # rubocop:enable Metrics/AbcSize
-
-      def fetch_option_sample(client, options)
-        expiration_date = options.fetch(:expiration_date)
-
-        response = client.get_option_chain(
-          SchwabRb::PriceHistory::Downloader.api_symbol(options.fetch(:symbol)),
-          contract_type: SchwabRb::Option::ContractTypes::ALL,
-          strike_range: SchwabRb::Option::StrikeRanges::ALL,
-          from_date: expiration_date,
-          to_date: expiration_date,
-          return_data_objects: false
-        )
-
-        filter_option_sample_response(response, options[:root])
-      end
-
-      def option_sample_rows(response)
-        rows = [response[:callExpDateMap], response[:putExpDateMap]].compact.flat_map do |date_map|
-          option_rows_from_date_map(date_map)
-        end
-
-        rows.sort_by do |option|
-          [
-            normalize_option_date(option[:expirationDate]).to_s,
-            option[:putCall].to_s,
-            option[:strikePrice].to_f
-          ]
-        end
-      end
-
-      def option_rows_from_date_map(date_map)
-        date_map.values.flat_map do |strikes|
-          strikes.values.flatten.map { |option| option.transform_keys(&:to_sym) }
-        end
-      end
-
-      def filter_option_sample_response(response, option_root)
-        return response if blank?(option_root)
-
-        normalized_root = option_root.to_s.strip.upcase
-        filtered_call_map = filter_option_date_map_by_root(response[:callExpDateMap], normalized_root)
-        filtered_put_map = filter_option_date_map_by_root(response[:putExpDateMap], normalized_root)
-
-        response.merge(
-          callExpDateMap: filtered_call_map,
-          putExpDateMap: filtered_put_map
+        SchwabRb::OptionSample::Downloader.resolve(
+          client: build_non_interactive_client,
+          symbol: options.fetch(:symbol),
+          root: options[:root],
+          expiration_date: options.fetch(:expiration_date),
+          directory: directory,
+          format: options.fetch(:format),
+          timestamp: options.fetch(:timestamp)
         )
       end
 
-      def filter_option_date_map_by_root(date_map, option_root)
-        return {} unless date_map
-
-        date_map.each_with_object({}) do |(expiration_key, strikes), filtered_dates|
-          filtered_strikes = strikes.each_with_object({}) do |(strike, contracts), filtered_by_strike|
-            matching_contracts = contracts.select { |contract| contract[:optionRoot].to_s.upcase == option_root }
-            filtered_by_strike[strike] = matching_contracts if matching_contracts.any?
-          end
-
-          filtered_dates[expiration_key] = filtered_strikes if filtered_strikes.any?
-        end
-      end
-
-      def normalize_option_date(value)
-        return if value.nil?
-
-        Date.parse(value.to_s).iso8601
-      end
-
-      def normalize_option_timestamp(value)
-        return if value.nil?
-
-        Time.at(value / 1000.0).utc.iso8601
-      end
-
       def build_non_interactive_client
         credentials = load_credentials(require_callback_url: false)
         token_path = resolved_token_path
@@ -494,24 +335,6 @@ module SchwabRb
         )
       end
 
-      def option_sample_output_path(directory, options, response)
-        File.join(
-          directory,
-          [
-            SchwabRb::PriceHistory::Downloader.sanitize_symbol(
-              options[:root] || option_sample_root(response, options.fetch(:symbol))
-            ),
-            "exp#{options.fetch(:expiration_date).iso8601}",
-            options.fetch(:timestamp).strftime("%Y-%m-%d_%H-%M-%S")
-          ].join("_") + ".#{options.fetch(:format)}"
-        )
-      end
-
-      def option_sample_root(response, fallback_symbol)
-        first_option = option_sample_rows(response).find { |option| !blank?(option[:optionRoot]) }
-        first_option ? first_option[:optionRoot] : fallback_symbol
-      end
-
       def blank?(value)
         value.nil? || value.to_s.strip.empty?
       end

data/lib/schwab_rb/configuration.rb

@@ -25,8 +25,14 @@ module SchwabRb
       !has_external_logger? && !@silence_output
     end
 
+    def default_log_file
+      File.join(@schwab_home, "schwab_rb.log")
+    end
+
     def effective_log_file
-      @log_file || (ENV["LOGFILE"] if ENV["LOGFILE"] && !ENV["LOGFILE"].empty?)
+      @log_file ||
+        (ENV["LOGFILE"] if ENV["LOGFILE"] && !ENV["LOGFILE"].empty?) ||
+        default_log_file
     end
   end
 

data/lib/schwab_rb/option_sample/downloader.rb

@@ -0,0 +1,210 @@
+# frozen_string_literal: true
+
+require "csv"
+require "json"
+require "time"
+require "fileutils"
+
+module SchwabRb
+  class OptionSample
+    # Public file-oriented downloader for one-expiration option chain samples.
+    module Downloader
+      SUPPORTED_FORMATS = %w[csv json].freeze
+      CSV_HEADERS = %w[
+        contract_type
+        symbol
+        description
+        strike
+        expiration_date
+        mark
+        bid
+        bid_size
+        ask
+        ask_size
+        last
+        last_size
+        open_interest
+        total_volume
+        delta
+        gamma
+        theta
+        vega
+        rho
+        volatility
+        theoretical_volatility
+        theoretical_option_value
+        intrinsic_value
+        extrinsic_value
+        underlying_price
+      ].freeze
+
+      module_function
+
+      # rubocop:disable Metrics/ParameterLists
+      def resolve(client:, symbol:, expiration_date:, directory:, format:, timestamp:, root: nil)
+        response = fetch(
+          client: client,
+          symbol: symbol,
+          expiration_date: expiration_date,
+          root: root
+        )
+
+        FileUtils.mkdir_p(directory)
+        path = output_path(
+          directory: directory,
+          symbol: symbol,
+          expiration_date: expiration_date,
+          format: format,
+          timestamp: timestamp,
+          root: root,
+          response: response
+        )
+        File.write(path, serialize(response: response, format: format, timestamp: timestamp))
+
+        [response, path]
+      end
+      # rubocop:enable Metrics/ParameterLists
+
+      def fetch(client:, symbol:, expiration_date:, root: nil)
+        response = client.get_option_chain(
+          SchwabRb::PriceHistory::Downloader.api_symbol(symbol),
+          contract_type: SchwabRb::Option::ContractTypes::ALL,
+          strike_range: SchwabRb::Option::StrikeRanges::ALL,
+          from_date: expiration_date,
+          to_date: expiration_date,
+          return_data_objects: false
+        )
+
+        filter_response_by_root(response, root)
+      end
+
+      def filter_response_by_root(response, option_root)
+        return response if blank?(option_root)
+
+        normalized_root = option_root.to_s.strip.upcase
+
+        response.merge(
+          callExpDateMap: filter_date_map_by_root(response[:callExpDateMap], normalized_root),
+          putExpDateMap: filter_date_map_by_root(response[:putExpDateMap], normalized_root)
+        )
+      end
+
+      def filter_date_map_by_root(date_map, option_root)
+        return {} unless date_map
+
+        date_map.each_with_object({}) do |(expiration_key, strikes), filtered_dates|
+          filtered_strikes = strikes.each_with_object({}) do |(strike, contracts), filtered_by_strike|
+            matching_contracts = contracts.select { |contract| contract[:optionRoot].to_s.upcase == option_root }
+            filtered_by_strike[strike] = matching_contracts if matching_contracts.any?
+          end
+
+          filtered_dates[expiration_key] = filtered_strikes if filtered_strikes.any?
+        end
+      end
+
+      # rubocop:disable Metrics/ParameterLists
+      def output_path(directory:, symbol:, expiration_date:, format:, timestamp:, root: nil, response: nil)
+        selected_root = root || option_root(response, symbol)
+
+        File.join(
+          directory,
+          [
+            SchwabRb::PriceHistory::Downloader.sanitize_symbol(selected_root),
+            "exp#{expiration_date.iso8601}",
+            timestamp.strftime("%Y-%m-%d_%H-%M-%S")
+          ].join("_") + ".#{format}"
+        )
+      end
+      # rubocop:enable Metrics/ParameterLists
+
+      def serialize(response:, format:, timestamp:)
+        case format
+        when "json"
+          JSON.pretty_generate(response)
+        when "csv"
+          serialize_csv(response: response, timestamp: timestamp)
+        else
+          raise ArgumentError, "Unsupported format `#{format}`."
+        end
+      end
+
+      def serialize_csv(response:, timestamp:)
+        sample_timestamp = timestamp.utc.iso8601
+
+        CSV.generate do |csv|
+          csv << CSV_HEADERS
+          rows(response).each do |option|
+            csv << csv_row(response, option, sample_timestamp)
+          end
+        end
+      end
+
+      # rubocop:disable Metrics/AbcSize
+      def csv_row(response, option, _sample_timestamp)
+        [
+          option[:putCall],
+          option[:symbol],
+          option[:description],
+          option[:strikePrice],
+          normalize_option_date(option[:expirationDate]),
+          option[:mark],
+          option[:bid],
+          option[:bidSize],
+          option[:ask],
+          option[:askSize],
+          option[:last],
+          option[:lastSize],
+          option[:openInterest],
+          option[:totalVolume],
+          option[:delta],
+          option[:gamma],
+          option[:theta],
+          option[:vega],
+          option[:rho],
+          option[:volatility],
+          option[:theoreticalVolatility],
+          option[:theoreticalOptionValue],
+          option[:intrinsicValue],
+          option[:extrinsicValue],
+          response[:underlyingPrice]
+        ]
+      end
+      # rubocop:enable Metrics/AbcSize
+
+      def rows(response)
+        extracted_rows = [response[:callExpDateMap], response[:putExpDateMap]].compact.flat_map do |date_map|
+          rows_from_date_map(date_map)
+        end
+
+        extracted_rows.sort_by do |option|
+          [
+            normalize_option_date(option[:expirationDate]).to_s,
+            option[:putCall].to_s,
+            option[:strikePrice].to_f
+          ]
+        end
+      end
+
+      def rows_from_date_map(date_map)
+        date_map.values.flat_map do |strikes|
+          strikes.values.flatten.map { |option| option.transform_keys(&:to_sym) }
+        end
+      end
+
+      def option_root(response, fallback_symbol)
+        first_option = rows(response).find { |option| !blank?(option[:optionRoot]) }
+        first_option ? first_option[:optionRoot] : fallback_symbol
+      end
+
+      def normalize_option_date(value)
+        return if value.nil?
+
+        Date.parse(value.to_s).iso8601
+      end
+
+      def blank?(value)
+        value.nil? || value.to_s.strip.empty?
+      end
+    end
+  end
+end

data/lib/schwab_rb/option_sample.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module SchwabRb
+  class OptionSample
+  end
+end

data/lib/schwab_rb/utils/logger.rb

@@ -27,7 +27,7 @@ module SchwabRb
         return null_logger if config.silence_output
         return null_logger unless config.should_create_logger?
 
-        log_destination = config.effective_log_file || $stdout
+        log_destination = config.effective_log_file
 
         return null_logger if [:null, "/dev/null"].include?(log_destination)
 

data/lib/schwab_rb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SchwabRb
-  VERSION = "0.8.1"
+  VERSION = "0.9.0"
 end

data/lib/schwab_rb.rb

@@ -23,6 +23,8 @@ require_relative "schwab_rb/orders/instruments"
 require_relative "schwab_rb/market_hours"
 require_relative "schwab_rb/price_history"
 require_relative "schwab_rb/price_history/downloader"
+require_relative "schwab_rb/option_sample"
+require_relative "schwab_rb/option_sample/downloader"
 require_relative "schwab_rb/movers"
 require_relative "schwab_rb/orders/builder"
 require_relative "schwab_rb/orders/session"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: schwab_rb
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.9.0
 platform: ruby
 authors:
 - Joseph Platta
 bindir: exe
 cert_chain: []
-date: 2026-04-09 00:00:00.000000000 Z
+date: 2026-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -256,6 +256,8 @@ files:
 - lib/schwab_rb/market_hours.rb
 - lib/schwab_rb/movers.rb
 - lib/schwab_rb/option.rb
+- lib/schwab_rb/option_sample.rb
+- lib/schwab_rb/option_sample/downloader.rb
 - lib/schwab_rb/orders/builder.rb
 - lib/schwab_rb/orders/destination.rb
 - lib/schwab_rb/orders/duration.rb