quantdb-sdk 0.4.1__tar.gz → 0.4.2__tar.gz

{quantdb_sdk-0.4.1 → quantdb_sdk-0.4.2}/CHANGELOG.md

@@ -3,6 +3,16 @@
 所有 notable 变更都会记录在此文件。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## \[0.4.2] - 2026-10-05
+
+### Added
+
+- **新增数据集 `per_share`（每股指标补充表，分类 3）**：补登记为第 30 个数据集。
+
+  - `SYNC_DATASET_CATEGORIES` 与 `DATASET_REGISTRY` 由 29 项增至 30 项；`client.data.datasets()` / `info()` / `local_files()` / `read_local()` / `sync_dataset()` / `mount()` 均可直接按 `per_share` 使用。
+  - 物理形态为 V1 逐股票文件 `3_financial_data/per_share/{Symbol}.parquet`（由 `03_financial.py` 采集，部分股票为空）；`layout=v1_symbol`，读取/查询需提供 `symbol`。
+  - 与 MCP catalog、后端 `subCategoryMapping`、前端分类表同步对齐（均为 30 项）。
+
 ## \[0.4.1] - 2026-10-05
 
 ### Changed

{quantdb_sdk-0.4.1/quantdb_sdk.egg-info → quantdb_sdk-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quantdb-sdk
-Version: 0.4.1
+Version: 0.4.2
 Summary: QuantDB 量化数据平台官方 Python SDK
 Author: QuantDB Team
 License: MIT

{quantdb_sdk-0.4.1 → quantdb_sdk-0.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "quantdb-sdk"
-version = "0.4.1"
+version = "0.4.2"
 description = "QuantDB 量化数据平台官方 Python SDK"
 readme = "README.md"
 license = {text = "MIT"}

{quantdb_sdk-0.4.1 → quantdb_sdk-0.4.2}/quantdb_sdk/__init__.py

@@ -5,7 +5,7 @@ try:
     # 注意：此处用 PyPI 包名（连字符）查找版本号，不是模块名（下划线）
     __version__ = version("quantdb-sdk")
 except ImportError:
-    __version__ = "0.4.1"
+    __version__ = "0.4.2"
 
 from . import layout
 from ._utils import scan_local_directory

{quantdb_sdk-0.4.1 → quantdb_sdk-0.4.2}/quantdb_sdk/_utils.py

@@ -19,7 +19,7 @@ SYNC_DATASET_CATEGORIES: Dict[str, str] = {
     "instrument_detail": "2", "sector_concept": "2", "index_weights": "2",
     "trading_calendar": "2", "margin_trading": "2",
     "balance": "3", "income": "3", "cashflow": "3", "capital": "3",
-    "holder_num": "3", "pershare_index": "3", "dividend_factors": "3",
+    "holder_num": "3", "pershare_index": "3", "per_share": "3", "dividend_factors": "3",
     "etf_pcf": "4", "convertible_bond": "4", "etf_kline": "4",
     "valuation": "5", "technical_indicators": "5", "market_sentiment": "5",
     "features_daily": "6", "l1_factors": "6", "l1_l2_factors": "6", "l2_factors": "6",

{quantdb_sdk-0.4.1 → quantdb_sdk-0.4.2}/quantdb_sdk/async_client.py

@@ -28,7 +28,7 @@ from .errors import (
 )
 
 # 维护提示：每次发版必须与 pyproject.toml 版本号同步
-_USER_AGENT = "QuantDB-Python-SDK/0.4.1"
+_USER_AGENT = "QuantDB-Python-SDK/0.4.2"
 
 
 def _etag_hex(value: Optional[str]) -> Optional[str]:

{quantdb_sdk-0.4.1 → quantdb_sdk-0.4.2}/quantdb_sdk/client.py

@@ -32,7 +32,7 @@ from .errors import (
 )
 
 # 维护提示：每次发版必须与 pyproject.toml 版本号同步
-_USER_AGENT = "QuantDB-Python-SDK/0.4.1"
+_USER_AGENT = "QuantDB-Python-SDK/0.4.2"
 
 
 def _etag_hex(value: Optional[str]) -> Optional[str]:

{quantdb_sdk-0.4.1 → quantdb_sdk-0.4.2}/quantdb_sdk/hub.py

@@ -133,6 +133,8 @@ _ENTRIES: Tuple[Tuple[str, str, str, str, Tuple[str, ...], str, Tuple[str, ...]]
      ("股东", "户数", "holder"), "v1_symbol", ("symbol",)),
     ("pershare_index", "每股指标", "每股收益、净资产等指标。", "free",
      ("每股", "eps", "财务"), "v1_symbol", ("symbol",)),
+    ("per_share", "每股指标（补充）", "每股指标补充表；部分股票为空。", "free",
+     ("每股", "eps", "补充", "per_share"), "v1_symbol", ("symbol",)),
     ("dividend_factors", "除权复权因子", "分红送配及复权因子。", "free",
      ("分红", "除权", "复权", "dividend"), "v1_symbol", ("symbol",)),
     ("etf_kline", "ETF 日线", "ETF 日线 OHLCV。", "free",

{quantdb_sdk-0.4.1 → quantdb_sdk-0.4.2/quantdb_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quantdb-sdk
-Version: 0.4.1
+Version: 0.4.2
 Summary: QuantDB 量化数据平台官方 Python SDK
 Author: QuantDB Team
 License: MIT

{quantdb_sdk-0.4.1 → quantdb_sdk-0.4.2}/tests/test_data_hub.py

@@ -55,7 +55,7 @@ def _write_tick(root, symbol, yyyymmdd, flat=True, extra_symbol=False):
 # ---------------------------------------------------------------------------
 
 def test_registry_completeness():
-    assert len(DATASET_REGISTRY) == 29
+    assert len(DATASET_REGISTRY) == 30
     assert set(DATASET_REGISTRY) == set(SYNC_DATASET_CATEGORIES)
     for dataset, info in DATASET_REGISTRY.items():
         assert info.dataset == dataset
@@ -79,13 +79,21 @@ def test_data_property_is_lazy_and_cached(client):
 def test_datasets_filters(client):
     hub = client.data
     all_df = hub.datasets()
-    assert len(all_df) == 29
+    assert len(all_df) == 30
     assert list(all_df.columns) == ["dataset", "category_id", "category_dir", "name", "access", "layout"]
 
     cat6 = hub.datasets(category="6")
     assert set(cat6["dataset"]) == {"features_daily", "l1_factors", "l2_factors", "l1_l2_factors"}
     assert (cat6["access"] == "subscription").all()
 
+    cat3 = hub.datasets(category="3")
+    assert set(cat3["dataset"]) == {
+        "balance", "income", "cashflow", "capital", "holder_num",
+        "pershare_index", "per_share", "dividend_factors",
+    }
+    # per_share 为 V1 逐股票补充表，需能按 symbol 读取
+    assert hub.datasets(keyword="per_share").iloc[0]["dataset"] == "per_share"
+
     assert len(hub.datasets(access="subscription")) == 4
     assert "daily_forward" in set(hub.datasets(keyword="复权")["dataset"])