pypsx-toolkit 3.0.3__tar.gz → 3.1.0__tar.gz

{pypsx_toolkit-3.0.3 → pypsx_toolkit-3.1.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: pypsx-toolkit
-Version: 3.0.3
+Version: 3.1.0
 Summary: Pakistan Stock Exchange (PSX) data library with yfinance-like API
-Author-email: PyPSX Team <contact@pypsx.dev>
-Maintainer-email: PyPSX Team <contact@pypsx.dev>
+Author-email: PyPSX Team <pypsxofficial@gmail.com>
+Maintainer-email: PyPSX Team <pypsxofficial@gmail.com>
 License: Copyright (c) 2026 PyPSX Team. All rights reserved.
         
         This software and associated documentation files (the "Software") are the
@@ -32,24 +32,25 @@ Classifier: Intended Audience :: Financial and Insurance Industry
 Classifier: License :: Other/Proprietary License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Office/Business :: Financial
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Scientific/Engineering :: Information Analysis
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.31.0
 Requires-Dist: beautifulsoup4>=4.12.0
 Requires-Dist: lxml>=4.9.0
-Requires-Dist: pandas<2.3.3,>=2.0.0
+Requires-Dist: pandas<3.0.0,>=2.0.0
 Requires-Dist: loguru>=0.7.0
-Requires-Dist: numpy<2.3.0,>=1.24.0
+Requires-Dist: numpy<2.4.0,>=1.24.0
+Requires-Dist: tqdm>=4.66.0
 Provides-Extra: plot
 Requires-Dist: matplotlib>=3.5.0; extra == "plot"
 Requires-Dist: seaborn>=0.11.0; extra == "plot"
@@ -67,7 +68,7 @@ Dynamic: license-file
 
 # pypsx-toolkit — Pakistan Stock Exchange Data Library
 
-A clean, simple Python library to fetch and analyze Pakistan Stock Exchange (PSX) data from official DPS endpoints. Get real-time market data, historical prices, and powerful analysis tools all in one package — no authentication required.
+A clean, simple Python library to fetch and analyze Pakistan Stock Exchange (PSX) market data. Get real-time market data, historical prices, and powerful analysis tools all in one package — no authentication required.
 
 ## Installation
 
@@ -218,7 +219,7 @@ ticker = pypsx_toolkit.PSXTicker("OGDC")
 - `ticker.history(period="1y", interval="1d")` - Get historical data
 - `ticker.intraday()` - Get intraday trades (last ~2 days)
 - `ticker.get_historical(start_date, end_date)` - Get full OHLCV data for date range
-- `ticker.dividends()` - Get dividend information (external source)
+- `ticker.dividends()` - Get dividend information
 - `ticker.announcements()` - Get company announcements
 - `ticker.orderbook()` - Get trading board data (bid/ask prices)
 
@@ -505,17 +506,6 @@ historical = ticker.get_historical(
 print(historical.head())
 ```
 
-## Data Sources
-
-PyPSX Toolkit uses official Pakistan Stock Exchange DPS endpoints:
-- Market Watch: `https://dps.psx.com.pk/market-watch`
-- Sector Summary: `https://dps.psx.com.pk/sector-summary/sectorwise`
-- Indices: `https://dps.psx.com.pk/indices/{INDEX}`
-- Trading Board: `https://dps.psx.com.pk/trading-board/REG/main`
-- Performers: `https://dps.psx.com.pk/performers`
-- Timeseries: `https://dps.psx.com.pk/timeseries/int/{SYMBOL}`, `.../eod/{SYMBOL}`
-- Historical OHLCV: `https://dps.psx.com.pk/historical`
-
 ## Examples
 
 ### Example 1: Find Top Volume Stocks
@@ -605,22 +595,24 @@ for insight in analysis["portfolio_insights"]:
 ### PSXTicker Class
 
 ```python
-ticker = pypsx_toolkit.PSXTicker(symbol: str)
+import pypsx_toolkit
+
+ticker = pypsx_toolkit.PSXTicker("OGDC")
 
-# Properties
+# Properties (no parentheses)
 ticker.info                    # Dict with company info
 ticker.snapshot                # Dict with comprehensive snapshot data from all tabs
-ticker.fast_info              # Quick metrics dict
+ticker.fast_info               # Quick metrics dict
 
 # Methods
-ticker.history(period="1y", interval="1d")    # Historical data
-ticker.intraday()                             # Intraday trades
-ticker.get_historical(start_date, end_date)   # Full OHLCV data
-ticker.market_watch()                         # Market watch row
-ticker.sector()                               # Sector information
-ticker.orderbook()                            # Trading board data
-ticker.dividends()                            # DataFrame with dividends
-ticker.announcements()                        # DataFrame with announcements
+ticker.history(period="1y", interval="1d")            # Historical data
+ticker.intraday()                                     # Intraday trades
+ticker.get_historical("2024-01-01", "2024-12-31")     # Full OHLCV data
+ticker.market_watch()                                 # Market watch row
+ticker.sector()                                       # Sector information
+ticker.orderbook()                                    # Trading board data
+ticker.dividends()                                    # DataFrame with dividends
+ticker.announcements()                                # DataFrame with announcements
 ```
 
 ### Market Functions
@@ -650,9 +642,13 @@ pypsx_toolkit.get_snapshot(symbol)              # Get snapshot data from all tab
 ### Download Functions
 
 ```python
-pypsx_toolkit.download(symbols, period="1y", interval="1d")    # Batch download
-pypsx_toolkit.get_intraday_multiple(symbols)                   # Multiple intraday
-pypsx_toolkit.get_historical(symbol, start_date, end_date)    # Historical OHLCV
+import pypsx_toolkit
+
+symbols = ["OGDC", "HBL"]
+
+pypsx_toolkit.download(symbols, period="1y", interval="1d")         # Batch download
+pypsx_toolkit.get_intraday_multiple(symbols)                        # Multiple intraday
+pypsx_toolkit.get_historical("OGDC", "2024-01-01", "2024-12-31")    # Historical OHLCV
 ```
 
 ## Backward Compatibility
@@ -663,7 +659,7 @@ The library maintains backward compatibility:
 
 ## Notes
 
-- **Dividends**: PSX doesn't provide a dividends endpoint. The `dividends` property uses an external data source.
+- **Dividends**: dividend records use their own column naming, which differs from the conventions used elsewhere in the toolkit.
 - **Data Availability**: Some data may not be available when the market is closed.
 - **Symbol Names**: Use official PSX symbols (e.g., "OGDC", "PPL", "KEL").
 

{pypsx_toolkit-3.0.3 → pypsx_toolkit-3.1.0}/README.md

@@ -1,6 +1,6 @@
 # pypsx-toolkit — Pakistan Stock Exchange Data Library
 
-A clean, simple Python library to fetch and analyze Pakistan Stock Exchange (PSX) data from official DPS endpoints. Get real-time market data, historical prices, and powerful analysis tools all in one package — no authentication required.
+A clean, simple Python library to fetch and analyze Pakistan Stock Exchange (PSX) market data. Get real-time market data, historical prices, and powerful analysis tools all in one package — no authentication required.
 
 ## Installation
 
@@ -151,7 +151,7 @@ ticker = pypsx_toolkit.PSXTicker("OGDC")
 - `ticker.history(period="1y", interval="1d")` - Get historical data
 - `ticker.intraday()` - Get intraday trades (last ~2 days)
 - `ticker.get_historical(start_date, end_date)` - Get full OHLCV data for date range
-- `ticker.dividends()` - Get dividend information (external source)
+- `ticker.dividends()` - Get dividend information
 - `ticker.announcements()` - Get company announcements
 - `ticker.orderbook()` - Get trading board data (bid/ask prices)
 
@@ -438,17 +438,6 @@ historical = ticker.get_historical(
 print(historical.head())
 ```
 
-## Data Sources
-
-PyPSX Toolkit uses official Pakistan Stock Exchange DPS endpoints:
-- Market Watch: `https://dps.psx.com.pk/market-watch`
-- Sector Summary: `https://dps.psx.com.pk/sector-summary/sectorwise`
-- Indices: `https://dps.psx.com.pk/indices/{INDEX}`
-- Trading Board: `https://dps.psx.com.pk/trading-board/REG/main`
-- Performers: `https://dps.psx.com.pk/performers`
-- Timeseries: `https://dps.psx.com.pk/timeseries/int/{SYMBOL}`, `.../eod/{SYMBOL}`
-- Historical OHLCV: `https://dps.psx.com.pk/historical`
-
 ## Examples
 
 ### Example 1: Find Top Volume Stocks
@@ -538,22 +527,24 @@ for insight in analysis["portfolio_insights"]:
 ### PSXTicker Class
 
 ```python
-ticker = pypsx_toolkit.PSXTicker(symbol: str)
+import pypsx_toolkit
+
+ticker = pypsx_toolkit.PSXTicker("OGDC")
 
-# Properties
+# Properties (no parentheses)
 ticker.info                    # Dict with company info
 ticker.snapshot                # Dict with comprehensive snapshot data from all tabs
-ticker.fast_info              # Quick metrics dict
+ticker.fast_info               # Quick metrics dict
 
 # Methods
-ticker.history(period="1y", interval="1d")    # Historical data
-ticker.intraday()                             # Intraday trades
-ticker.get_historical(start_date, end_date)   # Full OHLCV data
-ticker.market_watch()                         # Market watch row
-ticker.sector()                               # Sector information
-ticker.orderbook()                            # Trading board data
-ticker.dividends()                            # DataFrame with dividends
-ticker.announcements()                        # DataFrame with announcements
+ticker.history(period="1y", interval="1d")            # Historical data
+ticker.intraday()                                     # Intraday trades
+ticker.get_historical("2024-01-01", "2024-12-31")     # Full OHLCV data
+ticker.market_watch()                                 # Market watch row
+ticker.sector()                                       # Sector information
+ticker.orderbook()                                    # Trading board data
+ticker.dividends()                                    # DataFrame with dividends
+ticker.announcements()                                # DataFrame with announcements
 ```
 
 ### Market Functions
@@ -583,9 +574,13 @@ pypsx_toolkit.get_snapshot(symbol)              # Get snapshot data from all tab
 ### Download Functions
 
 ```python
-pypsx_toolkit.download(symbols, period="1y", interval="1d")    # Batch download
-pypsx_toolkit.get_intraday_multiple(symbols)                   # Multiple intraday
-pypsx_toolkit.get_historical(symbol, start_date, end_date)    # Historical OHLCV
+import pypsx_toolkit
+
+symbols = ["OGDC", "HBL"]
+
+pypsx_toolkit.download(symbols, period="1y", interval="1d")         # Batch download
+pypsx_toolkit.get_intraday_multiple(symbols)                        # Multiple intraday
+pypsx_toolkit.get_historical("OGDC", "2024-01-01", "2024-12-31")    # Historical OHLCV
 ```
 
 ## Backward Compatibility
@@ -596,7 +591,7 @@ The library maintains backward compatibility:
 
 ## Notes
 
-- **Dividends**: PSX doesn't provide a dividends endpoint. The `dividends` property uses an external data source.
+- **Dividends**: dividend records use their own column naming, which differs from the conventions used elsewhere in the toolkit.
 - **Data Availability**: Some data may not be available when the market is closed.
 - **Symbol Names**: Use official PSX symbols (e.g., "OGDC", "PPL", "KEL").
 

{pypsx_toolkit-3.0.3 → pypsx_toolkit-3.1.0}/pyproject.toml

@@ -4,16 +4,18 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pypsx-toolkit"
-version = "3.0.3"
+version = "3.1.0"
 description = "Pakistan Stock Exchange (PSX) data library with yfinance-like API"
 readme = "README.md"
-requires-python = ">=3.8"
+# 3.10 is the real floor: `pandas>=2.0` already excludes 3.8/3.9, and
+# core/utils.py uses PEP 604 (`int | None`) in a runtime signature.
+requires-python = ">=3.10"
 license = { file = "LICENSE" }
 authors = [
-  { name = "PyPSX Team", email = "contact@pypsx.dev" }
+  { name = "PyPSX Team", email = "pypsxofficial@gmail.com" }
 ]
 maintainers = [
-  { name = "PyPSX Team", email = "contact@pypsx.dev" }
+  { name = "PyPSX Team", email = "pypsxofficial@gmail.com" }
 ]
 keywords = ["psx", "pakistan", "stock", "finance", "data", "api", "pandas", "yfinance", "market-data"]
 classifiers = [
@@ -23,11 +25,11 @@ classifiers = [
   "License :: Other/Proprietary License",
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.8",
-  "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Programming Language :: Python :: 3 :: Only",
   "Topic :: Office/Business :: Financial",
   "Topic :: Software Development :: Libraries :: Python Modules",
@@ -38,9 +40,17 @@ dependencies = [
   "requests>=2.31.0",
   "beautifulsoup4>=4.12.0",
   "lxml>=4.9.0",
-  "pandas>=2.0.0,<2.3.3",
+  # See pypsx_dev/pyproject.toml's identical pins for the reasoning: the
+  # ceiling must not exclude the first cp314-wheel release (pandas 2.3.3,
+  # numpy 2.3.2), and is deliberately kept below pandas 3.0 (mandatory CoW +
+  # other breaking changes) pending its own review.
+  "pandas>=2.0.0,<3.0.0",
   "loguru>=0.7.0",
-  "numpy>=1.24.0,<2.3.0",
+  "numpy>=1.24.0,<2.4.0",
+  # Imported by api.py, endpoints/historical.py and core/utils.py. Those imports
+  # are try/except-guarded with a no-op fallback, but the fallback path is
+  # untested and every target environment (including Colab) already ships tqdm.
+  "tqdm>=4.66.0",
 ]
 
 [project.optional-dependencies]
@@ -61,8 +71,12 @@ Homepage = "https://pypsx.com"
 Documentation = "https://markets.pypsx.com/docs"
 Changelog = "https://markets.pypsx.com/docs/changelog"
 
-[project.scripts]
-pypsx-toolkit = "pypsx_toolkit:quick_start"
+# NOTE: no [project.scripts]. This previously declared
+#   pypsx-toolkit = "pypsx_toolkit:quick_start"
+# but `quick_start` does not exist anywhere in the package, so the installed
+# console script raised AttributeError on every invocation. This library has no
+# CLI; removing the entry point is the honest fix. If a CLI is wanted later,
+# implement the target function first.
 
 [tool.setuptools]
 include-package-data = true
@@ -152,8 +166,10 @@ markers = [
   "integration: marks tests as integration tests",
   "unit: marks tests as unit tests",
 ]
-filterwarnings = [
-  "ignore::DeprecationWarning",
-  "ignore::PendingDeprecationWarning",
-]
+# NOTE: deliberately no blanket `filterwarnings = ["ignore::DeprecationWarning"]`
+# here. The Colab-mirror suite (b2c/tests/colab_mirror/) runs under
+# `filterwarnings = error` because a warning in a notebook cell is a user-visible
+# defect. A blanket ignore at this level hides exactly the class of bug that
+# suite exists to catch. Allow-list individual warnings there, with an owner and
+# an expiry, instead of re-adding a catch-all.
 

{pypsx_toolkit-3.0.3 → pypsx_toolkit-3.1.0}/pypsx_toolkit/__init__.py

@@ -2,9 +2,9 @@
 PSX yfinance-style API
 """
 
-__version__ = "3.0.3"
+__version__ = "3.1.0"
 __author__ = "PyPSX Team"
-__email__ = "pypsx@example.com"
+__email__ = "pypsxofficial@gmail.com"
 
 from pypsx_toolkit.ticker import PSXTicker, Ticker
 
@@ -37,6 +37,14 @@ from pypsx_toolkit.endpoints.sectors import get_sector_constituents as _get_sect
 from pypsx_toolkit.endpoints.compliant_listings import get_symbols_by_sector as _get_symbols_by_sector
 from pypsx_toolkit.endpoints.snapshot import get_snapshot
 
+# Financial reports. Implemented and working, but previously not reachable from
+# anywhere in the public surface.
+from pypsx_toolkit.endpoints.reports import get_reports
+
+# Cache control. Useful in notebooks, where a stale cached response is a common
+# source of "why is my data wrong" confusion.
+from pypsx_toolkit.core.cache import clear_pypsx_cache, get_cache_stats
+
 from pypsx_toolkit.market import (
     top_performers,
     sector_summary,
@@ -70,18 +78,29 @@ from pypsx_toolkit.models import (
     DividendHistory,
 )
 
-# Analysis module (optional - requires analysis package)
-try:
-    from pypsx_toolkit.analysis import (
-        interpret_stock,
-        sharpe_ratio,
-        rsi,
-        macd,
-        bollinger_bands,
-    )
-except ImportError:
-    # Analysis module not available
-    pass
+# Exceptions. Previously these were reachable only via the private
+# `pypsx_toolkit.core.errors` path, which the docs told users to import from.
+# Re-exported here as the supported location; the old path still works.
+from pypsx_toolkit.core.errors import (
+    PSXError,
+    PSXHTTPError,
+    PSXTimeoutError,
+    PSXNotFoundError,
+    PSXScopeError,
+)
+
+# Analysis module. This is NOT optional -- it depends only on pandas and numpy,
+# both hard requirements of this package. It was previously wrapped in a
+# `try/except ImportError: pass`, which silently turned any genuine bug inside
+# the analysis package into a confusing AttributeError at call time.
+from pypsx_toolkit import analysis
+from pypsx_toolkit.analysis import (
+    interpret_stock,
+    sharpe_ratio,
+    rsi,
+    macd,
+    bollinger_bands,
+)
 
 __all__ = [
     "__version__",
@@ -129,6 +148,14 @@ __all__ = [
     "get_sector_constituents",
     "get_symbols_by_sector",
     "get_snapshot",
+    "get_reports",
+    # Cache control
+    "clear_pypsx_cache",
+    "get_cache_stats",
+    # NOTE: `charts` is deliberately NOT listed here. It resolves lazily via
+    # __getattr__ and needs the optional `[plot]` extra, so including it would
+    # make `from pypsx_toolkit import *` raise ImportError on a plain install.
+    # Access it as `pypsx_toolkit.charts` (see the Charting docs).
     # Models
     "SymbolInfo",
     "SectorSummary",
@@ -147,8 +174,53 @@ __all__ = [
     "Announcement",
     "DividendInfo",
     "DividendHistory",
+    # Exceptions. Also available at the original `pypsx_toolkit.core.errors` path.
+    "PSXError",
+    "PSXHTTPError",
+    "PSXTimeoutError",
+    "PSXNotFoundError",
+    "PSXScopeError",
+    # Analysis. `analysis` is the submodule (documented usage is
+    # `import pypsx_toolkit.analysis as pa`); the rest are convenience
+    # re-exports that were importable before but absent from __all__.
+    "analysis",
+    "interpret_stock",
+    "sharpe_ratio",
+    "rsi",
+    "macd",
+    "bollinger_bands",
 ]
 
+# `market_watch_func` / `get_indices_func` are internal aliases created to avoid
+# colliding with the same-named api.py functions. They stay bound for backward
+# compatibility but are deliberately excluded from __all__ above -- they are not
+# part of the supported surface. Use `market_watch()` / `get_indices()`.
+
+
+def __getattr__(name: str):
+    """
+    Lazily expose `pypsx_toolkit.charts`.
+
+    The charting helpers need matplotlib/seaborn, which ship only under the
+    optional `[plot]` extra. Importing them eagerly would make a plain
+    `pip install pypsx-toolkit` fail at `import pypsx_toolkit`, so resolution is
+    deferred until first access and a missing extra produces an actionable
+    message instead of a bare ModuleNotFoundError.
+    """
+    if name == "charts":
+        import sys
+
+        try:
+            from pypsx_toolkit.endpoints import charts as _charts
+        except ImportError as exc:  # pragma: no cover - depends on install extras
+            raise ImportError(
+                "pypsx_toolkit.charts requires the optional plotting dependencies. "
+                "Install them with:  pip install 'pypsx-toolkit[plot]'"
+            ) from exc
+        setattr(sys.modules[__name__], "charts", _charts)
+        return _charts
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
 
 # Legacy compatibility wrappers used by audit script (clean outputs only)
 

{pypsx_toolkit-3.0.3 → pypsx_toolkit-3.1.0}/pypsx_toolkit/analysis/__init__.py

@@ -70,7 +70,16 @@ __all__ = [
     
     # Insight engine
     'interpret_stock', 'interpret_portfolio', 'detect_patterns',
-    'generate_trading_signals', 'market_sentiment_analysis'
+    'generate_trading_signals', 'market_sentiment_analysis',
+
+    # Composite helpers (defined in this module, below)
+    'quick_analysis', 'portfolio_analysis',
+
+    # Short aliases (defined at the bottom of this module). These are used in
+    # the published documentation, so they are part of the supported surface.
+    'ma', 'ema', 'bb', 'sharpe', 'sortino', 'calmar', 'cum_returns', 'max_dd',
+    'win_rate_pct', 'pl_ratio', 'recovery', 'perf_summary', 'interpret',
+    'patterns', 'signals', 'sentiment',
 ]
 
 

{pypsx_toolkit-3.0.3 → pypsx_toolkit-3.1.0}/pypsx_toolkit/api.pyi

@@ -6,9 +6,10 @@ import pandas as pd
 
 def download(
     symbols: Union[str, List[str]],
-    period: str = "1mo",
+    period: str = "1y",
     interval: str = "1d",
     to_csv: Optional[str] = None,
+    show_progress: bool = True,
 ) -> pd.DataFrame:
     """
     Download historical OHLCV data for one or more PSX symbols (yfinance-style).
@@ -18,6 +19,8 @@ def download(
         period: Time period — "1d","5d","1mo","3mo","6mo","1y","2y","5y","10y","ytd","max".
         interval: Bar interval. Only "1d" is currently supported.
         to_csv: Optional path to save the result as CSV.
+        show_progress: Display a progress bar while fetching. Set False in
+            notebooks, reports or logs where the bar is just noise.
 
     Returns:
         For a single symbol: DataFrame with [Open, High, Low, Close, Volume, Change%].
@@ -61,8 +64,6 @@ def get_intraday(symbol: str) -> pd.DataFrame:
     """
     Fetch intraday tick data for the last 2 trading days.
 
-    Runs on the user's local machine to distribute scraping traffic.
-
     Args:
         symbol: PSX ticker symbol.
 
@@ -75,12 +76,17 @@ def get_intraday(symbol: str) -> pd.DataFrame:
     ...
 
 
-def get_intraday_multiple(symbols: List[str]) -> pd.DataFrame:
+def get_intraday_multiple(
+    symbols: List[str],
+    show_progress: bool = True,
+) -> pd.DataFrame:
     """
     Fetch intraday tick data for multiple symbols in parallel.
 
     Args:
         symbols: List of PSX ticker symbols.
+        show_progress: Display a progress bar while fetching. Set False in
+            notebooks, reports or logs where the bar is just noise.
 
     Returns:
         Concatenated DataFrame with an additional "Symbol" column.

{pypsx_toolkit-3.0.3 → pypsx_toolkit-3.1.0}/setup.py

@@ -85,6 +85,27 @@ def main():
                 # embedsignature=True: embeds the Python call signature in the docstring
                 # so IDEs can show it even when the .pyi stub is absent.
                 "embedsignature": True,
+                # annotation_typing defaults to True, which makes Cython treat a
+                # PEP 484 parameter annotation like
+                # `def correlation_matrix(df_dict: Dict[str, pd.DataFrame])`
+                # as a `cdef dict` declaration and enforce it at the C level.
+                #
+                # Two problems, both COMPILED-ONLY -- they cannot reproduce from
+                # source, which is the worst possible failure mode here:
+                #
+                #  1. Cython's builtin-container coercion is exact-type-only, so
+                #     passing an OrderedDict/defaultdict/Counter to a
+                #     Dict[...]-annotated parameter raises TypeError even though
+                #     it is a perfectly good Mapping.
+                #  2. It pre-empts the library's own validation. The argument
+                #     checks in analysis/stats.py exist to say "correlation_matrix()
+                #     expects {symbol: DataFrame}, got a single DataFrame" -- but
+                #     with annotation_typing on, Cython rejects the call first with
+                #     a terse message naming neither the function nor the fix.
+                #
+                # pypsx set this to False for the same reason; the toolkit had
+                # been left on the default.
+                "annotation_typing": False,
             },
             build_dir="build",
             annotate=False,