Make Yahoo, Alpha Vantage, and Polygon data providers optional extras

- Move yfinance, alpha_vantage, polygon-api-client from required to optional deps
- Add poetry extras: [yahoo], [alpha_vantage], [polygon], [all]
- Use lazy imports with placeholder classes that raise helpful ImportError
- Only include available providers in get_default_data_providers()
- Update installation docs with extras install commands
- Add install hints to each provider section in data-sources docs

Author: MDUYN

docusaurus/docs/Data/data-sources.md

@@ -354,6 +354,8 @@ The framework ships with built-in data providers for multiple markets. Set the `
 
 Free, no API key required. Powered by the [yfinance](https://github.com/ranaroussi/yfinance) library using data from [Yahoo Finance](https://finance.yahoo.com/).
 
+**Installation:** `pip install investing-algorithm-framework[yahoo]`
+
 ```python
 DataSource(
     identifier="aapl_daily",
@@ -379,6 +381,8 @@ DataSource(
 
 Requires an API key from [Polygon.io](https://polygon.io/). Powered by the [polygon-api-client](https://github.com/polygon-io/client-python) library.
 
+**Installation:** `pip install investing-algorithm-framework[polygon]`
+
 ```python
 from investing_algorithm_framework import MarketCredential
 
@@ -410,6 +414,8 @@ DataSource(
 
 Requires a free or premium API key from [Alpha Vantage](https://www.alphavantage.co/). Powered by the [alpha_vantage](https://github.com/RomelTorres/alpha_vantage) Python library.
 
+**Installation:** `pip install investing-algorithm-framework[alpha_vantage]`
+
 ```python
 from investing_algorithm_framework import MarketCredential
 

docusaurus/docs/Getting Started/installation.md

@@ -24,6 +24,32 @@ Install the latest stable version from PyPI:
 pip install investing-algorithm-framework
 ```
 
+This installs the core framework with CCXT support for crypto exchanges.
+
+### Optional Data Provider Extras
+
+The framework supports additional data providers that can be installed as optional extras:
+
+```bash
+# Yahoo Finance (stocks, ETFs, indices — free, no API key)
+pip install investing-algorithm-framework[yahoo]
+
+# Alpha Vantage (stocks, forex, crypto — free API key required)
+pip install investing-algorithm-framework[alpha_vantage]
+
+# Polygon.io (US stocks, options, forex, crypto — API key required)
+pip install investing-algorithm-framework[polygon]
+
+# Install all optional data providers at once
+pip install investing-algorithm-framework[all]
+```
+
+You can combine multiple extras:
+
+```bash
+pip install investing-algorithm-framework[yahoo,polygon]
+```
+
 ### Option 2: Install from Source
 
 For the latest development version, install directly from GitHub:

investing_algorithm_framework/infrastructure/data_providers/__init__.py

@@ -2,9 +2,51 @@
 from .csv import CSVOHLCVDataProvider, CSVTickerDataProvider
 from .pandas import PandasOHLCVDataProvider
 from .ohlcv_base import OHLCVDataProviderBase
-from .yahoo import YahooOHLCVDataProvider
-from .alpha_vantage import AlphaVantageOHLCVDataProvider
-from .polygon import PolygonOHLCVDataProvider
+
+
+def _make_optional_provider_placeholder(name, package, extra):
+    """Create a placeholder class that raises ImportError on instantiation."""
+
+    class _Placeholder:
+        def __init__(self, *args, **kwargs):
+            raise ImportError(
+                f"{package} is required for {name}. "
+                f"Install it with: "
+                f"pip install investing-algorithm-framework[{extra}]"
+            )
+
+    _Placeholder.__name__ = name
+    _Placeholder.__qualname__ = name
+    return _Placeholder
+
+
+# Optional provider imports — only available when extras are installed
+try:
+    from .yahoo import YahooOHLCVDataProvider
+    _yahoo_available = True
+except ImportError:
+    YahooOHLCVDataProvider = _make_optional_provider_placeholder(
+        "YahooOHLCVDataProvider", "yfinance", "yahoo"
+    )
+    _yahoo_available = False
+
+try:
+    from .alpha_vantage import AlphaVantageOHLCVDataProvider
+    _alpha_vantage_available = True
+except ImportError:
+    AlphaVantageOHLCVDataProvider = _make_optional_provider_placeholder(
+        "AlphaVantageOHLCVDataProvider", "alpha_vantage", "alpha_vantage"
+    )
+    _alpha_vantage_available = False
+
+try:
+    from .polygon import PolygonOHLCVDataProvider
+    _polygon_available = True
+except ImportError:
+    PolygonOHLCVDataProvider = _make_optional_provider_placeholder(
+        "PolygonOHLCVDataProvider", "polygon-api-client", "polygon"
+    )
+    _polygon_available = False
 
 
 def get_default_data_providers():
@@ -14,14 +56,22 @@ def get_default_data_providers():
     Returns:
         list: List of default data providers.
     """
-    return [
+    providers = [
         CCXTOHLCVDataProvider(),
         CCXTTickerDataProvider(),
-        YahooOHLCVDataProvider(),
-        AlphaVantageOHLCVDataProvider(),
-        PolygonOHLCVDataProvider(),
     ]
 
+    if _yahoo_available:
+        providers.append(YahooOHLCVDataProvider())
+
+    if _alpha_vantage_available:
+        providers.append(AlphaVantageOHLCVDataProvider())
+
+    if _polygon_available:
+        providers.append(PolygonOHLCVDataProvider())
+
+    return providers
+
 
 def get_default_ohlcv_data_providers():
     """
@@ -30,13 +80,21 @@ def get_default_ohlcv_data_providers():
     Returns:
         list: List of default OHLCV data providers.
     """
-    return [
+    providers = [
         CCXTOHLCVDataProvider(),
-        YahooOHLCVDataProvider(),
-        AlphaVantageOHLCVDataProvider(),
-        PolygonOHLCVDataProvider(),
     ]
 
+    if _yahoo_available:
+        providers.append(YahooOHLCVDataProvider())
+
+    if _alpha_vantage_available:
+        providers.append(AlphaVantageOHLCVDataProvider())
+
+    if _polygon_available:
+        providers.append(PolygonOHLCVDataProvider())
+
+    return providers
+
 
 __all__ = [
     'CSVOHLCVDataProvider',

poetry.lock

@@ -29,12 +29,18 @@ azure-mgmt-storage = "^21.2.1"
 azure-mgmt-web = "^7.3.1"
 azure-mgmt-resource = "^23.2.0"
 python-dotenv = "^1.0.1"
-yfinance = "^0.2.61"
-alpha_vantage = "^3.0.0"
-polygon-api-client = "^1.14.0"
+yfinance = {version = "^0.2.61", optional = true}
+alpha_vantage = {version = "^3.0.0", optional = true}
+polygon-api-client = {version = "^1.14.0", optional = true}
 plotly = "^6.1.2"
 boto3 = "^1.38.41"
 
+[tool.poetry.extras]
+yahoo = ["yfinance"]
+alpha_vantage = ["alpha_vantage"]
+polygon = ["polygon-api-client"]
+all = ["yfinance", "alpha_vantage", "polygon-api-client"]
+
 [tool.poetry.group.test.dependencies]
 coverage= "7.4.2"
 flake8 = "7.0.0"