yfinance 1.6.0__py3-none-any.whl

yfinance/__init__.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# yfinance - market data downloader
+# https://github.com/ranaroussi/yfinance
+#
+# Copyright 2017-2019 Ran Aroussi
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+from . import version
+from .search import Search
+from .lookup import Lookup
+from .ticker import Ticker
+from .calendars import Calendars
+from .tickers import Tickers
+from .multi import download
+from .live import WebSocket, AsyncWebSocket
+from .utils import enable_debug_mode
+from .cache import set_tz_cache_location
+from .domain.sector import Sector
+from .domain.industry import Industry
+from .domain.market import Market, MarketRegion
+from .config import YfConfig as config
+from .data import Auth
+
+from .screener.query import EquityQuery, FundQuery, ETFQuery
+from .screener.screener import screen, PREDEFINED_SCREENER_QUERIES
+
+__version__ = version.version
+__author__ = "Ran Aroussi"
+
+import warnings
+warnings.filterwarnings('default', category=DeprecationWarning, module='^yfinance')
+
+__all__ = ['download', 'Market', 'MarketRegion', 'Search', 'Lookup', 'Ticker', 'Tickers', 'enable_debug_mode', 'set_tz_cache_location',
+           'Sector', 'Industry', 'WebSocket', 'AsyncWebSocket', 'Calendars', 'Auth']
+# screener stuff:
+__all__ += ['EquityQuery', 'FundQuery', 'ETFQuery', 'screen', 'PREDEFINED_SCREENER_QUERIES']
+
+# Config stuff:
+_NOTSET=object()
+def set_config(proxy=_NOTSET, retries=_NOTSET):
+    if proxy is not _NOTSET:
+        warnings.warn("Set proxy via new config control: yf.config.network.proxy = proxy", DeprecationWarning)
+        config.network.proxy = proxy
+    if retries is not _NOTSET:
+        warnings.warn("Set retries via new config control: yf.config.network.retries = retries", DeprecationWarning)
+        config.network.retries = retries
+__all__ += ['config', 'set_config']

yfinance/_http.py

@@ -0,0 +1,101 @@
+"""HTTP backend abstraction.
+
+Prefers ``curl_cffi`` for browser TLS impersonation. Falls back to plain
+``requests`` with a realistic ``User-Agent`` when ``curl_cffi`` cannot be
+imported (e.g. binary not buildable on the host platform — see issue #2692)
+or when ``YF_DISABLE_CURL_CFFI`` is set in the environment (downstream
+packagers may ship without ``curl_cffi`` even if it is installed).
+
+The fallback is best-effort: plain ``requests`` cannot replicate the
+JA3/JA4 fingerprint and HTTP/2 settings that ``curl_cffi`` provides, so
+Yahoo Finance may rate-limit or block this client. ``curl_cffi`` remains
+the preferred backend and the default install dependency.
+"""
+import functools
+import os
+
+from . import utils
+
+_DISABLE = os.environ.get("YF_DISABLE_CURL_CFFI", "").lower() in ("1", "true", "yes")
+
+if not _DISABLE:
+    try:
+        from curl_cffi import requests as _curl_backend
+        _backend = _curl_backend
+        HAS_CURL_CFFI = True
+    except ImportError:
+        import requests as _requests_backend
+        _backend = _requests_backend
+        HAS_CURL_CFFI = False
+else:
+    import requests as _requests_backend
+    _backend = _requests_backend
+    HAS_CURL_CFFI = False
+
+requests = _backend
+HTTPError = _backend.exceptions.HTTPError
+
+_FALLBACK_USER_AGENT = (
+    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+    "(KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
+)
+
+_fallback_warned = False
+
+
+def _warn_once_on_fallback():
+    global _fallback_warned
+    if HAS_CURL_CFFI or _fallback_warned:
+        return
+    _fallback_warned = True
+    utils.get_yf_logger().warning(
+        "curl_cffi not available; falling back to requests without browser TLS "
+        "impersonation. Yahoo Finance may rate-limit or block this client. "
+        "Install curl_cffi (>=0.15) for the supported configuration."
+    )
+
+
+def new_session():
+    """Create a default Session for the active backend."""
+    if HAS_CURL_CFFI:
+        return _backend.Session(impersonate="chrome")
+    _warn_once_on_fallback()
+    s = _backend.Session()
+    s.headers.update({
+        "User-Agent": _FALLBACK_USER_AGENT,
+        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+        "Accept-Language": "en-US,en;q=0.5",
+    })
+    return s
+
+
+def cookie_jar(session):
+    """Return the underlying ``http.cookiejar.CookieJar`` for either backend.
+
+    ``curl_cffi`` exposes the jar as ``session.cookies.jar``; ``requests``
+    uses ``session.cookies`` directly (it subclasses ``CookieJar``).
+    """
+    cookies = session.cookies
+    return getattr(cookies, "jar", cookies)
+
+
+@functools.lru_cache(maxsize=1)
+def _supported_session_classes() -> tuple:
+    classes = []
+    try:
+        from curl_cffi.requests.session import Session as _CurlSession
+        classes.append(_CurlSession)
+    except ImportError:
+        pass
+    try:
+        from requests.sessions import Session as _ReqSession
+        classes.append(_ReqSession)
+    except ImportError:
+        pass
+    return tuple(classes)
+
+
+def is_supported_session(obj) -> bool:
+    """True if ``obj`` is a Session from either supported backend."""
+    classes = _supported_session_classes()
+    return bool(classes) and isinstance(obj, classes)