sqa 0.0.32 → 0.0.37

data/lib/sqa/ticker.rb

@@ -1,75 +1,133 @@
 # sqa/lib/sqa/ticker.rb
 #
-# Uses the https://dumbstockapi.com/ website to download a CSV file
+# Stock ticker symbol validation and lookup using the dumbstockapi.com service.
+# Downloads and caches a CSV file containing ticker symbols, company names, and exchanges.
 #
-# The CSV files have names like this:
-#   "dumbstockapi-2023-09-21T16 39 55.165Z.csv"
+# @example Validating a ticker
+#   SQA::Ticker.valid?('AAPL')  # => true
+#   SQA::Ticker.valid?('FAKE')  # => false
 #
-# which has this header:
-#   ticker,name,is_etf,exchange
-#
-# Not using the is_etf columns
+# @example Looking up ticker info
+#   info = SQA::Ticker.lookup('AAPL')
+#   info[:name]      # => "Apple Inc"
+#   info[:exchange]  # => "NASDAQ"
 #
 class SQA::Ticker
+  # @return [String] Prefix for downloaded CSV filenames
   FILENAME_PREFIX = "dumbstockapi"
+
+  # @return [Faraday::Connection] Connection to dumbstockapi.com
   CONNECTION      = Faraday.new(url: "https://dumbstockapi.com")
-  @@data          = {}
 
+  class << self
+    # Downloads ticker data from dumbstockapi.com and saves to data directory.
+    #
+    # @param country [String] Country code for ticker list (default: "US")
+    # @return [Integer] HTTP status code from the download request
+    #
+    # @example
+    #   SQA::Ticker.download("US")  # => 200
+    #
+    def download(country="US")
+      response = CONNECTION.get("/stock?format=csv&countries=#{country.upcase}").to_hash
 
-  def self.download(country="US")
-    response = CONNECTION.get("/stock?format=csv&countries=#{country.upcase}").to_hash
+      if 200 == response[:status]
+        filename = response[:response_headers]["content-disposition"].split('=').last.gsub('"','')
+        out_path = Pathname.new(SQA.config.data_dir) + filename
+        out_path.write response[:body]
+      end
 
-    if 200 == response[:status]
-      filename = response[:response_headers]["content-disposition"].split('=').last.gsub('"','')
-      out_path = Pathname.new(SQA.config.data_dir) + filename
-      out_path.write response[:body]
+      response[:status]
     end
 
-    response[:status]
-  end
-
+    # Loads ticker data from cached CSV or downloads if not available.
+    # Retries download up to 3 times if no cached file exists.
+    #
+    # @return [Hash{String => Hash}] Hash mapping ticker symbols to info hashes
+    def load
+      tries = 0
+      found = false
 
-  def self.load
-    tries = 0
-    found = false
+      until(found || tries >= 3) do
+        files     = Pathname.new(SQA.config.data_dir).children.select{|c| c.basename.to_s.start_with?(FILENAME_PREFIX)}.sort
+        if files.empty?
+          begin
+            download
+          rescue StandardError => e
+            warn "Warning: Could not download ticker list: #{e.message}" if $VERBOSE
+          end
+          tries += 1
+        else
+          found = true
+        end
+      end
 
-     until(found || tries >= 3) do
-      files     = Pathname.new(SQA.config.data_dir).children.select{|c| c.basename.to_s.start_with?(FILENAME_PREFIX)}.sort
       if files.empty?
-        begin
-          download
-        rescue => e
-          warn "Warning: Could not download ticker list: #{e.message}" if $VERBOSE
-        end
-        tries += 1
-      else
-        found = true
+        warn "Warning: No ticker validation data available. Proceeding without validation." if $VERBOSE
+        return {}
       end
-    end
 
-    if files.empty?
-      warn "Warning: No ticker validation data available. Proceeding without validation." if $VERBOSE
-      return {}
+      load_from_csv files.last
     end
 
-    load_from_csv files.last
-  end
-
+    # Loads ticker data from a specific CSV file.
+    #
+    # @param csv_path [Pathname, String] Path to CSV file
+    # @return [Hash{String => Hash}] Hash mapping ticker symbols to info hashes
+    def load_from_csv(csv_path)
+      @data ||= {}
+      CSV.foreach(csv_path, headers: true) do |row|
+        @data[row["ticker"]] = {
+          name:     row["name"],
+          exchange: row["exchange"]
+        }
+      end
 
-  def self.load_from_csv(csv_path)
-    CSV.foreach(csv_path, headers: true) do |row|
-      @@data[row["ticker"]] = {
-        name:     row["name"],
-        exchange: row["exchange"]
-      }
+      @data
     end
 
-    @@data
-  end
+    # Returns the cached ticker data, loading it if necessary.
+    #
+    # @return [Hash{String => Hash}] Hash mapping ticker symbols to info hashes
+    def data
+      @data ||= {}
+      @data.empty? ? load : @data
+    end
 
+    # Looks up information for a specific ticker symbol.
+    #
+    # @param ticker [String, nil] Ticker symbol to look up
+    # @return [Hash, nil] Hash with :name and :exchange keys, or nil if not found
+    #
+    # @example
+    #   SQA::Ticker.lookup('AAPL')  # => { name: "Apple Inc", exchange: "NASDAQ" }
+    #   SQA::Ticker.lookup('FAKE')  # => nil
+    #
+    def lookup(ticker)
+      return nil if ticker.nil? || ticker.to_s.empty?
+      data[ticker.to_s.upcase]
+    end
 
+    # Checks if a ticker symbol is valid (exists in the data).
+    #
+    # @param ticker [String, nil] Ticker symbol to validate
+    # @return [Boolean] true if ticker exists, false otherwise
+    #
+    # @example
+    #   SQA::Ticker.valid?('AAPL')  # => true
+    #   SQA::Ticker.valid?(nil)     # => false
+    #
+    def valid?(ticker)
+      return false if ticker.nil? || ticker.to_s.empty?
+      data.key?(ticker.to_s.upcase)
+    end
 
-  def self.data           = @@data.empty? ? load : @@data
-  def self.lookup(ticker) = data[ticker.upcase]
-  def self.valid?(ticker) = data.has_key?(ticker.upcase)
+    # Resets the cached ticker data.
+    # Useful for testing to force a fresh load.
+    #
+    # @return [Hash] Empty hash
+    def reset!
+      @data = {}
+    end
+  end
 end

data/lib/sqa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SQA
-  VERSION = '0.0.32'
+  VERSION = '0.0.37'
 end

data/lib/sqa.rb

@@ -1,7 +1,8 @@
 # lib/sqa.rb
 # frozen_string_literal: true
 
-# TODO: Create a new gem for the dumbstockapi website
+# NOTE: The dumbstockapi integration is handled by SQA::Ticker class.
+# A separate gem could be created if more extensive API coverage is needed.
 
 #############################################
 ## Standard Libraries
@@ -13,9 +14,8 @@ unless defined?(HOME)
 	HOME = Pathname.new(ENV['HOME'])
 end
 
-# TODO: do we want to move the debug_me gem out of the
-# 			development dependencies into the required?
-#
+# NOTE: debug_me is optional - loaded if available, otherwise a no-op is defined.
+# This keeps it as a development dependency while allowing production use if installed.
 if defined?(DebugMe)
 	unless respond_to?(:debug_me)
 		include DebugMe

data/mkdocs.yml

@@ -3,7 +3,7 @@ site_name: SQA - Simple Qualitative Analysis
 site_description: A powerful Ruby library for stock market technical analysis and trading strategy development
 site_author: Dewayne VanHoozer
 site_url: https://madbomber.github.io/sqa
-copyright: Copyright © 2024 Dewayne VanHoozer
+copyright: Copyright © 2025 Dewayne VanHoozer (CAUTION! This documentation was mostly written by a robot so it might be wrong.)
 
 # Repository information
 repo_name: madbomber/sqa
@@ -56,7 +56,6 @@ theme:
 
     # Table of contents
     - toc.follow
-    - toc.integrate
 
     # Search
     - search.suggest
@@ -74,15 +73,11 @@ theme:
     - content.action.edit
     - content.action.view
 
-    # Announce
-    - announce.dismiss
-
 # Plugins
 plugins:
   - search:
       separator: '[\s\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
-  - tags:
-      tags_file: tags.md
+  - tags
 
 # Extensions
 markdown_extensions:
@@ -97,7 +92,6 @@ markdown_extensions:
   - toc:
       permalink: true
       title: On this page
-      toc_depth: 3
 
   # Python Markdown Extensions
   - pymdownx.arithmatex:
@@ -154,9 +148,6 @@ extra:
       link: https://rubygems.org/gems/sqa
       name: SQA on RubyGems
 
-  version:
-    provider: mike
-
   analytics:
     feedback:
       title: Was this page helpful?
@@ -175,78 +166,74 @@ extra:
 # Navigation
 nav:
   - Home: index.md
+
   - Getting Started:
-    - getting-started/index.md
-    - Installation: getting-started/installation.md
-    - Quick Start: getting-started/quick-start.md
-
-  - Core Concepts:
-    - concepts/index.md
-    - DataFrames: data_frame.md
-    - Technical Indicators: indicators/index.md
-    - Trading Strategies: strategy.md
-
-  - Technical Indicators:
-    - indicators/index.md
-    - Overview: indicators.md
-    - sqa-tai Gem: https://github.com/MadBomber/sqa-tai
-    - TA-Lib Documentation: https://ta-lib.org/
-
-  - Trading Strategies:
-    - strategies/index.md
-    - Built-in Strategies:
-      - Bollinger Bands Strategy: strategies/bollinger-bands.md
-      - RSI Strategy: strategies/rsi.md
-      - MACD Strategy: strategies/macd.md
-      - SMA Strategy: strategies/sma.md
-      - EMA Strategy: strategies/ema.md
-      - Stochastic Strategy: strategies/stochastic.md
-      - Volume Breakout: strategies/volume-breakout.md
-      - Mean Reversion: strategies/mean-reversion.md
-      - Market Profile: strategies/market-profile.md
-      - Consensus Strategy: strategies/consensus.md
-    - Advanced Strategies:
-      - Knowledge-Based Strategy (KBS): strategies/kbs.md
-      - Custom Strategies: strategies/custom.md
-
-  - Advanced Features:
-    - advanced/index.md
-    - Portfolio Management: advanced/portfolio.md
-    - Backtesting: advanced/backtesting.md
-    - Strategy Generator: advanced/strategy-generator.md
-    - Genetic Programming: genetic_programming.md
-    - Real-Time Streaming: advanced/streaming.md
-    - FPOP Analysis: advanced/fpop.md
-    - Risk Management: advanced/risk-management.md
-    - Portfolio Optimizer: advanced/portfolio-optimizer.md
-    - Ensemble Strategies: advanced/ensemble.md
-    - Multi-Timeframe Analysis: advanced/multi-timeframe.md
-    - Pattern Matcher: advanced/pattern-matcher.md
-
-  - AI & Machine Learning:
-    - ai_and_ml.md
-    - Mean Reversion: mean_reversion.md
-    - Predict Next Value: predict_next_value.md
-    - Identify Wave Condition: identify_wave_condition.md
-    - LIBSVM Format: libsvm_file_format.md
+      - Overview: getting-started/index.md
+      - Installation: getting-started/installation.md
+      - Quick Start: getting-started/quick-start.md
+
+  - User Guide:
+      - Core Concepts:
+          - Overview: concepts/index.md
+          - DataFrames: data_frame.md
+          - Trading Strategies: strategy.md
+      - Technical Indicators:
+          - Overview: indicators/index.md
+          - Indicator Details: indicators.md
+          - sqa-tai Gem: https://github.com/MadBomber/sqa-tai
+          - TA-Lib Documentation: https://ta-lib.org/
+      - Trading Strategies:
+          - Overview: strategies/index.md
+          - Built-in Strategies:
+              - Bollinger Bands: strategies/bollinger-bands.md
+              - RSI Strategy: strategies/rsi.md
+              - MACD Strategy: strategies/macd.md
+              - SMA Strategy: strategies/sma.md
+              - EMA Strategy: strategies/ema.md
+              - Stochastic: strategies/stochastic.md
+              - Volume Breakout: strategies/volume-breakout.md
+              - Mean Reversion: strategies/mean-reversion.md
+              - Market Profile: strategies/market-profile.md
+              - Consensus: strategies/consensus.md
+          - Advanced Strategies:
+              - KBS Strategy: strategies/kbs.md
+              - Custom Strategies: strategies/custom.md
+      - Data Sources:
+          - Overview: data-sources/index.md
+
+  - Advanced:
+      - Overview: advanced/index.md
+      - Portfolio Management: advanced/portfolio.md
+      - Backtesting: advanced/backtesting.md
+      - Strategy Generator: advanced/strategy-generator.md
+      - Genetic Programming: genetic_programming.md
+      - Real-Time Streaming: advanced/streaming.md
+      - FPOP Analysis: advanced/fpop.md
+      - Risk Management: advanced/risk-management.md
+      - Portfolio Optimizer: advanced/portfolio-optimizer.md
+      - Ensemble Strategies: advanced/ensemble.md
+      - Multi-Timeframe: advanced/multi-timeframe.md
+      - Pattern Matcher: advanced/pattern-matcher.md
+      - AI & Machine Learning:
+          - Overview: ai_and_ml.md
+          - Mean Reversion: mean_reversion.md
+          - Predict Next Value: predict_next_value.md
+          - Wave Condition: identify_wave_condition.md
+          - LIBSVM Format: libsvm_file_format.md
 
   - API Reference:
-    - api/index.md
-    - DataFrame Class: api/dataframe.md
-
-  - Data Sources:
-    - data-sources/index.md
+      - Overview: api/index.md
+      - DataFrame Class: api/dataframe.md
+      - Complete API Reference: api-reference/index.md
 
   - Resources:
-    - Tags: tags.md
-    - Requirements: requirements.md
-    - Terms of Use: terms_of_use.md
-    - Trading Ideas: i_gotta_an_idea.md
-    - Factor Analysis: factors_that_impact_price.md
-    - External Tools:
-      - FinViz: finviz.md
-      - FX Pro Bit: fx_pro_bit.md
-    - Options Trading: options.md
-
-  - Contributing:
-    - contributing/index.md
+      - Tags: tags.md
+      - Requirements: requirements.md
+      - Terms of Use: terms_of_use.md
+      - Trading Ideas: i_gotta_an_idea.md
+      - Factor Analysis: factors_that_impact_price.md
+      - External Tools:
+          - FinViz: finviz.md
+          - FX Pro Bit: fx_pro_bit.md
+      - Options Trading: options.md
+      - Contributing: contributing/index.md

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sqa
 version: !ruby/object:Gem::Version
-  version: 0.0.32
+  version: 0.0.37
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -345,6 +345,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  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: yard-markdown
+  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: |
   Simplistic playpen (e.g. not for serious use) for doing
   technical analysis of stock prices.  Under Construction.
@@ -398,7 +426,7 @@ files:
 - data/talk_talk.json
 - develop_summary.md
 - docs/.gitignore
-- docs/README.md
+- docs/IMPROVEMENT_PLAN.md
 - docs/advanced/backtesting.md
 - docs/advanced/ensemble.md
 - docs/advanced/fpop.md
@@ -411,10 +439,68 @@ files:
 - docs/advanced/strategy-generator.md
 - docs/advanced/streaming.md
 - docs/ai_and_ml.md
+- docs/api-reference/alphavantageapi.md
+- docs/api-reference/apierror.md
+- docs/api-reference/index.md
+- docs/api-reference/notimplemented.md
+- docs/api-reference/sqa.md
+- docs/api-reference/sqa_backtest.md
+- docs/api-reference/sqa_backtest_results.md
+- docs/api-reference/sqa_badparametererror.md
+- docs/api-reference/sqa_config.md
+- docs/api-reference/sqa_configurationerror.md
+- docs/api-reference/sqa_datafetcherror.md
+- docs/api-reference/sqa_dataframe.md
+- docs/api-reference/sqa_dataframe_alphavantage.md
+- docs/api-reference/sqa_dataframe_data.md
+- docs/api-reference/sqa_dataframe_yahoofinance.md
+- docs/api-reference/sqa_ensemble.md
+- docs/api-reference/sqa_fpop.md
+- docs/api-reference/sqa_geneticprogram.md
+- docs/api-reference/sqa_geneticprogram_individual.md
+- docs/api-reference/sqa_marketregime.md
+- docs/api-reference/sqa_multitimeframe.md
+- docs/api-reference/sqa_patternmatcher.md
+- docs/api-reference/sqa_pluginmanager.md
+- docs/api-reference/sqa_portfolio.md
+- docs/api-reference/sqa_portfolio_position.md
+- docs/api-reference/sqa_portfolio_trade.md
+- docs/api-reference/sqa_portfoliooptimizer.md
+- docs/api-reference/sqa_riskmanager.md
+- docs/api-reference/sqa_seasonalanalyzer.md
+- docs/api-reference/sqa_sectoranalyzer.md
+- docs/api-reference/sqa_stock.md
+- docs/api-reference/sqa_strategy.md
+- docs/api-reference/sqa_strategy_bollingerbands.md
+- docs/api-reference/sqa_strategy_common.md
+- docs/api-reference/sqa_strategy_consensus.md
+- docs/api-reference/sqa_strategy_ema.md
+- docs/api-reference/sqa_strategy_kbs.md
+- docs/api-reference/sqa_strategy_macd.md
+- docs/api-reference/sqa_strategy_mp.md
+- docs/api-reference/sqa_strategy_mr.md
+- docs/api-reference/sqa_strategy_random.md
+- docs/api-reference/sqa_strategy_rsi.md
+- docs/api-reference/sqa_strategy_sma.md
+- docs/api-reference/sqa_strategy_stochastic.md
+- docs/api-reference/sqa_strategy_volumebreakout.md
+- docs/api-reference/sqa_strategygenerator.md
+- docs/api-reference/sqa_strategygenerator_pattern.md
+- docs/api-reference/sqa_strategygenerator_patterncontext.md
+- docs/api-reference/sqa_strategygenerator_profitablepoint.md
+- docs/api-reference/sqa_stream.md
+- docs/api-reference/sqa_ticker.md
+- docs/api-reference/string.md
 - docs/api/dataframe.md
 - docs/api/index.md
 - docs/assets/css/custom.css
+- docs/assets/images/advanced-workflow.svg
+- docs/assets/images/architecture.svg
+- docs/assets/images/data-flow.svg
+- docs/assets/images/getting-started-workflow.svg
 - docs/assets/images/sqa.jpg
+- docs/assets/images/strategy-flow.svg
+- docs/assets/images/system-architecture.svg
 - docs/assets/js/mathjax.js
 - docs/concepts/index.md
 - docs/contributing/index.md
@@ -433,6 +519,7 @@ files:
 - docs/indicators.md
 - docs/indicators/index.md
 - docs/libsvm_file_format.md
+- docs/llms.txt
 - docs/mean_reversion.md
 - docs/options.md
 - docs/predict_next_value.md
@@ -484,25 +571,6 @@ files:
 - examples/rails_app/config/environment.rb
 - examples/rails_app/config/routes.rb
 - examples/realtime_stream_example.rb
-- examples/sinatra_app/Gemfile
-- examples/sinatra_app/Gemfile.lock
-- examples/sinatra_app/QUICKSTART.md
-- examples/sinatra_app/README.md
-- examples/sinatra_app/RUNNING_WITHOUT_TALIB.md
-- examples/sinatra_app/TROUBLESHOOTING.md
-- examples/sinatra_app/app.rb
-- examples/sinatra_app/config.ru
-- examples/sinatra_app/public/css/style.css
-- examples/sinatra_app/public/debug_macd.html
-- examples/sinatra_app/public/js/app.js
-- examples/sinatra_app/start.sh
-- examples/sinatra_app/views/analyze.erb
-- examples/sinatra_app/views/backtest.erb
-- examples/sinatra_app/views/dashboard.erb
-- examples/sinatra_app/views/error.erb
-- examples/sinatra_app/views/index.erb
-- examples/sinatra_app/views/layout.erb
-- examples/sinatra_app/views/portfolio.erb
 - examples/strategy_generator_example.rb
 - hsa_portfolio.csv
 - justfile

data/docs/README.md

@@ -1,43 +0,0 @@
-# README.md
-
-"Playing the market" has always felt like "playing roulette" at the casino - "you pays your money and you takes your chances".  Some players are winners.  Some are losers.  But **the House Always Wins.**
-
-Before computers, swings in the market were caused by people.  These days I believe that computers have more to do with it than public trader sentiment.  One computer program can start a cascade of other computer programs selling or buying in a digital frenzy of trading chaos.
-
-There are supposed to be tripwires in the system that protect against such things.
-
-## Recent Computer-caused Chaos
-
-I asked my AI assistant "do you know of any times when computer programs caused trading chaos in the stock market?"
-
-Yes, there have been several instances in history when computer programs have contributed to chaos in the stock market. Here are a few notable examples:
-
-1. **Flash Crash, 2010:** On May 6, 2010, U.S. financial markets experienced a brief, severe, and rapidly-reversed drop in stock prices. The Dow Jones Industrial Average plunged by over 1,000 points in a matter of minutes, only to recover just as quickly. This event is known as the "Flash Crash". The crash was primarily blamed on high-frequency trading algorithms - computer programs that execute trades at incredibly high speeds.
-
-2. **Knight Capital Group Incident, 2012:** On August 1, 2012, the company Knight Capital Group experienced a major malfunction in its automated trading software. The software executed trades worth $7 billion in about half an hour, causing Knight Capital's stock price to collapse and leading to a $440 million loss for the company.
-
-3. **Facebook's IPO, 2012:** During the initial public offering of Facebook on May 18, 2012, the stock exchange NASDAQ experienced significant technical problems. The defective technology running NASDAQ’s trading software resulted in a delay of the start of trading and confusion over individual share orders, leading to a chaotic and disorderly start to Facebook's life as a public company.
-
-4. **Swiss Franc Surge, 2015:** On January 15, 2015, the Swiss franc surged nearly 30% in a matter of minutes after the Swiss National Bank unexpectedly abolished a cap on the franc's value against the euro. Many automated trading systems were not equipped to handle this abrupt change, resulting in massive losses for many traders and companies.
-
-These events highlight the importance of careful design and rigorous testing for trading algorithms and software systems. They also demonstrate the potential for extreme market volatility in the face of unforeseen software failures or unexpected economic events.
-
-## How to be a Winner
-
-**Knowledge is King** at the casino when playing blackjack, if you can count the cards without getting caught and killed, you can gain a very small advantage over the house.  I was once given the advice to never trade a company that I did not know inside and out or in an industry in which I had no expertise.  Basically the more you know about a company the better your chances of making a beneficial trade.  I guess the extreme of that is being an insider; but there are laws against that right?  Or is it like blackjack and you should just not get caught?
-
-Is it possible to "beat the system?"  Lots of people have become wealthy selling books or services that purport to teach you how.  They all contain the same or similar disclaimers:
-
-> Decisions to buy, sell, hold or trade in securities, commodities and other investments involve risk and are best made based on the advice of qualified financial professionals. Any trading in securities or other investments involves a risk of substantial losses.
->
-> Before undertaking any trading program, you should consult a qualified financial professional. Please consider carefully whether such trading is suitable for you in light of your financial condition and ability to bear financial risks. **Under no circumstances shall we be liable** for any loss or damage you or anyone else incurs as a result of any trading or investment activity that you or anyone else engages in based on any information or material you receive through us or our services.
-
-Here's my favorite:
-
-> Hypothetical performance results have many inherent limitations. No representation is being made that any account will or is likely to achieve profits or losses similar to those shown. In fact, there are frequently sharp differences between hypothetical performance results and actual results subsequently achieved by any particular trading program.
->
-> One of the limitations of hypothetical performance results is that they are generally prepared with the benefit of hindsight. In addition, hypothetical trading does not involve financial risk and no hypothetical trading record can completely account for the impact of financial risk in actual trading. For example the ability to withstand losses or to adhere to a particular trading program in spite of the trading losses are material points, which can also adversely affect trading results. There are numerous other factors related to the market in general or to the implementation of any specific trading program which cannot be fully accounted for in the preparation of hypothetical performance results and all of which can adversely affect actual trading results.
-
-So it other words "you pays your money and you takes your chances."
-
-**The House Always Wins**

data/examples/sinatra_app/Gemfile

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-ruby '>= 3.2.0'
-
-# Web framework
-gem 'rackup'
-gem 'sinatra', '~> 4.0'
-gem 'sinatra-contrib', '~> 4.0'
-gem 'puma', '~> 6.0'
-
-# JSON handling
-gem 'json', '~> 2.7'
-
-# SQA library dependencies (required when loading SQA from local path)
-gem 'alphavantage'
-gem 'csv'
-gem 'faraday'
-gem 'hashie'
-gem 'kbs'
-gem 'lite-statistics'
-gem 'nenv'
-gem 'redis'
-gem 'ruby_llm'
-gem 'ruby_llm-mcp'
-gem 'shared_tools'
-gem 'sqa-tai'
-gem 'tty-table'
-gem 'eps'
-gem 'polars-df'
-gem 'toml-rb'
-gem 'regent'
-
-# SQA library (assumes it's in parent directory)
-# In production, this would be:
-# gem 'sqa'
-# For development, we'll load from local path via require in app.rb
-
-group :development do
-  gem 'rerun'  # Auto-reload on file changes
-end