eodhd.rb 0.17.0 → 0.18.1

data/lib/Eodhd/Fundamentals/Holders.rb

@@ -0,0 +1,19 @@
+# Eodhd/Fundamentals/Holders.rb
+# Eodhd::Fundamentals::Holders
+
+class Eodhd
+  class Fundamentals
+    class Holders
+      attr_reader\
+        :institutions,
+        :funds
+
+      private
+
+      def initialize(data)
+        @institutions = data['Institutions']
+        @funds = data['Funds']
+      end
+    end
+  end
+end

data/lib/Eodhd/Fundamentals/SharesStats.rb

@@ -0,0 +1,33 @@
+# Eodhd/Fundamentals/SharesStats.rb
+# Eodhd::Fundamentals::SharesStats
+
+class Eodhd
+  class Fundamentals
+    class SharesStats
+      attr_reader\
+        :shares_outstanding,
+        :shares_float,
+        :percent_insiders,
+        :percent_institutions,
+        :shares_short,
+        :shares_short_prior_month,
+        :short_ratio,
+        :short_percent_outstanding,
+        :short_percent_float
+
+      private
+
+      def initialize(data)
+        @shares_outstanding = data['SharesOutstanding']
+        @shares_float = data['SharesFloat']
+        @percent_insiders = data['PercentInsiders']
+        @percent_institutions = data['PercentInstitutions']
+        @shares_short = data['SharesShort']
+        @shares_short_prior_month = data['SharesShortPriorMonth']
+        @short_ratio = data['ShortRatio']
+        @short_percent_outstanding = data['ShortPercentOutstanding']
+        @short_percent_float = data['ShortPercentFloat']
+      end
+    end
+  end
+end

data/lib/Eodhd/Fundamentals/SplitsDividends.rb

@@ -0,0 +1,31 @@
+# Eodhd/Fundamentals/SplitsDividends.rb
+# Eodhd::Fundamentals::SplitsDividends
+
+class Eodhd
+  class Fundamentals
+    class SplitsDividends
+      attr_reader\
+        :forward_annual_dividend_rate,
+        :forward_annual_dividend_yield,
+        :payout_ratio,
+        :dividend_date,
+        :ex_dividend_date,
+        :last_split_factor,
+        :last_split_date,
+        :number_dividends_by_year
+
+      private
+
+      def initialize(data)
+        @forward_annual_dividend_rate = data['ForwardAnnualDividendRate']
+        @forward_annual_dividend_yield = data['ForwardAnnualDividendYield']
+        @payout_ratio = data['PayoutRatio']
+        @dividend_date = data['DividendDate']
+        @ex_dividend_date = data['ExDividendDate']
+        @last_split_factor = data['LastSplitFactor']
+        @last_split_date = data['LastSplitDate']
+        @number_dividends_by_year = data['NumberDividendsByYear']
+      end
+    end
+  end
+end

data/lib/Eodhd/Fundamentals/Technicals.rb

@@ -0,0 +1,33 @@
+# Eodhd/Fundamentals/Technicals.rb
+# Eodhd::Fundamentals::Technicals
+
+class Eodhd
+  class Fundamentals
+    class Technicals
+      attr_reader\
+        :beta,
+        :fifty_two_week_high,
+        :fifty_two_week_low,
+        :fifty_day_ma,
+        :two_hundred_day_ma,
+        :shares_short,
+        :shares_short_prior_month,
+        :short_ratio,
+        :short_percent
+
+      private
+
+      def initialize(data)
+        @beta = data['Beta']
+        @fifty_two_week_high = data['52WeekHigh']
+        @fifty_two_week_low = data['52WeekLow']
+        @fifty_day_ma = data['50DayMA']
+        @two_hundred_day_ma = data['200DayMA']
+        @shares_short = data['SharesShort']
+        @shares_short_prior_month = data['SharesShortPriorMonth']
+        @short_ratio = data['ShortRatio']
+        @short_percent = data['ShortPercent']
+      end
+    end
+  end
+end

data/lib/Eodhd/Fundamentals/Valuation.rb

@@ -0,0 +1,29 @@
+# Eodhd/Fundamentals/Valuation.rb
+# Eodhd::Fundamentals::Valuation
+
+class Eodhd
+  class Fundamentals
+    class Valuation
+      attr_reader\
+        :trailing_pe,
+        :forward_pe,
+        :price_sales_ttm,
+        :price_book_mrq,
+        :enterprise_value,
+        :enterprise_value_revenue,
+        :enterprise_value_ebitda
+
+      private
+
+      def initialize(data)
+        @trailing_pe = data['TrailingPE']
+        @forward_pe = data['ForwardPE']
+        @price_sales_ttm = data['PriceSalesTTM']
+        @price_book_mrq = data['PriceBookMRQ']
+        @enterprise_value = data['EnterpriseValue']
+        @enterprise_value_revenue = data['EnterpriseValueRevenue']
+        @enterprise_value_ebitda = data['EnterpriseValueEbitda']
+      end
+    end
+  end
+end

data/lib/Eodhd/Fundamentals.rb

@@ -0,0 +1,85 @@
+# Eodhd/Fundamentals.rb
+# Eodhd::Fundamentals
+
+require_relative './Fundamentals/AnalystRatings'
+require_relative './Fundamentals/Earnings'
+require_relative './Fundamentals/ESGScores'
+require_relative './Fundamentals/Financials'
+require_relative './Fundamentals/General'
+require_relative './Fundamentals/Highlights'
+require_relative './Fundamentals/Holders'
+require_relative './Fundamentals/SharesStats'
+require_relative './Fundamentals/SplitsDividends'
+require_relative './Fundamentals/Technicals'
+require_relative './Fundamentals/Valuation'
+
+class Eodhd
+  class Fundamentals
+    class << self
+      def all(client: nil, api_token: nil, exchange_code:, symbol:, filter: nil)
+        load(client: client, api_token: api_token, exchange_code: exchange_code, symbol: symbol, filter: filter)
+      end
+
+      private
+
+      def load(client: nil, api_token: nil, exchange_code:, symbol:, filter:)
+        client ||= Client.new(api_token: api_token)
+        response = client.fundamentals(exchange_code: exchange_code, symbol: symbol, filter: filter)
+        self.new(
+          exchange_code: exchange_code,
+          symbol: symbol,
+          general: response['General'],
+          highlights: response['Highlights'],
+          valuation: response['Valuation'],
+          shares_stats: response['SharesStats'],
+          technicals: response['Technicals'],
+          splits_dividends: response['SplitsDividends'],
+          analyst_ratings: response['AnalystRatings'],
+          holders: response['Holders'],
+          insider_transactions: response['InsiderTransactions'],
+          esg_scores: response['ESGScores'],
+          outstanding_shares: response['outstandingShares'],
+          earnings: response['Earnings'],
+          financials: response['Financials']
+        )
+      end
+    end # class << self
+
+    attr_reader\
+      :exchange_code,
+      :symbol,
+      :general,
+      :highlights,
+      :valuation,
+      :shares_stats,
+      :technicals,
+      :splits_dividends,
+      :analyst_ratings,
+      :holders,
+      :insider_transactions,
+      :esg_scores,
+      :outstanding_shares,
+      :earnings,
+      :financials
+
+    private
+
+    def initialize(exchange_code:, symbol:, general:, highlights:, valuation:, shares_stats:, technicals:, splits_dividends:, analyst_ratings:, holders:, insider_transactions:, esg_scores:, outstanding_shares:, earnings:, financials:)
+      @exchange_code = exchange_code
+      @symbol = symbol
+      @general = General.new(general) if general
+      @highlights = Highlights.new(highlights) if highlights
+      @valuation = Valuation.new(valuation) if valuation
+      @shares_stats = SharesStats.new(shares_stats) if shares_stats
+      @technicals = Technicals.new(technicals) if technicals
+      @splits_dividends = SplitsDividends.new(splits_dividends) if splits_dividends
+      @analyst_ratings = AnalystRatings.new(analyst_ratings) if analyst_ratings
+      @holders = Holders.new(holders) if holders
+      @insider_transactions = insider_transactions
+      @esg_scores = ESGScores.new(esg_scores) if esg_scores
+      @outstanding_shares = outstanding_shares
+      @earnings = Earnings.new(earnings) if earnings
+      @financials = Financials.new(financials) if financials
+    end
+  end
+end

data/lib/Eodhd/VERSION.rb

@@ -1,3 +1,3 @@
 class Eodhd
-  VERSION = '0.17.0'
+  VERSION = '0.18.1'
 end

data/lib/Thoran/Hash/XWwwFormUrlencode/x_www_form_urlencode.rb

@@ -1,26 +1,27 @@
-# Thoran/Hash/XWwwFormUrlEncode/x_www_form_urlencode.rb
-# Thoran::Hash::XWwwFormUrlEncode#x_www_form_urlencode
+# Thoran/Hash/XWwwFormUrlencode/x_www_form_urlencode.rb
+# Thoran::Hash::XWwwFormUrlencode#x_www_form_urlencode
 
-# 20241009
-# 0.2.0
+# 20260713
+# 0.3.0
 
-# Changes since 0.1:
-# -/0: (The class name and the snake case name are consistent now.)
-# 1. /XWWWFormUrlEncode/XWwwFormUrlEncode/
+# Changes since 0.2:
+# -/0: (The class name and the snake case name really are consistent now.)
+# 1. /XWwwFormUrlEncode/XWwwFormUrlencode/
+# 2. /url_encode/urlencode/
 
-require 'Thoran/String/UrlEncode/url_encode'
+require 'Thoran/String/Urlencode/urlencode'
 
 module Thoran
   module Hash
-    module XWwwFormUrlEncode
+    module XWwwFormUrlencode
 
-      def x_www_form_url_encode(joiner = '&')
-        inject([]){|a,e| a << "#{e.first.to_s.url_encode}=#{e.last.to_s.url_encode}" unless e.last.nil?; a}.join(joiner)
+      def x_www_form_urlencode(joiner = '&')
+        inject([]){|a,e| a << "#{e.first.to_s.urlencode}=#{e.last.to_s.urlencode}" unless e.last.nil?; a}.join(joiner)
       end
-      alias_method :x_www_form_urlencode, :x_www_form_url_encode
+      alias_method :x_www_form_url_encode, :x_www_form_urlencode
 
     end
   end
 end
 
-Hash.send(:include, Thoran::Hash::XWwwFormUrlEncode)
+Hash.send(:include, Thoran::Hash::XWwwFormUrlencode)

data/lib/Thoran/String/Urlencode/urlencode.rb

@@ -0,0 +1,29 @@
+# Thoran/String/Urlencode/urlencode.rb
+# Thoran::String::Urlencode#urlencode
+
+# 20260713
+# 0.4.0
+
+# Acknowledgements: I've simply ripped off and refashioned the code from the CGI module!...
+
+# Changes since 0.3:
+# -/0: More consistent naming.
+# 1. /UrlEncode/Urlencode/
+# 2. /url_encode/urlencode/
+
+module Thoran
+  module String
+    module Urlencode
+
+      def urlencode
+        self.gsub(/([^ a-zA-Z0-9_.-]+)/n) do
+          '%' + $1.unpack('H2' * $1.size).join('%').upcase
+        end.tr(' ', '+')
+      end
+      alias_method :url_encode, :urlencode
+
+    end
+  end
+end
+
+String.send(:include, Thoran::String::Urlencode)

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

@@ -7,45 +7,40 @@ require_relative './Eodhd/EodData'
 require_relative './Eodhd/Exchange'
 require_relative './Eodhd/ExchangeSymbol'
 require_relative './Eodhd/Intraday'
+require_relative './Eodhd/Fundamentals'
 require_relative './Eodhd/WebSocketClient'
 
 class Eodhd
-  def initialize(api_token:, consumer: nil)
-    @api_token = api_token
-    @consumer = consumer
-  end
-
   def exchanges
     Eodhd::Exchange.all(api_token: @api_token)
   end
 
   def exchange_symbols(exchange: nil, exchange_code: nil)
-    exchange_code ||= exchange.code
+    exchange_code ||= exchange&.code
     Eodhd::ExchangeSymbol.all(api_token: @api_token, exchange_code: exchange_code)
   end
 
   def eod_data(exchange: nil, exchange_code: nil, exchange_symbol: nil, symbol: nil, period: nil, from: nil, to: nil)
-    exchange_code ||= exchange.code
-    symbol ||= exchange_symbol.code
+    exchange_code ||= exchange&.code
+    symbol ||= exchange_symbol&.code
     Eodhd::EodData.all(api_token: @api_token, exchange_code: exchange_code, symbol: symbol, period: period, from: from, to: to)
   end
 
   def eod_bulk_last_day(exchange: nil, exchange_code: nil, date:)
-    exchange_code ||= exchange.code
+    exchange_code ||= exchange&.code
     Eodhd::EodBulkLastDay.all(api_token: @api_token, exchange_code: exchange_code, date: date)
   end
 
-  def intraday(exchange: nil, exchange_code: nil, symbol:, interval:, from: nil, to: nil)
-    exchange_code ||= exchange&.code || 'US'
+  def intraday(exchange: nil, exchange_code: nil, exchange_symbol: nil, symbol: nil, interval:, from: nil, to: nil)
+    exchange_code ||= exchange&.code
+    symbol ||= exchange_symbol&.code
     Eodhd::Intraday.all(api_token: @api_token, exchange_code: exchange_code, symbol: symbol, interval: interval, from: from, to: to)
   end
 
-  def web_socket(asset_class:, symbols:)
-    Eodhd::WebSocketClient.new(api_token: @api_token, asset_class: asset_class, symbols: symbols, consumer: @consumer)
-  end
-
-  def stream(asset_class:, symbols:)
-    web_socket(asset_class: asset_class, symbols: symbols).run
+  def fundamentals(exchange: nil, exchange_code: nil, exchange_symbol: nil, symbol: nil, filter: nil)
+    exchange_code ||= exchange&.code
+    symbol ||= exchange_symbol&.code
+    Eodhd::Fundamentals.all(api_token: @api_token, exchange_code: exchange_code, symbol: symbol, filter: filter)
   end
 
   def us_trade_stream(symbols)
@@ -64,4 +59,19 @@ class Eodhd
   def crypto_stream(symbols)
     stream(asset_class: 'crypto', symbols: symbols)
   end
+
+  private
+
+  def initialize(api_token:, consumer: nil)
+    @api_token = api_token
+    @consumer = consumer
+  end
+
+  def web_socket(asset_class:, symbols:)
+    Eodhd::WebSocketClient.new(api_token: @api_token, asset_class: asset_class, symbols: symbols, consumer: @consumer)
+  end
+
+  def stream(asset_class:, symbols:)
+    web_socket(asset_class: asset_class, symbols: symbols).run
+  end
 end

data/test/{client_test.rb → Eodhd/Client_test.rb}

@@ -1,12 +1,13 @@
-require_relative "helper"
+# Eodhd/Client_test.rb
+
+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
+    it "returns parsed JSON array" do
       VCR.use_cassette("client_exchanges_list") do
         result = client.exchanges_list
         _(result).must_be_kind_of(Array)
@@ -22,7 +23,7 @@ describe Eodhd::Client do
   end
 
   describe "#exchange_symbol_list" do
-    it "exchange_symbol_list returns parsed JSON array" do
+    it "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)
@@ -38,7 +39,7 @@ describe Eodhd::Client do
   end
 
   describe "#eod_data" do
-    it "eod_data returns parsed JSON array" do
+    it "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)
@@ -53,8 +54,24 @@ describe Eodhd::Client do
     end
   end
 
+  describe "#eod_bulk_last_day" do
+    it "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
+
   describe "#intraday" do
-    it "intraday returns parsed JSON array" do
+    it "returns parsed JSON array" do
       VCR.use_cassette('client_intraday') do
         result = client.intraday(exchange_code: 'US', symbol: 'AAPL', interval: '5m')
         _(result).must_be_kind_of(Array)
@@ -69,18 +86,25 @@ describe Eodhd::Client do
     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})
+  describe "#fundamentals" do
+    it "returns parsed JSON hash" do
+      VCR.use_cassette('client_fundamentals') do
+        result = client.fundamentals(exchange_code: 'US', symbol: 'AAPL')
+        _(result).must_be_kind_of(Hash)
+        _(result['General']).wont_be_nil
+      end
+    end
+
+    it "supports filter parameter" do
+      VCR.use_cassette('client_fundamentals_filtered') do
+        result = client.fundamentals(exchange_code: 'US', symbol: 'AAPL', filter: 'General')
+        _(result).must_be_kind_of(Hash)
       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)
+      VCR.use_cassette('client_fundamentals_401_error') do
+        _{client.fundamentals(exchange_code: 'US', symbol: 'AAPL')}.must_raise(Eodhd::Error)
       end
     end
   end

data/test/Eodhd/Fundamentals_test.rb

@@ -0,0 +1,78 @@
+# Eodhd/Fundamentals_test.rb
+
+require_relative '../helper'
+
+describe Eodhd::Fundamentals do
+  let(:api_token){ENV.fetch('EODHD_API_TOKEN', '<API_TOKEN>')}
+  let(:fd){Eodhd::Fundamentals.all(api_token: api_token, exchange_code: 'US', symbol: 'AAPL')}
+
+  describe ".all" do
+    it "returns an Eodhd::Fundamentals object" do
+      VCR.use_cassette('fundamentals_aapl') do
+        _(fd).must_be_kind_of(Eodhd::Fundamentals)
+      end
+    end
+
+    it "stores exchange_code and symbol" do
+      VCR.use_cassette('fundamentals_aapl') do
+        _(fd.exchange_code).must_equal('US')
+        _(fd.symbol).must_equal('AAPL')
+      end
+    end
+
+    it "returns General as an Eodhd::Fundamentals::General" do
+      VCR.use_cassette('fundamentals_aapl') do
+        _(fd.general).must_be_kind_of(Eodhd::Fundamentals::General)
+        _(fd.general.code).must_equal('AAPL')
+        _(fd.general.name).wont_be_nil
+      end
+    end
+
+    it "returns Highlights as an Eodhd::Fundamentals::Highlights" do
+      VCR.use_cassette('fundamentals_aapl') do
+        _(fd.highlights).must_be_kind_of(Eodhd::Fundamentals::Highlights)
+        _(fd.highlights.market_capitalization).wont_be_nil
+      end
+    end
+
+    it "returns Valuation as an Eodhd::Fundamentals::Valuation" do
+      VCR.use_cassette('fundamentals_aapl') do
+        _(fd.valuation).must_be_kind_of(Eodhd::Fundamentals::Valuation)
+      end
+    end
+
+    it "returns Financials as an Eodhd::Fundamentals::Financials" do
+      VCR.use_cassette('fundamentals_aapl') do
+        _(fd.financials).must_be_kind_of(Eodhd::Fundamentals::Financials)
+      end
+    end
+
+    it "returns Financials with income_statement, balance_sheet, and cash_flow" do
+      VCR.use_cassette('fundamentals_aapl') do
+        _(fd.financials.income_statement).must_be_kind_of(Eodhd::Fundamentals::Financials::Statement)
+        _(fd.financials.balance_sheet).must_be_kind_of(Eodhd::Fundamentals::Financials::Statement)
+        _(fd.financials.cash_flow).must_be_kind_of(Eodhd::Fundamentals::Financials::Statement)
+      end
+    end
+
+    it "returns quarterly and yearly data as hashes on financial statements" do
+      VCR.use_cassette('fundamentals_aapl') do
+        _(fd.financials.income_statement.quarterly).must_be_kind_of(Hash)
+        _(fd.financials.income_statement.yearly).must_be_kind_of(Hash)
+      end
+    end
+
+    it "returns Earnings as an Eodhd::Fundamentals::Earnings" do
+      VCR.use_cassette('fundamentals_aapl') do
+        _(fd.earnings).must_be_kind_of(Eodhd::Fundamentals::Earnings)
+      end
+    end
+
+    it "returns SharesStats as an Eodhd::Fundamentals::SharesStats" do
+      VCR.use_cassette('fundamentals_aapl') do
+        _(fd.shares_stats).must_be_kind_of(Eodhd::Fundamentals::SharesStats)
+        _(fd.shares_stats.shares_outstanding).wont_be_nil
+      end
+    end
+  end
+end

data/test/{validations_test.rb → Eodhd/Validations_test.rb}

@@ -1,10 +1,12 @@
-require_relative 'helper'
+# Eodhd/Validations_test.rb
+
+require_relative '../helper'
 
 class DummyIncludingValidations
   include Eodhd::Validations
 end
 
-describe "Eodhd::Validations" do
+describe Eodhd::Validations do
   let(:v){DummyIncludingValidations.new}
 
   describe "#validate_arguments" do

data/test/{web_socket_client_test.rb → Eodhd/WebSocketClient_test.rb}

@@ -1,4 +1,6 @@
-require_relative 'helper'
+# Eodhd/WebSocketClient_test.rb
+
+require_relative '../helper'
 
 describe Eodhd::WebSocketClient do
   let(:api_token){ENV.fetch('EODHD_API_TOKEN', '<API_TOKEN>')}
@@ -53,10 +55,10 @@ describe Eodhd::WebSocketClient do
   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
@@ -64,7 +66,7 @@ describe Eodhd::WebSocketClient do
           end
         end
       end
-      
+
       _(iodine_connect_called).must_equal(true)
       _(iodine_start_called).must_equal(true)
     end
@@ -76,10 +78,10 @@ describe Eodhd::WebSocketClient 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)
@@ -88,7 +90,7 @@ describe Eodhd::WebSocketClient do
       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

data/test/{eodhd_test.rb → Eodhd_test.rb}

@@ -1,8 +1,9 @@
+# Eodhd_test.rb
+
 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
@@ -59,4 +60,14 @@ describe Eodhd do
       end
     end
   end
+
+  describe "#fundamentals" do
+    it "delegates to Eodhd::Fundamentals.all" do
+      VCR.use_cassette('eodhd_fundamentals') do
+        fundamental_data = eodhd.fundamentals(exchange_code: 'US', symbol: 'AAPL')
+        _(fundamental_data).must_be_kind_of(Eodhd::Fundamentals)
+        _(fundamental_data.general).must_be_kind_of(Eodhd::Fundamentals::General)
+      end
+    end
+  end
 end

data/test/helper.rb

@@ -1,4 +1,7 @@
+# helper.rb
+
 require 'minitest/autorun'
+require 'minitest/mock'
 require 'minitest/spec'
 require 'minitest-spec-context'
 require 'vcr'