Fix user confusion about 'auto_adjust' by telling them to set it

Author: ValueRaider

yfinance/multi.py

@@ -32,10 +32,13 @@
 from .data import YfData
 from . import shared
 
+import warnings
+_warned_auto_adjust = False
+
 
 @utils.log_indent_decorator
 def download(tickers, start=None, end=None, actions=False, threads=True, ignore_tz=None,
-             group_by='column', auto_adjust=False, back_adjust=False, repair=False, keepna=False,
+             group_by='column', auto_adjust=None, back_adjust=False, repair=False, keepna=False,
              progress=True, period="max", interval="1d", prepost=False,
              proxy=None, rounding=False, timeout=10, session=None):
     """Download yahoo tickers
@@ -88,6 +91,13 @@ def download(tickers, start=None, end=None, actions=False, threads=True, ignore_
     """
     logger = utils.get_yf_logger()
 
+    if auto_adjust is None:
+        global _warned_auto_adjust
+        if not _warned_auto_adjust:
+            warnings.warn("You have not set argument 'auto_adjust'. This defaults to False, but you should be setting it (Yahoo sets to True).", UserWarning)
+            _warned_auto_adjust = True
+        auto_adjust = False
+
     if logger.isEnabledFor(logging.DEBUG):
         if threads:
             # With DEBUG, each thread generates a lot of log messages.

yfinance/scrapers/history.py

@@ -9,6 +9,9 @@
 from yfinance.const import _BASE_URL_, _PRICE_COLNAMES_
 from yfinance.exceptions import YFChartError, YFInvalidPeriodError, YFPricesMissingError, YFTzMissingError
 
+import warnings
+_warned_auto_adjust = False
+
 class PriceHistory:
     def __init__(self, data, ticker, tz, session=None, proxy=None):
         self._data = data
@@ -27,7 +30,7 @@ def __init__(self, data, ticker, tz, session=None, proxy=None):
     @utils.log_indent_decorator
     def history(self, period="1mo", interval="1d",
                 start=None, end=None, prepost=False, actions=True,
-                auto_adjust=True, back_adjust=False, repair=False, keepna=False,
+                auto_adjust=None, back_adjust=False, repair=False, keepna=False,
                 proxy=None, rounding=False, timeout=10,
                 raise_errors=False) -> pd.DataFrame:
         """
@@ -74,6 +77,13 @@ def history(self, period="1mo", interval="1d",
         logger = utils.get_yf_logger()
         proxy = proxy or self.proxy
 
+        if auto_adjust is None:
+            global _warned_auto_adjust
+            if not _warned_auto_adjust:
+                warnings.warn("You have not set argument 'auto_adjust'. This defaults to True = adjust for dividends, but you should be setting it (Yahoo sets to True).", UserWarning)
+                _warned_auto_adjust = True
+            auto_adjust = True
+
         start_user = start
         end_user = end
         if start or period is None or period.lower() == "max":