chstockdata 0.4.2__tar.gz → 0.4.4__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chstockdata
-Version: 0.4.2
+Version: 0.4.4
 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
@@ -275,7 +275,19 @@ df = get_stock_data("600519", 365)    # daily OHLCV, vipdoc/mootdx/Sina chain
 get_realtime_snapshot("600519")       # realtime quote, Tencent -> mootdx -> Sina
 ```
 
-## Structured API（v0.4.1 release candidate）
+Version 0.4.4 adds four Owner-accepted, bounded capabilities: repeatable
+A-share market-window supply with explicit coverage and UNKNOWN accounting;
+current CAPCO industry membership with version identity and 31 retained
+UNKNOWN members; named ETF split/cash-event total-return supply that keeps
+the 2022-03-29 513500 gap as `INCOMPLETE`; and a narrow parent-net-profit
+ROE correction in the free financial indicators. Install with
+`python -m pip install chstockdata==0.4.4`.
+See the [v0.4.4 release notes](docs/releases/v0.4.4.md).
+These are bounded supplies: full Mishi `CURRENT_SCAN` / `HISTORICAL_REPLAY`,
+SIOS H01-B full long-window NAV/metrics, historical PIT and full-market
+DR01/DR05 qualification remain outside this release.
+
+## Structured API (v0.4.2)
 
 The structured surface is additive and returns `FetchResult` objects. The
 quote route keeps its provider functions injectable; `quote_fetchers` below is
@@ -333,8 +345,36 @@ 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. The
-candidate package version is `0.4.1`; `0.3.0` is the prior consumer
-compatibility baseline. This release candidate has not been published.
+current release version is `0.4.4`
+([PyPI](https://pypi.org/project/chstockdata/0.4.4/) /
+[GitHub Release](https://github.com/joycoding2000/chstockdata/releases/tag/v0.4.4)).
+The structured API is additive: it does not deprecate the legacy API.
+`0.3.0` remains the formal compatibility baseline for existing consumers
+that have not yet migrated; migration is not assumed.
+
+### Historical capability boundaries
+
+Suspension data is a current-day snapshot of the Eastmoney latest-event
+list, not a historical as-of database. Historical and future dates fail
+closed (`failed_structure`, limitation `historical_suspension_unavailable`):
+an empty or non-matching latest-event response — including a cached one —
+never proves that a security was tradable on a past date.
+`fetch_tradability` returns `tradable=True` only on an explicit suspension
+negative (`suspended=False` under a success / normal-empty status); missing
+or unusable suspension evidence stays `tradable=None`
+(`suspension_unknown`). A complete historical point-in-time suspension
+database is not provided in this release.
+
+`fetch_historical_opening_evidence` (policy `R2.1`) is a bounded opening
+execution evidence capability exported in v0.4.2. Consumers — for example
+SIOS, which uses it only in its explicitly selected `HISTORICAL_OPENING_R21`
+mode — opt in deliberately. It reports positive trading activity in the
+Asia/Shanghai `[09:30:00, 09:31:00)` window together with certified official
+halt events. It does not guarantee that a specific order filled at exactly
+09:30:00, and it says nothing about order queue position or individual fill
+probability. It does not replace complete historical PIT suspension coverage:
+certified official vetoes and source conflicts still force `UNKNOWN` or
+blocked results, and missing evidence stays fail-closed.
 
 ## Data sources
 

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

@@ -30,7 +30,19 @@ df = get_stock_data("600519", 365)    # daily OHLCV, vipdoc/mootdx/Sina chain
 get_realtime_snapshot("600519")       # realtime quote, Tencent -> mootdx -> Sina
 ```
 
-## Structured API（v0.4.1 release candidate）
+Version 0.4.4 adds four Owner-accepted, bounded capabilities: repeatable
+A-share market-window supply with explicit coverage and UNKNOWN accounting;
+current CAPCO industry membership with version identity and 31 retained
+UNKNOWN members; named ETF split/cash-event total-return supply that keeps
+the 2022-03-29 513500 gap as `INCOMPLETE`; and a narrow parent-net-profit
+ROE correction in the free financial indicators. Install with
+`python -m pip install chstockdata==0.4.4`.
+See the [v0.4.4 release notes](docs/releases/v0.4.4.md).
+These are bounded supplies: full Mishi `CURRENT_SCAN` / `HISTORICAL_REPLAY`,
+SIOS H01-B full long-window NAV/metrics, historical PIT and full-market
+DR01/DR05 qualification remain outside this release.
+
+## Structured API (v0.4.2)
 
 The structured surface is additive and returns `FetchResult` objects. The
 quote route keeps its provider functions injectable; `quote_fetchers` below is
@@ -88,8 +100,36 @@ 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. The
-candidate package version is `0.4.1`; `0.3.0` is the prior consumer
-compatibility baseline. This release candidate has not been published.
+current release version is `0.4.4`
+([PyPI](https://pypi.org/project/chstockdata/0.4.4/) /
+[GitHub Release](https://github.com/joycoding2000/chstockdata/releases/tag/v0.4.4)).
+The structured API is additive: it does not deprecate the legacy API.
+`0.3.0` remains the formal compatibility baseline for existing consumers
+that have not yet migrated; migration is not assumed.
+
+### Historical capability boundaries
+
+Suspension data is a current-day snapshot of the Eastmoney latest-event
+list, not a historical as-of database. Historical and future dates fail
+closed (`failed_structure`, limitation `historical_suspension_unavailable`):
+an empty or non-matching latest-event response — including a cached one —
+never proves that a security was tradable on a past date.
+`fetch_tradability` returns `tradable=True` only on an explicit suspension
+negative (`suspended=False` under a success / normal-empty status); missing
+or unusable suspension evidence stays `tradable=None`
+(`suspension_unknown`). A complete historical point-in-time suspension
+database is not provided in this release.
+
+`fetch_historical_opening_evidence` (policy `R2.1`) is a bounded opening
+execution evidence capability exported in v0.4.2. Consumers — for example
+SIOS, which uses it only in its explicitly selected `HISTORICAL_OPENING_R21`
+mode — opt in deliberately. It reports positive trading activity in the
+Asia/Shanghai `[09:30:00, 09:31:00)` window together with certified official
+halt events. It does not guarantee that a specific order filled at exactly
+09:30:00, and it says nothing about order queue position or individual fill
+probability. It does not replace complete historical PIT suspension coverage:
+certified official vetoes and source conflicts still force `UNKNOWN` or
+blocked results, and missing evidence stays fail-closed.
 
 ## Data sources
 

{chstockdata-0.4.2 → chstockdata-0.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "chstockdata"
-version = "0.4.2"
+version = "0.4.4"
 description = "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"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -62,7 +62,11 @@ Issues = "https://github.com/joycoding2000/chstockdata/issues"
 where = ["src"]
 
 [tool.setuptools.package-data]
-chstockdata = ["py.typed", "opening_known_events.json"]
+chstockdata = [
+    "py.typed", "opening_known_events.json",
+    "data/industry/*.json", "data/industry/*.jsonl",
+    "data/industry/*.csv", "data/industry/*.md",
+]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{chstockdata-0.4.2 → chstockdata-0.4.4}/src/chstockdata/__init__.py

@@ -85,6 +85,12 @@ from .a_stock import (
 
 # ── Reversed-ported upstream endpoints (v0.2.0) ─────────────────────────────
 from .board_flow import get_board_fund_flow
+from .daily_fund_flow import (
+    DailyFundFlowResult,
+    FundFlowBudget,
+    FundFlowCalendar,
+    get_sina_daily_fund_flow,
+)
 from .chips import chip_distribution, get_chip_distribution
 from .etf_options import (
     get_etf_option_chain,
@@ -111,6 +117,19 @@ from .vipdoc_history import (
     vipdoc_history_status,
 )
 
+# Bounded v0.4.4 numerical supply; consumer and Owner gates remain separate.
+from .market_supply import (
+    export_market_window,
+    read_market_package,
+    compare_market_packages,
+)
+from .etf_total_return import build_etf_total_return
+from .industry_membership import (
+    get_current_industry_members,
+    load_capco_supply,
+    load_universe_snapshot,
+)
+
 # ── Policy news ─────────────────────────────────────────────────────────────
 from .policy_news import get_policy_news_for_context
 
@@ -168,9 +187,12 @@ from .delisting import fetch_delisting_status
 from .tradability import fetch_tradability
 from .opening_evidence import fetch_historical_opening_evidence, OfficialOpeningEvent
 
-__version__ = "0.4.2"
+__version__ = "0.4.4"
 
-__all__ = [
+__all__ = [
+    "export_market_window", "read_market_package", "compare_market_packages",
+    "build_etf_total_return", "get_current_industry_members",
+    "load_capco_supply", "load_universe_snapshot",
     # config
     "configure", "get_config", "get_setting", "reset_config",
     "validate_vipdoc_history_config",
@@ -195,6 +217,7 @@ __all__ = [
     "get_corporate_buyback",
     # money flow / microstructure
     "get_fund_flow", "get_dragon_tiger_board", "get_block_trades",
+    "get_sina_daily_fund_flow", "DailyFundFlowResult", "FundFlowBudget", "FundFlowCalendar",
     "get_northbound_flow", "get_market_breadth", "get_margin_trading",
     "get_valuation_history", "get_industry_comparison", "get_concept_blocks",
     "get_daily_dragon_tiger", "get_board_fund_flow",

{chstockdata-0.4.2 → chstockdata-0.4.4}/src/chstockdata/a_stock.py

@@ -3656,6 +3656,12 @@ def get_free_financial_indicators(
     revenue = field(income_row, "营业收入", "主营业务收入")
     operating_cost = field(income_row, "营业成本", "主营业务成本")
     net_profit = field(income_row, "净利润", "归属于母公司股东的净利润")
+    parent_net_profit = field(
+        income_row,
+        "归属于母公司所有者的净利润",
+        "归属于母公司股东的净利润",
+        "归属于母公司股东净利润",
+    )
     total_assets = field(balance_row, "资产总计", "总资产")
     total_liabilities = field(balance_row, "负债合计", "总负债")
     parent_equity = field(
@@ -3747,11 +3753,24 @@ def get_free_financial_indicators(
             "归属于母公司股东的所有者权益",
         )
     roe = None
-    roe_basis = "不可用"
-    if report_period.endswith("12-31") and net_profit is not None and parent_equity is not None and previous_equity is not None:
-        roe = percent_ratio(net_profit, (parent_equity + previous_equity) / 2)
-        roe_basis = "年报净利润/平均归母权益"
-    elif net_profit is not None and parent_equity is not None and previous_equity is not None:
+    roe_basis = "缺少归母净利润或归母权益基期"
+    if report_period.endswith("12-31"):
+        if (
+            parent_net_profit is not None
+            and parent_equity is not None
+            and previous_equity is not None
+        ):
+            roe = percent_ratio(
+                parent_net_profit, (parent_equity + previous_equity) / 2
+            )
+            roe_basis = "年报归母净利润/平均归母权益"
+        elif parent_net_profit is None:
+            roe_basis = "缺少归母净利润"
+        elif parent_equity is None:
+            roe_basis = "缺少期末归母权益"
+        elif previous_equity is None:
+            roe_basis = "缺少上年同期归母权益"
+    elif parent_net_profit is not None and parent_equity is not None and previous_equity is not None:
         prior_year_end = f"{pd.Timestamp(report_period).year - 1}-12-31"
         prior_income_rows = reports["利润表"].loc[
             reports["利润表"]["报告日"].map(date_text) == prior_period
@@ -3761,17 +3780,33 @@ def get_free_financial_indicators(
         ]
         if not prior_income_rows.empty and not prior_annual_rows.empty:
             prior_same_profit = field(
-                prior_income_rows.iloc[0].to_dict(), "净利润", "归属于母公司股东的净利润"
+                prior_income_rows.iloc[0].to_dict(),
+                "归属于母公司所有者的净利润",
+                "归属于母公司股东的净利润",
+                "归属于母公司股东净利润",
             )
             prior_annual_profit = field(
-                prior_annual_rows.iloc[0].to_dict(), "净利润", "归属于母公司股东的净利润"
+                prior_annual_rows.iloc[0].to_dict(),
+                "归属于母公司所有者的净利润",
+                "归属于母公司股东的净利润",
+                "归属于母公司股东净利润",
             )
             if prior_same_profit is not None and prior_annual_profit is not None:
                 roe = percent_ratio(
-                    net_profit + prior_annual_profit - prior_same_profit,
+                    parent_net_profit + prior_annual_profit - prior_same_profit,
                     (parent_equity + previous_equity) / 2,
                 )
-                roe_basis = "TTM净利润/平均归母权益"
+                roe_basis = "TTM归母净利润/平均归母权益"
+            else:
+                roe_basis = "缺少上年同期或上年年报归母净利润"
+        else:
+            roe_basis = "缺少上年同期或上年年报归母净利润"
+    elif parent_net_profit is None:
+        roe_basis = "缺少归母净利润"
+    elif parent_equity is None:
+        roe_basis = "缺少期末归母权益"
+    elif previous_equity is None:
+        roe_basis = "缺少上年同期归母权益"
 
     def rendered_amount(label: str, value: float | None) -> str:
         return f"- {label}: {value:.2f}" if value is not None else f"- {label}: 不可用"
@@ -3825,6 +3860,7 @@ def get_free_financial_indicators(
         rendered_amount("营业收入", revenue),
         rendered_amount("营业成本", operating_cost),
         rendered_amount("净利润", net_profit),
+        rendered_amount("归母净利润", parent_net_profit),
         rendered_amount("总资产", total_assets),
         rendered_amount("总负债", total_liabilities),
         rendered_amount("归母权益", parent_equity),