chstockdata 0.2.0__tar.gz → 0.4.2__tar.gz

chstockdata-0.4.2/MANIFEST.in

@@ -0,0 +1,6 @@
+recursive-include tests/fixtures *
+include scripts/check_rh1_static.py scripts/check_release_version.py
+include docs/audits/evidence/2026-10-10-v0.4.2-tdx-historical-execution/tdx_history_responses.jsonl
+include docs/audits/evidence/2026-10-10-v0.4.2-tdx-historical-execution/tdx_opening_page_responses.jsonl
+include docs/audits/evidence/2026-10-10-v0.4.2-tdx-historical-execution/tdx_opening_page_followup_responses.jsonl
+include docs/audits/evidence/2026-10-10-v0.4.2-tdx-historical-execution/tdx_opening_page_final_responses.jsonl

{chstockdata-0.2.0/src/chstockdata.egg-info → chstockdata-0.4.2}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: chstockdata
-Version: 0.2.0
-Summary: Free China A-share market data toolkit: direct HTTP/TCP vendors (Tencent, mootdx/TDX, Eastmoney, Sina, THS, CLS, SSE/SZSE), no API keys, no third-party data SDKs
+Version: 0.4.2
+Summary: Free China A-share market data toolkit: direct HTTP/TCP vendors (Tencent, mootdx/TDX, Eastmoney, Sina, THS, CLS, SSE/SZSE), no API keys, no mandatory third-party market-data SDK in the core path; optional mootdx/baostock integrations
 Author: joycoding2000
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -232,28 +232,41 @@ Requires-Dist: lxml>=4.9.0
 Requires-Dist: stockstats>=0.6.5
 Provides-Extra: mootdx
 Requires-Dist: mootdx>=0.10.0; extra == "mootdx"
+Provides-Extra: opening-pdf
+Requires-Dist: pypdf>=6.0; extra == "opening-pdf"
 Provides-Extra: baostock
 Requires-Dist: baostock>=0.8.9; extra == "baostock"
 Provides-Extra: mcp
-Requires-Dist: mcp>=1.0; extra == "mcp"
+Requires-Dist: mcp<2,>=1.0; extra == "mcp"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: ruff<0.17,>=0.16.6; extra == "dev"
 Dynamic: license-file
 
 # chstockdata
 
 Free China A-share market data toolkit — direct HTTP/TCP access to public
-quote vendors, **no API keys, no third-party data SDKs** (akshare-free by
-design), battle-tested in production by
+quote vendors, **no API keys, no mandatory third-party market-data SDK in
+the core path** (akshare-free by design). Optional integrations are
+available for specific capabilities: `[mootdx]` unlocks the TCP K-line
+primary source, `[baostock]` historical turnover for CYQ chips.
+Battle-tested in production by
 [TradingAgents-astock](https://github.com/joycoding2000/TradingAgents-astock).
 
 ```bash
-pip install chstockdata          # core (pandas/requests only)
+pip install chstockdata          # core package (base dependencies)
 pip install "chstockdata[mootdx]"    # + mootdx TCP K-line source (optional)
 pip install "chstockdata[baostock]"  # + historical turnover for CYQ chips (optional)
+pip install "chstockdata[mcp]"       # + MCP server entry point (optional)
 ```
 
+The optional profiles are supported independently. The MCP extra currently
+stays on the MCP 1.x API because the MCP 2.x server API is not compatible with
+this entry point. Within that supported range, `mootdx` pins `httpx==0.25.2`
+while MCP 1.x requires `httpx>=0.27.1`; a clean resolver therefore rejects
+`chstockdata[mootdx,mcp]`. Keep those two profiles in separate environments
+until the upstream constraints converge.
+
 ```python
 from chstockdata import get_stock_data, get_realtime_snapshot, resolve_ticker
 
@@ -262,7 +275,55 @@ df = get_stock_data("600519", 365)    # daily OHLCV, vipdoc/mootdx/Sina chain
 get_realtime_snapshot("600519")       # realtime quote, Tencent -> mootdx -> Sina
 ```
 
-53 public functions: K-lines, realtime quotes, fundamentals / three financial
+## Structured API（v0.4.1 release candidate）
+
+The structured surface is additive and returns `FetchResult` objects. The
+quote route keeps its provider functions injectable; `quote_fetchers` below is
+a mapping whose values accept the existing `fetcher(codes, fallback_from=...)`
+shape, and `to_finite_number` is the caller's numeric coercion helper.
+
+```python
+from chstockdata import (
+    fetch_realtime_quotes,
+    fetch_daily_bars,
+    fetch_trading_calendar,
+    fetch_suspension_info,
+    fetch_delisting_status,
+    fetch_tradability,
+)
+
+quotes = fetch_realtime_quotes(
+    ["600519"], quote_fetchers, quote_number=to_finite_number
+)
+bars = fetch_daily_bars("600519", "2026-01-01", "2026-09-22")
+calendar = fetch_trading_calendar(today="2026-09-22")
+suspension = fetch_suspension_info("600519", "2026-09-22")
+delisting = fetch_delisting_status("600519")
+tradability = fetch_tradability("600519", "2026-09-22")
+```
+
+Consumer-facing status guide:
+
+| Field | Meaning |
+|---|---|
+| `metadata.final_status` | Attempt-derived provider/routing conclusion. |
+| `metadata.request_status` | Request-level result consumers should branch on. |
+| `metadata.outcome_status` | Optional engine-declared request override; otherwise `None`. |
+| `metadata.providers_used` | Providers that actually contributed the returned payload. |
+| `metadata.limitations` | Coverage, staleness, partial-data, or validation caveats. |
+
+Cache-only results intentionally have `attempts=[]` and
+`final_status="skipped"`, while `request_status` may be
+`"success"` or `"normal_empty"`. Do not mechanically treat
+`succeeded=False` or `final_status="skipped"` as unusable cache data; use
+`request_status` for the request decision. A `tradable=True` result only means
+the currently covered calendar, delisting-date, and suspension facts support
+that verdict; it does not promise complete IPO or listing-lifecycle
+eligibility.
+
+The public surface combines legacy callables, structured result types,
+constants, and compatibility exports; `__all__` is not a count of functions.
+It covers K-lines, realtime quotes, fundamentals / three financial
 statements, valuation history, margin trading, dragon-tiger board (per-stock
 seats and whole-market daily), lockup expiry, northbound flow, fund flow, board
 fund flow, industry comparison, concept blocks, block trades, market breadth,
@@ -271,7 +332,9 @@ distribution, ETF option chains (T-quote + greeks + IV), investor Q&A (互动易
 hot rank / popularity rank / concept hits, insider transactions, shareholder
 pledge / buyback, corporate actions, earnings forecast, research reports, news
 wires, policy news, macro indicators, trading calendar, delisting / suspension
-info, and more. See `chstockdata/__init__.py` for the full export list.
+info, and more. See `chstockdata/__init__.py` for the full export list. The
+candidate package version is `0.4.1`; `0.3.0` is the prior consumer
+compatibility baseline. This release candidate has not been published.
 
 ## Data sources
 

{chstockdata-0.2.0 → chstockdata-0.4.2}/README.md

@@ -1,16 +1,27 @@
 # chstockdata
 
 Free China A-share market data toolkit — direct HTTP/TCP access to public
-quote vendors, **no API keys, no third-party data SDKs** (akshare-free by
-design), battle-tested in production by
+quote vendors, **no API keys, no mandatory third-party market-data SDK in
+the core path** (akshare-free by design). Optional integrations are
+available for specific capabilities: `[mootdx]` unlocks the TCP K-line
+primary source, `[baostock]` historical turnover for CYQ chips.
+Battle-tested in production by
 [TradingAgents-astock](https://github.com/joycoding2000/TradingAgents-astock).
 
 ```bash
-pip install chstockdata          # core (pandas/requests only)
+pip install chstockdata          # core package (base dependencies)
 pip install "chstockdata[mootdx]"    # + mootdx TCP K-line source (optional)
 pip install "chstockdata[baostock]"  # + historical turnover for CYQ chips (optional)
+pip install "chstockdata[mcp]"       # + MCP server entry point (optional)
 ```
 
+The optional profiles are supported independently. The MCP extra currently
+stays on the MCP 1.x API because the MCP 2.x server API is not compatible with
+this entry point. Within that supported range, `mootdx` pins `httpx==0.25.2`
+while MCP 1.x requires `httpx>=0.27.1`; a clean resolver therefore rejects
+`chstockdata[mootdx,mcp]`. Keep those two profiles in separate environments
+until the upstream constraints converge.
+
 ```python
 from chstockdata import get_stock_data, get_realtime_snapshot, resolve_ticker
 
@@ -19,7 +30,55 @@ df = get_stock_data("600519", 365)    # daily OHLCV, vipdoc/mootdx/Sina chain
 get_realtime_snapshot("600519")       # realtime quote, Tencent -> mootdx -> Sina
 ```
 
-53 public functions: K-lines, realtime quotes, fundamentals / three financial
+## Structured API（v0.4.1 release candidate）
+
+The structured surface is additive and returns `FetchResult` objects. The
+quote route keeps its provider functions injectable; `quote_fetchers` below is
+a mapping whose values accept the existing `fetcher(codes, fallback_from=...)`
+shape, and `to_finite_number` is the caller's numeric coercion helper.
+
+```python
+from chstockdata import (
+    fetch_realtime_quotes,
+    fetch_daily_bars,
+    fetch_trading_calendar,
+    fetch_suspension_info,
+    fetch_delisting_status,
+    fetch_tradability,
+)
+
+quotes = fetch_realtime_quotes(
+    ["600519"], quote_fetchers, quote_number=to_finite_number
+)
+bars = fetch_daily_bars("600519", "2026-01-01", "2026-09-22")
+calendar = fetch_trading_calendar(today="2026-09-22")
+suspension = fetch_suspension_info("600519", "2026-09-22")
+delisting = fetch_delisting_status("600519")
+tradability = fetch_tradability("600519", "2026-09-22")
+```
+
+Consumer-facing status guide:
+
+| Field | Meaning |
+|---|---|
+| `metadata.final_status` | Attempt-derived provider/routing conclusion. |
+| `metadata.request_status` | Request-level result consumers should branch on. |
+| `metadata.outcome_status` | Optional engine-declared request override; otherwise `None`. |
+| `metadata.providers_used` | Providers that actually contributed the returned payload. |
+| `metadata.limitations` | Coverage, staleness, partial-data, or validation caveats. |
+
+Cache-only results intentionally have `attempts=[]` and
+`final_status="skipped"`, while `request_status` may be
+`"success"` or `"normal_empty"`. Do not mechanically treat
+`succeeded=False` or `final_status="skipped"` as unusable cache data; use
+`request_status` for the request decision. A `tradable=True` result only means
+the currently covered calendar, delisting-date, and suspension facts support
+that verdict; it does not promise complete IPO or listing-lifecycle
+eligibility.
+
+The public surface combines legacy callables, structured result types,
+constants, and compatibility exports; `__all__` is not a count of functions.
+It covers K-lines, realtime quotes, fundamentals / three financial
 statements, valuation history, margin trading, dragon-tiger board (per-stock
 seats and whole-market daily), lockup expiry, northbound flow, fund flow, board
 fund flow, industry comparison, concept blocks, block trades, market breadth,
@@ -28,7 +87,9 @@ distribution, ETF option chains (T-quote + greeks + IV), investor Q&A (互动易
 hot rank / popularity rank / concept hits, insider transactions, shareholder
 pledge / buyback, corporate actions, earnings forecast, research reports, news
 wires, policy news, macro indicators, trading calendar, delisting / suspension
-info, and more. See `chstockdata/__init__.py` for the full export list.
+info, and more. See `chstockdata/__init__.py` for the full export list. The
+candidate package version is `0.4.1`; `0.3.0` is the prior consumer
+compatibility baseline. This release candidate has not been published.
 
 ## Data sources