fin-infra 0.1.72__tar.gz → 0.1.73__tar.gz

{fin_infra-0.1.72 → fin_infra-0.1.73}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: fin-infra
-Version: 0.1.72
+Version: 0.1.73
 Summary: Financial infrastructure toolkit: banking connections, market data, credit, cashflows, and brokerage integrations
 License: MIT
 Keywords: finance,banking,plaid,brokerage,markets,credit,tax,cashflow,fintech,infra
@@ -19,24 +19,30 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Office/Business :: Financial
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
+Provides-Extra: all
+Provides-Extra: banking
+Provides-Extra: crypto
+Provides-Extra: markets
+Provides-Extra: plaid
+Provides-Extra: yahoo
 Requires-Dist: ai-infra (>=0.1.142)
 Requires-Dist: cashews[redis] (>=7.0)
-Requires-Dist: ccxt (>=4.0.0)
+Requires-Dist: ccxt (>=4.0.0) ; extra == "markets" or extra == "crypto" or extra == "all"
 Requires-Dist: httpx (>=0.25.0)
 Requires-Dist: loguru (>=0.7.0)
 Requires-Dist: numpy (>=1.24.0)
 Requires-Dist: numpy-financial (>=1.0.0)
-Requires-Dist: plaid-python (>=25.0.0)
+Requires-Dist: plaid-python (>=25.0.0) ; extra == "plaid" or extra == "banking" or extra == "all"
 Requires-Dist: pydantic (>=2.0)
 Requires-Dist: pydantic-settings (>=2.0)
 Requires-Dist: python-dotenv (>=1.0.0)
 Requires-Dist: tenacity (>=8.0.0)
 Requires-Dist: typing-extensions (>=4.0)
-Requires-Dist: yahooquery (>=2.3.0)
-Project-URL: Documentation, https://github.com/your-org/fin-infra#readme
-Project-URL: Homepage, https://github.com/your-org/fin-infra
-Project-URL: Issues, https://github.com/your-org/fin-infra/issues
-Project-URL: Repository, https://github.com/your-org/fin-infra
+Requires-Dist: yahooquery (>=2.3.0) ; extra == "markets" or extra == "yahoo" or extra == "all"
+Project-URL: Documentation, https://nfrax.com/fin-infra
+Project-URL: Homepage, https://github.com/nfraxlab/fin-infra
+Project-URL: Issues, https://github.com/nfraxlab/fin-infra/issues
+Project-URL: Repository, https://github.com/nfraxlab/fin-infra
 Description-Content-Type: text/markdown
 
 <div align="center">

{fin_infra-0.1.72 → fin_infra-0.1.73}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "fin-infra"
-version = "0.1.72"
+version = "0.1.73"
 description = "Financial infrastructure toolkit: banking connections, market data, credit, cashflows, and brokerage integrations"
 authors = ["Ali Khatami <aliikhatami94@gmail.com>"]
 license = "MIT"
@@ -29,10 +29,10 @@ classifiers = [
 ]
 
 [tool.poetry.urls]
-Homepage = "https://github.com/your-org/fin-infra"
-Repository = "https://github.com/your-org/fin-infra"
-Issues = "https://github.com/your-org/fin-infra/issues"
-Documentation = "https://github.com/your-org/fin-infra#readme"
+Homepage = "https://github.com/nfraxlab/fin-infra"
+Repository = "https://github.com/nfraxlab/fin-infra"
+Issues = "https://github.com/nfraxlab/fin-infra/issues"
+Documentation = "https://nfrax.com/fin-infra"
 
 [tool.poetry.dependencies]
 python = ">=3.11,<4.0"
@@ -50,12 +50,25 @@ numpy = ">=1.24.0"
 numpy-financial = ">=1.0.0"
 # svc-infra = { path = "../svc-infra", develop = true }  # Local dev only - uncomment for local development
 
-# Provider dependencies (installed by default for easy_* functions)
-yahooquery = ">=2.3.0"
-ccxt = ">=4.0.0"
-plaid-python = ">=25.0.0"
+# ai-infra for LLM-powered features (always included)
 ai-infra = ">=0.1.142"
 
+# Optional provider dependencies (install via extras)
+yahooquery = { version = ">=2.3.0", optional = true }
+ccxt = { version = ">=4.0.0", optional = true }
+plaid-python = { version = ">=25.0.0", optional = true }
+
+[tool.poetry.extras]
+# Market data providers
+markets = ["yahooquery", "ccxt"]
+yahoo = ["yahooquery"]
+crypto = ["ccxt"]
+# Banking providers
+plaid = ["plaid-python"]
+banking = ["plaid-python"]
+# All providers
+all = ["yahooquery", "ccxt", "plaid-python"]
+
 [tool.poetry.group.dev.dependencies]
 pytest = ">=8.0.0"
 pytest-asyncio = ">=0.23.0"

fin_infra-0.1.73/src/fin_infra/__init__.py

@@ -0,0 +1,72 @@
+"""fin_infra: Financial Infrastructure Toolkit.
+
+A comprehensive financial infrastructure library providing:
+- Banking integration (Plaid, Teller, MX)
+- Brokerage integration (Alpaca, Interactive Brokers)
+- Market data (stocks, crypto, forex)
+- Credit scores (Experian, Equifax, TransUnion)
+- Financial calculations (NPV, IRR, PMT, FV, PV)
+- Portfolio analytics (returns, allocation, benchmarking)
+- Transaction categorization (rule-based + ML)
+- Budget management and cash flow analysis
+- Net worth tracking and goal management
+
+Example:
+    from fin_infra.banking import easy_banking
+    from fin_infra.markets import easy_market
+
+    banking = easy_banking()
+    market = easy_market()
+    quote = market.quote("AAPL")
+"""
+
+from __future__ import annotations
+
+# Core modules - can be imported as `from fin_infra import banking`
+from . import (
+    analytics,
+    banking,
+    brokerage,
+    budgets,
+    cashflows,
+    categorization,
+    credit,
+    crypto,
+    investments,
+    markets,
+    net_worth,
+    recurring,
+    tax,
+)
+
+# Base exceptions
+from .exceptions import (
+    FinInfraError,
+    ProviderError,
+    ProviderNotFoundError,
+    ValidationError,
+)
+from .version import __version__
+
+__all__ = [
+    "__version__",
+    # Core modules
+    "analytics",
+    "banking",
+    "brokerage",
+    "budgets",
+    "cashflows",
+    "categorization",
+    "credit",
+    "crypto",
+    "investments",
+    "markets",
+    "net_worth",
+    "recurring",
+    "tax",
+    # Base errors
+    "FinInfraError",
+    "ProviderError",
+    "ProviderNotFoundError",
+    "ValidationError",
+]

{fin_infra-0.1.72 → fin_infra-0.1.73}/src/fin_infra/investments/providers/plaid.py

@@ -12,19 +12,33 @@ from datetime import date
 from decimal import Decimal
 from typing import Any, Dict, List, Optional, cast
 
-from plaid.api import plaid_api
-from plaid.model.investments_holdings_get_request import InvestmentsHoldingsGetRequest
-from plaid.model.investments_transactions_get_request import (
-    InvestmentsTransactionsGetRequest,
-)
-from plaid.model.investments_holdings_get_response import InvestmentsHoldingsGetResponse
-from plaid.model.investments_transactions_get_response import (
-    InvestmentsTransactionsGetResponse,
-)
-from plaid.exceptions import ApiException
-import plaid
-from plaid.api_client import ApiClient
-from plaid.configuration import Configuration
+try:
+    from plaid.api import plaid_api
+    from plaid.model.investments_holdings_get_request import InvestmentsHoldingsGetRequest
+    from plaid.model.investments_transactions_get_request import (
+        InvestmentsTransactionsGetRequest,
+    )
+    from plaid.model.investments_holdings_get_response import InvestmentsHoldingsGetResponse
+    from plaid.model.investments_transactions_get_response import (
+        InvestmentsTransactionsGetResponse,
+    )
+    from plaid.exceptions import ApiException
+    import plaid
+    from plaid.api_client import ApiClient
+    from plaid.configuration import Configuration
+
+    HAS_PLAID = True
+except ImportError:  # pragma: no cover
+    HAS_PLAID = False
+    plaid_api = None
+    plaid = None
+    ApiClient = None
+    Configuration = None
+    ApiException = Exception
+    InvestmentsHoldingsGetRequest = Any
+    InvestmentsTransactionsGetRequest = Any
+    InvestmentsHoldingsGetResponse = Any
+    InvestmentsTransactionsGetResponse = Any
 
 from ..models import (
     Holding,
@@ -36,6 +50,15 @@ from ..models import (
 from .base import InvestmentProvider
 
 
+def _require_plaid() -> None:
+    """Raise ImportError if plaid-python is not installed."""
+    if not HAS_PLAID:
+        raise ImportError(
+            "Plaid support requires the 'plaid-python' package. "
+            "Install with: pip install fin-infra[plaid] or pip install fin-infra[banking]"
+        )
+
+
 class PlaidInvestmentProvider(InvestmentProvider):
     """Plaid Investment API provider.
 
@@ -76,7 +99,10 @@ class PlaidInvestmentProvider(InvestmentProvider):
 
         Raises:
             ValueError: If client_id or secret is missing
+            ImportError: If plaid-python is not installed
         """
+        _require_plaid()
+
         if not client_id or not secret:
             raise ValueError("client_id and secret are required for Plaid provider")
 

{fin_infra-0.1.72 → fin_infra-0.1.73}/src/fin_infra/providers/market/ccxt_crypto.py

@@ -2,15 +2,31 @@ from __future__ import annotations
 
 from typing import Any, cast
 
-import ccxt
+try:
+    import ccxt
+
+    HAS_CCXT = True
+except ImportError:  # pragma: no cover
+    HAS_CCXT = False
+    ccxt = None
 
 from ..base import CryptoDataProvider
 
 
+def _require_ccxt() -> None:
+    """Raise ImportError if ccxt is not installed."""
+    if not HAS_CCXT:
+        raise ImportError(
+            "Crypto exchange support requires the 'ccxt' package. "
+            "Install with: pip install fin-infra[crypto] or pip install fin-infra[markets]"
+        )
+
+
 class CCXTCryptoData(CryptoDataProvider):
     """Exchange-agnostic crypto market data using CCXT."""
 
     def __init__(self, exchange: str = "binance") -> None:
+        _require_ccxt()
         if not hasattr(ccxt, exchange):
             raise ValueError(f"Unknown exchange '{exchange}' in ccxt")
         self.exchange = getattr(ccxt, exchange)()

{fin_infra-0.1.72 → fin_infra-0.1.73}/src/fin_infra/providers/market/yahoo.py

@@ -14,12 +14,27 @@ from typing import Sequence
 from decimal import Decimal
 from datetime import datetime, timezone
 
-from yahooquery import Ticker
+try:
+    from yahooquery import Ticker
+
+    HAS_YAHOOQUERY = True
+except ImportError:  # pragma: no cover
+    HAS_YAHOOQUERY = False
+    Ticker = None
 
 from .base import MarketDataProvider
 from ...models import Quote, Candle
 
 
+def _require_yahooquery() -> None:
+    """Raise ImportError if yahooquery is not installed."""
+    if not HAS_YAHOOQUERY:
+        raise ImportError(
+            "Yahoo Finance support requires the 'yahooquery' package. "
+            "Install with: pip install fin-infra[yahoo] or pip install fin-infra[markets]"
+        )
+
+
 class YahooFinanceMarketData(MarketDataProvider):
     """Yahoo Finance provider (zero config, no API key needed).
 
@@ -42,7 +57,7 @@ class YahooFinanceMarketData(MarketDataProvider):
 
     def __init__(self) -> None:
         """Initialize Yahoo Finance provider (no configuration needed)."""
-        pass
+        _require_yahooquery()
 
     def quote(self, symbol: str) -> Quote:
         """Get real-time quote for a symbol.

fin_infra-0.1.72/src/fin_infra/__init__.py

@@ -1,22 +0,0 @@
-"""fin_infra: Financial infrastructure toolkit.
-
-Public surface is intentionally small at this stage. Import from submodules for
-specific domains (clients, models, markets, credit).
-"""
-
-from .exceptions import (
-    FinInfraError,
-    ProviderError,
-    ProviderNotFoundError,
-    ValidationError,
-)
-from .version import __version__
-
-__all__ = [
-    "__version__",
-    # Base errors
-    "FinInfraError",
-    "ProviderError",
-    "ProviderNotFoundError",
-    "ValidationError",
-]