eodhd.rb 0.14.2 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 44210fb44fe2ba7e5988aa8dc632eb795d2d758f29b004e9723e28564c65c4f5
-  data.tar.gz: 98581f3f62c684146b423f66f48bef85545ec335c9c831ac80dc41cccb925138
+  metadata.gz: 1400c119e7a404b5100e55d51234c2bde712e9227454799556191bcb96bc2923
+  data.tar.gz: ed91c5bc5a273e50f5462780c55529dd26bb5a98fa318747ccbb390b5d4b2228
 SHA512:
-  metadata.gz: 6021c0cbd10ac0c9d4527f5c08888159aba35ca0286679f041d13599387eb7bc4ee0826abe6b835f47ba1e333f3082c45fcedc9b16e58e641a949d7e864b79ea
-  data.tar.gz: 43a689fb9bcc2c83fc082090717bdf0defd1add686c9bb1b370bba6b60b70f2b4ac14cde375ada26f85d87e8726452b300be170b5f6354bd91638a6059bd8986
+  metadata.gz: 4e13b25610267151935b2e57d2367ed3274ba327d3edcee569b16ad5ac2a956671cebbf81e4146ff727a1b36522d53c6005e1c14c4ffbf4ce49342bf11f70878
+  data.tar.gz: 03e6404cc5fc0e7e58758dbb4086deb5039fd9807f3c26e350c4b7f33cbb4cf9e363e123b94f37ea394a5ee973e35616b83c1bbd426403e3e8de1fc9cee64d5f

data/eodhd.rb.gemspec

@@ -1,8 +1,10 @@
+require_relative './lib/Eodhd/VERSION'
+
 Gem::Specification.new do |spec|
   spec.name = 'eodhd.rb'
 
-  spec.version = '0.14.2'
-  spec.date = '2025-03-26'
+  spec.version = Eodhd::VERSION
+  spec.date = '2025-10-05'
 
   spec.summary = "Access the eodhd.com API with Ruby."
   spec.description = "Access the eodhd.com API with Ruby."
@@ -15,6 +17,15 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 2.5'
 
   spec.add_dependency('http.rb')
+  spec.add_dependency('iodine')
+
+  spec.add_development_dependency('rake')
+  spec.add_development_dependency('minitest')
+  spec.add_development_dependency('minitest-spec-context')
+  spec.add_development_dependency('webmock')
+  spec.add_development_dependency('vcr')
+  spec.add_development_dependency('simplecov')
+
   spec.files = [
     'eodhd.rb.gemspec',
     'Gemfile',

data/lib/Eodhd/Client.rb

@@ -1,14 +1,15 @@
 # Eodhd/Client.rb
 # Eodhd::Client
 
-require 'fileutils'
 gem 'http.rb'
+
 require 'http.rb'
 require 'json'
-require 'logger'
 
+require_relative './DefaultLogger'
 require_relative './Error'
 require_relative '../Hash/x_www_form_urlencode'
+require_relative './Validations'
 
 class Eodhd
   class Client
@@ -16,30 +17,13 @@ class Eodhd
     API_HOST = 'eodhd.com'
 
     class << self
-      attr_writer :log_file_path
-
       def path_prefix
         '/api'
       end
-
-      def default_log_file_path
-        File.join(%w{~ log eodhd log.txt})
-      end
-
-      def log_file_path
-        File.expand_path(@log_file_path || default_log_file_path)
-      end
-
-      def log_file
-        FileUtils.mkdir_p(File.dirname(log_file_path))
-        File.open(log_file_path, File::WRONLY | File::APPEND | File::CREAT)
-      end
-
-      def logger
-        @logger ||= Logger.new(log_file, 'daily')
-      end
     end # class << self
 
+    include Validations
+
     # This endpoint always returns json regardless of what fmt is specified.
     def exchanges_list
       response = get(path: '/exchanges-list')
@@ -47,11 +31,19 @@ class Eodhd
     end
 
     def exchange_symbol_list(exchange_code:)
+      validate_arguments(exchange_code: exchange_code)
       response = get(path: "/exchange-symbol-list/#{exchange_code}")
       handle_response(response)
     end
 
     def eod_data(exchange_id:, symbol:, period:, from: nil, to: nil)
+      validate_arguments(
+        exchange_id: exchange_id,
+        symbol: symbol,
+        period: period,
+        from: from,
+        to: to
+      )
       args = {period: period}
       args.merge!(from: from) if from
       args.merge!(to: to) if to
@@ -60,15 +52,21 @@ class Eodhd
     end
 
     def eod_bulk_last_day(exchange_id:, date:)
+      validate_arguments(exchange_id: exchange_id, date: date)
       args = {date: date}
       response = get(path: "/eod-bulk-last-day/#{exchange_id}", args: args)
       handle_response(response)
     end
 
+    attr_accessor\
+      :api_token,
+      :logger
+
     private
 
-    def initialize(api_token:)
+    def initialize(api_token: nil, logger: nil, use_default_logger: false)
       @api_token = api_token
+      @logger = use_default_logger ? DefaultLogger.logger : logger
     end
 
     def request_string(path)
@@ -84,19 +82,24 @@ class Eodhd
       if log_args?(args)
         log_string << "?#{args.x_www_form_urlencode}"
       end
-      self.class.logger.info(log_string)
+      @logger.info(log_string)
+    end
+
+    def log_response(code:, message:, body:)
+      log_string = "#{code}\n#{message}\n#{body}"
+      @logger.info(log_string)
     end
 
     def log_error(code:, message:, body:)
       log_string = "#{code}\n#{message}\n#{body}"
-      self.class.logger.error(log_string)
+      @logger.error(log_string)
     end
 
     def do_request(verb:, path:, args: {})
-      log_request(verb: verb, request_string: request_string(path), args: args)
       api_token = args[:api_token] || @api_token
       fmt = args[:fmt] || 'json'
       args.merge!(api_token: api_token, fmt: fmt)
+      log_request(verb: verb, request_string: request_string(path), args: args) if use_logging?
       HTTP.send(verb.to_s.downcase, request_string(path), args)
     end
 
@@ -106,19 +109,17 @@ class Eodhd
 
     def handle_response(response)
       if response.success?
-        JSON.parse(response.body)
+        parsed_body = JSON.parse(response.body)
+        log_response(code: response.code, message: response.message, body: response.body) if use_logging?
+        parsed_body
       else
-        log_error(
-          code: response.code,
-          message: response.message,
-          body: response.body
-        )
-        raise Eodhd::Error.new(
-          code: response.code,
-          message: response.message,
-          body: response.body
-        )
+        log_error(code: response.code, message: response.message, body: response.body) if use_logging?
+        raise Eodhd::Error.new(code: response.code, message: response.message, body: response.body)
       end
     end
+
+    def use_logging?
+      !@logger.nil?
+    end
   end
 end

data/lib/Eodhd/DefaultLogger.rb

@@ -0,0 +1,30 @@
+# Eodhd/DefaultLogger.rb
+# Eodhd::DefaultLogger
+
+require 'fileutils'
+require 'logger'
+
+class Eodhd
+  class DefaultLogger
+    class << self
+      attr_writer :log_filepath
+
+      def default_log_filepath
+        File.join(%w{~ log eodhd log.txt})
+      end
+
+      def log_filepath
+        File.expand_path(@log_filepath || default_log_filepath)
+      end
+
+      def log_file
+        FileUtils.mkdir_p(File.dirname(log_filepath))
+        File.open(log_filepath, File::WRONLY | File::APPEND | File::CREAT)
+      end
+
+      def logger
+        @logger ||= Logger.new(log_file, 'daily')
+      end
+    end
+  end
+end

data/lib/Eodhd/VERSION.rb

@@ -0,0 +1,3 @@
+class Eodhd
+  VERSION = '0.16.0'
+end

data/lib/Eodhd/Validations.rb

@@ -0,0 +1,69 @@
+# Eodhd/Validations.rb
+# Eodhd::Validations
+
+class Eodhd
+  module Validations
+    def validate_arguments(exchange_code: nil, exchange_id: nil, symbol: nil, period: nil, from: nil, to: nil, date: nil)
+      exchange_code ||= exchange_id
+      validate_exchange_code(exchange_code)
+      validate_symbol(symbol)
+      validate_period(period)
+      validate_date(from, 'from')
+      validate_date(to, 'to')
+      validate_date_range(from, to)
+    end
+
+    def validate_exchange_code(exchange_code)
+      return unless exchange_code
+      unless exchange_code.match?(/\A[A-Z]{2,6}\z/)
+        raise ArgumentError, "Invalid exchange_code '#{exchange_code}'. Must be 2-6 uppercase letters"
+      end
+    end
+
+    def validate_symbol(symbol)
+      return unless symbol
+      if symbol.strip.empty?
+        raise ArgumentError, "Symbol cannot be empty"
+      end
+      unless symbol.match?(/\A[A-Za-z0-9.-]{1,12}\z/)
+        raise ArgumentError, "Invalid symbol '#{symbol}'. Must be 1-12 characters, letters/numbers/dots/hyphens only"
+      end
+    end
+
+    def validate_period(period)
+      return unless period
+      valid_periods = %w[d w m]
+      unless valid_periods.include?(period)
+        raise ArgumentError, "Invalid period '#{period}'. Must be one of: #{valid_periods.join(', ')}"
+      end
+    end
+
+    def validate_date(date, param_name = 'date')
+      return unless date
+      case date
+      when Date
+        return
+      when String
+        unless date.match?(/\A\d{4}-\d{2}-\d{2}\z/)
+          raise ArgumentError, "Invalid #{param_name} '#{date}'. Must be in format 'yyyy-mm-dd'"
+        end
+        begin
+          Date.parse(date)
+        rescue Date::Error
+          raise ArgumentError, "Invalid #{param_name} '#{date}'. Not a valid date"
+        end
+      else
+        raise ArgumentError, "Invalid #{param_name}. Must be String in 'yyyy-mm-dd' format or Date object"
+      end
+    end
+
+    def validate_date_range(from, to)
+      return unless from && to
+      from_date = from.is_a?(Date) ? from : Date.parse(from.to_s)
+      to_date = to.is_a?(Date) ? to : Date.parse(to.to_s)
+      if from_date > to_date
+        raise ArgumentError, "from date (#{from}) cannot be after to date (#{to})"
+      end
+    end
+  end
+end

data/lib/Eodhd/WebSocketClient.rb

@@ -9,41 +9,23 @@
 #   iv.  Crypto: wss://ws.eodhistoricaldata.com/ws/crypto?api_token=XXX
 
 require 'iodine'
-require 'json' # This line doesn't seem to be necessary in Ruby 3.
+require 'json'
+
+require_relative './DefaultLogger'
+require_relative './Error'
 
 class Eodhd
   class WebSocketClient
     API_HOST = 'ws.eodhistoricaldata.com'
 
     class Handler
-      class << self
-        attr_writer :log_file_path
-
-        def default_log_file_path
-          File.join(%w{~ log eodhd log.txt})
-        end
-
-        def log_file_path
-          File.expand_path(@log_file_path || default_log_file_path)
-        end
-
-        def log_file
-          FileUtils.mkdir_p(File.dirname(log_file_path))
-          File.open(log_file_path, File::WRONLY | File::APPEND | File::CREAT)
-        end
-
-        def logger
-          @logger ||= Logger.new(log_file, 'daily')
-        end
-      end # class << self
-
       def on_open(connection)
         connection.write({action: 'subscribe', symbols: @symbols}.to_json)
       end
 
       def on_message(connection, message)
         dataframe = handle_response(message)
-        @consumer.call(dataframe)
+        @consumer.call(dataframe) if @consumer
       end
 
       def on_close(connection)
@@ -52,29 +34,26 @@ class Eodhd
 
       private
 
-      def initialize(symbols:, consumer:)
+      def initialize(symbols:, consumer:, logger: nil)
         @symbols = symbols
         @consumer = consumer
+        @logger = logger
       end
 
       def log_error(code:, message:, body:)
         log_string = "WebSocketError #{code}\n#{message}\n#{body}"
-        self.class.logger.error(log_string)
+        @logger.error(log_string) if use_logging?
       end
 
       def handle_response(message)
-        if parsed_json = JSON.parse(message)
-          parsed_json
-        else
-          log_error(
-            message: response.message,
-          )
-          raise Eodhd::Error.new(
-            code: 'ws',
-            message: response.message,
-            body: ''
-          )
-        end
+        JSON.parse(message)
+      rescue StandardError => e
+        log_error(code: 'ws_parse_error', message: e.message, body: message)
+        raise Eodhd::Error.new(code: 'ws_parse_error', message: e.message, body: message)
+      end
+
+      def use_logging?
+        !@logger.nil?
       end
     end
 
@@ -104,7 +83,8 @@ class Eodhd
     attr_accessor\
       :api_token,
       :asset_class,
-      :consumer
+      :consumer,
+      :logger
 
     attr_reader\
       :symbols
@@ -115,7 +95,7 @@ class Eodhd
 
     def run
       Iodine.threads = 1
-      Iodine.connect(url: url, handler: Handler.new(symbols: @symbols, consumer: @consumer))
+      Iodine.connect(url: url, handler: Handler.new(symbols: @symbols, consumer: @consumer, logger: @logger))
       Iodine.start
     rescue SystemExit, Interrupt
       return
@@ -123,11 +103,16 @@ class Eodhd
 
     private
 
-    def initialize(api_token:, asset_class:, symbols:, consumer:)
+    def initialize(api_token:, asset_class:, symbols:, consumer:, logger: nil, use_default_logger: false)
       @api_token = api_token
       @asset_class = asset_class # crypto, forex, us-quote, us
       @symbols = format_symbols(symbols)
       @consumer = consumer
+      @logger = use_default_logger ? DefaultLogger.logger : logger
+    end
+
+    def use_logging?
+      !@logger.nil?
     end
 
     def format_symbols(symbols)

data/lib/{eodhd.rb → Eodhd.rb}

@@ -1,32 +1,12 @@
 # Eodhd.rb
 # Eodhd
 
-# 20250326
-# 0.14.2
-
-# Changes since 0.13:
-# -/0: Add WebSockets.
-# 1. + Eodhd::WebSocketClient
-# 2. + Eodhd#web_socket
-# 3. + Eodhd#stream
-# 4. + Eodhd#us_quote_stream
-# 5. + Eodhd#us_trade_stream
-# 6. + Eodhd#forex_stream
-# 7. + Eodhd#crypto_stream
-# 8. Moved Eodhd::Error from Eodhd::Client to a separate file.
-# 0/1: Some fixes for the WebSocketClient interface.
-# 9. ~ Eodhd::WebSocketClient: + attr_accessor :consumer
-# 10. ~ Eodhd::WebSocketClient: /attr_accessor :symbols/attr_reader :symbols/
-# 11. + Eodhd::WebSocketClient#symbols=
-# 1/2: Remove reference to currently unused library UnixTime.
-# 12. ~ Eodhd::WebSocketClient: - require 'UnixTime'
-
-require_relative 'Eodhd/Client'
-require_relative 'Eodhd/EodBulkLastDay'
-require_relative 'Eodhd/EodData'
-require_relative 'Eodhd/Exchange'
-require_relative 'Eodhd/ExchangeSymbol'
-require_relative 'Eodhd/WebSocketClient'
+require_relative './Eodhd/Client'
+require_relative './Eodhd/EodBulkLastDay'
+require_relative './Eodhd/EodData'
+require_relative './Eodhd/Exchange'
+require_relative './Eodhd/ExchangeSymbol'
+require_relative './Eodhd/WebSocketClient'
 
 class Eodhd
   def initialize(api_token:, consumer: nil)

data/test/client_test.rb

@@ -0,0 +1,71 @@
+require_relative "helper"
+
+describe Eodhd::Client do
+  let(:api_token){ENV.fetch('EODHD_API_TOKEN', '<API_TOKEN>')}
+
+  let(:client){Eodhd::Client.new(api_token: api_token)}
+
+  describe "#exchanges_list" do
+    it "exchanges_list returns parsed JSON array" do
+      VCR.use_cassette("client_exchanges_list") do
+        result = client.exchanges_list
+        _(result).must_be_kind_of(Array)
+        _(result.first["Code"]).wont_be_nil
+      end
+    end
+
+    it "raises Eodhd::Error on failure" do
+      VCR.use_cassette("client_exchanges_list_401_error") do
+        _{client.exchanges_list}.must_raise(Eodhd::Error)
+      end
+    end
+  end
+
+  describe "#exchange_symbol_list" do
+    it "exchange_symbol_list returns parsed JSON array" do
+      VCR.use_cassette("client_exchange_symbol_list") do
+        result = client.exchange_symbol_list(exchange_code: 'AU')
+        _(result).must_be_kind_of(Array)
+        _(result.first['Code']).wont_be_nil
+      end
+    end
+
+    it "raises Eodhd::Error on failure" do
+      VCR.use_cassette("client_exchange_symbol_list_401_error") do
+        _{client.exchange_symbol_list(exchange_code: 'AU')}.must_raise(Eodhd::Error)
+      end
+    end
+  end
+
+  describe "#eod_data" do
+    it "eod_data returns parsed JSON array" do
+      VCR.use_cassette('client_eod_data') do
+        result = client.eod_data(exchange_id: 'AU', symbol: 'BHP', period: 'd')
+        _(result).must_be_kind_of(Array)
+        _(result.first.keys).must_equal(%w{date open high low close adjusted_close volume})
+      end
+    end
+
+    it "raises Eodhd::Error on failure" do
+      VCR.use_cassette('client_eod_data_401_error') do
+        _{client.eod_data(exchange_id: 'AU', symbol: 'BHP', period: 'd')}.must_raise(Eodhd::Error)
+      end
+    end
+  end
+
+  describe "#eod_bulk_last_day" do
+    it "eod_bulk_last_day returns parsed JSON array" do
+      VCR.use_cassette("client_eod_bulk_last_day") do
+        result = client.eod_bulk_last_day(exchange_id: 'AU', date: "2024-09-30")
+        _(result).must_be_kind_of(Array)
+        _(result.first.keys).must_equal(%w{code exchange_short_name date open high low close adjusted_close volume})
+      end
+    end
+
+    it "raises Eodhd::Error on failure" do
+      VCR.use_cassette('client_eod_bulk_last_day_401_error') do
+        _{client.eod_bulk_last_day(exchange_id: 'AU', date: "2024-09-30")}.must_raise(Eodhd::Error)
+      end
+    end
+  end
+end

data/test/eodhd_test.rb

@@ -0,0 +1,50 @@
+require_relative "helper"
+
+describe Eodhd do
+  let(:api_token){ENV.fetch('EODHD_API_TOKEN', '<API_TOKEN>')}
+  let(:eodhd){Eodhd.new(api_token: api_token)}
+
+  describe "#exchanges" do
+    it "delegates to Eodhd::Exchange.all" do
+      VCR.use_cassette('eodhd_exchanges') do
+        exchanges = eodhd.exchanges
+        _(exchanges).must_be_kind_of(Array)
+        _(exchanges).wont_be_empty
+        _(exchanges.first).must_be_kind_of(Eodhd::Exchange)
+      end
+    end
+  end
+
+  describe "#exchange_symbols" do
+    it "delegates to Eodhd::ExchangeSymbol.all" do
+      VCR.use_cassette('eodhd_exchange_symbols') do
+        symbols = eodhd.exchange_symbols(exchange_code: 'AU')
+        _(symbols).must_be_kind_of(Array)
+        _(symbols).wont_be_empty
+        _(symbols.first).must_be_kind_of(Eodhd::ExchangeSymbol)
+      end
+    end
+  end
+
+  describe "#eod_data" do
+    it "delegates to Eodhd::EodData.all" do
+      VCR.use_cassette('eodhd_eod_data') do
+        eod_data = eodhd.eod_data(exchange_code: 'AU', symbol: 'BHP', period: 'd')
+        _(eod_data).must_be_kind_of(Array)
+        _(eod_data).wont_be_empty
+        _(eod_data.first).must_be_kind_of(Eodhd::EodData)
+      end
+    end
+  end
+
+  describe "#eod_bulk_last_day" do
+    it "delegates to Eodhd::EodBulkLastDay.all" do
+      VCR.use_cassette('eodhd_eod_bulk_last_day') do
+        bulk_last_day = eodhd.eod_bulk_last_day(exchange_code: 'AU', date: '2024-09-30')
+        _(bulk_last_day).must_be_kind_of(Array)
+        _(bulk_last_day).wont_be_empty
+        _(bulk_last_day.first).must_be_kind_of(Eodhd::EodBulkLastDay)
+      end
+    end
+  end
+end

data/test/helper.rb

@@ -0,0 +1,14 @@
+require 'minitest/autorun'
+require 'minitest/spec'
+require 'minitest-spec-context'
+require 'vcr'
+require 'webmock/minitest'
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require 'Eodhd'
+
+VCR.configure do |config|
+  config.cassette_library_dir = File.expand_path('./fixtures/vcr_cassettes', __dir__)
+  config.hook_into :webmock
+  config.filter_sensitive_data('<API_TOKEN>'){ENV['EODHD_API_TOKEN']}
+end

data/test/test_all.rb

@@ -0,0 +1,5 @@
+require_relative "helper"
+
+Dir[File.expand_path("./**/*_test.rb", __dir__)].each do |file|
+  require file
+end

data/test/validations_test.rb

@@ -0,0 +1,118 @@
+require_relative 'helper'
+
+class DummyIncludingValidations
+  include Eodhd::Validations
+end
+
+describe "Eodhd::Validations" do
+  let(:v){DummyIncludingValidations.new}
+
+  describe "#validate_arguments" do
+    it "accepts all valid arguments" do
+      _{v.validate_arguments(
+        exchange_code: 'AU',
+        symbol: 'BHP',
+        period: 'd',
+        from: '2024-01-01',
+        to: '2024-12-31'
+      )}.must_be_silent
+    end
+
+    it "accepts exchange_id as alias for exchange_code" do
+      _{v.validate_arguments(exchange_id: 'AU')}.must_be_silent
+    end
+
+    it "raises ArgumentError for invalid exchange_code" do
+      _{v.validate_arguments(exchange_code: 'au')}.must_raise(ArgumentError)
+    end
+
+    it "raises ArgumentError for invalid symbol" do
+      _{v.validate_arguments(symbol: 'bad$')}.must_raise(ArgumentError)
+    end
+
+    it "raises ArgumentError for invalid period" do
+      _{v.validate_arguments(period: 'h')}.must_raise(ArgumentError)
+    end
+
+    it "raises ArgumentError for invalid from date" do
+      _{v.validate_arguments(from: '2024/01/01')}.must_raise(ArgumentError)
+    end
+
+    it "raises ArgumentError for invalid to date" do
+      _{v.validate_arguments(to: '2024-02-30')}.must_raise(ArgumentError)
+    end
+
+    it "raises ArgumentError for reversed date range" do
+      _{v.validate_arguments(from: '2024-12-31', to: '2024-01-01')}.must_raise(ArgumentError)
+    end
+
+    it "accepts nil values for all arguments" do
+      _{v.validate_arguments}.must_be_silent
+    end
+  end
+
+  describe "#validate_exchange_code" do
+    it "accepts valid exchange codes" do
+      _{v.validate_exchange_code('AU')}.must_be_silent
+      _{v.validate_exchange_code('XETRA')}.must_be_silent
+    end
+
+    it "rejects invalid exchange codes" do
+      _{v.validate_exchange_code('us')}.must_raise(ArgumentError)
+      _{v.validate_exchange_code('U')}.must_raise(ArgumentError)
+      _{v.validate_exchange_code('TOOLONG')}.must_raise(ArgumentError)
+    end
+  end
+
+  describe "#validate_symbol" do
+    it "accepts valid symbols" do
+      _{v.validate_symbol('AAPL')}.must_be_silent
+      _{v.validate_symbol('BRK.B')}.must_be_silent
+      _{v.validate_symbol('RDS-A')}.must_be_silent
+    end
+
+    it "rejects invalid symbols" do
+      _{v.validate_symbol('')}.must_raise(ArgumentError)
+      _{v.validate_symbol(' ')}.must_raise(ArgumentError)
+      _{v.validate_symbol('THIS_SYMBOL_IS_TOO_LONG')}.must_raise(ArgumentError)
+      _{v.validate_symbol('bad$')}.must_raise(ArgumentError)
+    end
+  end
+
+  describe "#validate_period" do
+    it "accepts valid periods" do
+      _{v.validate_period('d')}.must_be_silent
+      _{v.validate_period('w')}.must_be_silent
+      _{v.validate_period('m')}.must_be_silent
+    end
+
+    it "rejects invalid periods" do
+      _{v.validate_period('h')}.must_raise(ArgumentError)
+      _{v.validate_period('')}.must_raise(ArgumentError)
+    end
+  end
+
+  describe "#validate_date" do
+    it "accepts valid date formats and Date objects" do
+      _{v.validate_date('2024-09-30')}.must_be_silent
+      _{v.validate_date(Date.new(2024,9,30))}.must_be_silent
+    end
+
+    it "rejects invalid dates and formats" do
+      _{v.validate_date('2024/09/30')}.must_raise(ArgumentError)
+      _{v.validate_date('2024-02-30')}.must_raise(ArgumentError)
+      _{v.validate_date(12345)}.must_raise(ArgumentError)
+    end
+  end
+
+  describe "#validate_date_range" do
+    it "accepts valid date ranges" do
+      _{v.validate_date_range('2024-01-01','2024-12-31')}.must_be_silent
+      _{v.validate_date_range(Date.new(2024,1,1),Date.new(2024,12,31))}.must_be_silent
+    end
+
+    it "rejects reversed date ranges" do
+      _{v.validate_date_range('2024-12-31','2024-01-01')}.must_raise(ArgumentError)
+    end
+  end
+end

data/test/web_socket_client_test.rb

@@ -0,0 +1,97 @@
+require_relative 'helper'
+
+describe Eodhd::WebSocketClient do
+  let(:api_token){ENV.fetch('EODHD_API_TOKEN', '<API_TOKEN>')}
+  let(:consumer){->(data){}}
+
+  describe "#initialize" do
+    it "accepts array of symbols and formats to comma-separated string" do
+      client = Eodhd::WebSocketClient.new(api_token: api_token, asset_class: 'us', symbols: ['AAPL', 'MSFT'], consumer: consumer)
+      _(client.symbols).must_equal('AAPL,MSFT')
+    end
+
+    it "accepts string of symbols" do
+      client = Eodhd::WebSocketClient.new(api_token: api_token, asset_class: 'us', symbols: 'AAPL,MSFT', consumer: consumer)
+      _(client.symbols).must_equal('AAPL,MSFT')
+    end
+  end
+
+  describe "#url" do
+    it "generates correct URL for US trade stream" do
+      client = Eodhd::WebSocketClient.new(api_token: api_token, asset_class: 'us', symbols: 'AAPL', consumer: consumer)
+      _(client.send(:url)).must_equal("wss://ws.eodhistoricaldata.com/ws/us?api_token=#{api_token}")
+    end
+
+    it "generates correct URL for US quote stream" do
+      client = Eodhd::WebSocketClient.new(api_token: api_token, asset_class: 'us-quote', symbols: 'AAPL', consumer: consumer)
+      _(client.send(:url)).must_equal("wss://ws.eodhistoricaldata.com/ws/us-quote?api_token=#{api_token}")
+    end
+
+    it "generates correct URL for forex stream" do
+      client = Eodhd::WebSocketClient.new(api_token: api_token, asset_class: 'forex', symbols: 'EURUSD', consumer: consumer)
+      _(client.send(:url)).must_equal("wss://ws.eodhistoricaldata.com/ws/forex?api_token=#{api_token}")
+    end
+
+    it "generates correct URL for crypto stream" do
+      client = Eodhd::WebSocketClient.new(api_token: api_token, asset_class: 'crypto', symbols: 'BTC-USD', consumer: consumer)
+      _(client.send(:url)).must_equal("wss://ws.eodhistoricaldata.com/ws/crypto?api_token=#{api_token}")
+    end
+  end
+
+  describe "#format_symbols" do
+    it "converts array to comma-separated string" do
+      client = Eodhd::WebSocketClient.new(api_token: api_token, asset_class: 'us', symbols: ['AAPL', 'MSFT', 'GOOGL'], consumer: consumer)
+      _(client.symbols).must_equal('AAPL,MSFT,GOOGL')
+    end
+
+    it "returns string as-is" do
+      client = Eodhd::WebSocketClient.new(api_token: api_token, asset_class: 'us', symbols: 'AAPL,MSFT', consumer: consumer)
+      _(client.symbols).must_equal('AAPL,MSFT')
+    end
+  end
+
+  describe "#run" do
+    it "configures Iodine and starts connection" do
+      client = Eodhd::WebSocketClient.new(api_token: api_token, asset_class: 'us', symbols: 'AAPL', consumer: consumer)
+      
+      iodine_connect_called = false
+      iodine_start_called = false
+      
+      Iodine.stub(:threads=, nil) do
+        Iodine.stub(:connect, ->(opts){iodine_connect_called = true}) do
+          Iodine.stub(:start, ->{iodine_start_called = true}) do
+            client.run
+          end
+        end
+      end
+      
+      _(iodine_connect_called).must_equal(true)
+      _(iodine_start_called).must_equal(true)
+    end
+  end
+
+  describe "Handler" do
+    describe "#on_message" do
+      it "parses JSON and calls consumer" do
+        received_data = nil
+        test_consumer = ->(data){received_data = data}
+        handler = Eodhd::WebSocketClient::Handler.new(symbols: 'AAPL', consumer: test_consumer, logger: nil)
+        
+        message = '{"symbol":"AAPL","price":150.0}'
+        handler.on_message(nil, message)
+        
+        _(received_data).must_be_kind_of(Hash)
+        _(received_data['symbol']).must_equal('AAPL')
+        _(received_data['price']).must_equal(150.0)
+      end
+
+      it "raises Eodhd::Error on invalid JSON" do
+        test_consumer = ->(data){}
+        handler = Eodhd::WebSocketClient::Handler.new(symbols: 'AAPL', consumer: test_consumer, logger: nil)
+        
+        invalid_message = '{invalid json'
+        _{handler.on_message(nil, invalid_message)}.must_raise(Eodhd::Error)
+      end
+    end
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: eodhd.rb
 version: !ruby/object:Gem::Version
-  version: 0.14.2
+  version: 0.16.0
 platform: ruby
 authors:
 - thoran
 bindir: bin
 cert_chain: []
-date: 2025-03-26 00:00:00.000000000 Z
+date: 2025-10-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http.rb
@@ -23,6 +23,104 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: iodine
+  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: 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: minitest
+  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: minitest-spec-context
+  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: webmock
+  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: vcr
+  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: simplecov
+  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: Access the eodhd.com API with Ruby.
 email: code@thoran.com
 executables: []
@@ -32,17 +130,26 @@ files:
 - Gemfile
 - README.md
 - eodhd.rb.gemspec
+- lib/Eodhd.rb
 - lib/Eodhd/Client.rb
+- lib/Eodhd/DefaultLogger.rb
 - lib/Eodhd/EodBulkLastDay.rb
 - lib/Eodhd/EodData.rb
 - lib/Eodhd/Error.rb
 - lib/Eodhd/Exchange.rb
 - lib/Eodhd/ExchangeSymbol.rb
+- lib/Eodhd/VERSION.rb
+- lib/Eodhd/Validations.rb
 - lib/Eodhd/WebSocketClient.rb
 - lib/Hash/x_www_form_urlencode.rb
 - lib/Thoran/Hash/XWwwFormUrlencode/x_www_form_urlencode.rb
 - lib/Thoran/String/UrlEncode/url_encode.rb
-- lib/eodhd.rb
+- test/client_test.rb
+- test/eodhd_test.rb
+- test/helper.rb
+- test/test_all.rb
+- test/validations_test.rb
+- test/web_socket_client_test.rb
 homepage: http://github.com/thoran/eodhd.rb
 licenses:
 - Ruby
@@ -61,7 +168,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.6
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Access the eodhd.com API with Ruby.
 test_files: []