quantdb-sdk 0.2.0__tar.gz → 0.2.1__tar.gz

{quantdb_sdk-0.2.0 → quantdb_sdk-0.2.1}/CHANGELOG.md

@@ -3,6 +3,12 @@
 所有 notable 变更都会记录在此文件。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## [0.2.1] - 2026-07-26
+
+### Fixed
+- **历史发布清单兼容**：同步客户端自动归一化旧 release manifest 遗留的 `v2/` 前缀，并可下载 release patch 对象。
+- **布局回退**：服务端以 COS Manifest 为可用性权威，V2 元数据缺失时可正确回退 V1，而非将数据误判为不可下载。
+
 ## [0.2.0] - 2026-07-26
 
 ### Added

{quantdb_sdk-0.2.0/quantdb_sdk.egg-info → quantdb_sdk-0.2.1}/PKG-INFO

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

{quantdb_sdk-0.2.0 → quantdb_sdk-0.2.1}/pyproject.toml

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

{quantdb_sdk-0.2.0 → quantdb_sdk-0.2.1}/quantdb_sdk/__init__.py

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

{quantdb_sdk-0.2.0 → quantdb_sdk-0.2.1}/quantdb_sdk/async_client.py

@@ -37,7 +37,7 @@ class AsyncQuantDBClient:
     ):
         self.api_host = api_host.rstrip("/")
         self.timeout = timeout
-        headers = {"User-Agent": "QuantDB-Python-SDK/0.2.0"}
+        headers = {"User-Agent": "QuantDB-Python-SDK/0.2.1"}
         if api_key:
             headers["X-API-Key"] = api_key
         elif token:
@@ -66,6 +66,10 @@ class AsyncQuantDBClient:
             raise ValidationError("layout 仅支持 auto、v1 或 v2")
         return layout  # type: ignore[return-value]
 
+    @staticmethod
+    def _normalise_release_key(key: str) -> str:
+        return key.strip().lstrip("/").removeprefix("v2/")
+
     @staticmethod
     def _normalise_kline(df: pd.DataFrame, start_date: Optional[str], end_date: Optional[str], fields: str, limit: Optional[int]) -> pd.DataFrame:
         if "time" in df.columns:
@@ -544,7 +548,8 @@ class AsyncQuantDBClient:
             if releases:
                 for release in releases:
                     for obj in release.get("objects", []):
-                        key, target = obj["key"], os.path.join(root, *obj["key"].split("/"))
+                        key = self._normalise_release_key(obj["key"])
+                        target = os.path.join(root, *key.split("/"))
                         old = state.execute("SELECT etag,sha256,path FROM objects WHERE key=?", (key,)).fetchone()
                         if old and old[0] == obj.get("etag") and old[1] == obj.get("sha256") and os.path.exists(old[2]): continue
                         os.makedirs(os.path.dirname(target), exist_ok=True)

{quantdb_sdk-0.2.0 → quantdb_sdk-0.2.1}/quantdb_sdk/client.py

@@ -48,7 +48,7 @@ class QuantDBClient:
         self.session = requests.Session()
         # User-Agent 中的版本与 pyproject.toml 同步，用于服务端日志归因
         # 维护提示：每次版本号变化必须同步改这里（init 里的 __version__ 走 metadata 自动同步）
-        self.session.headers.update({"User-Agent": "QuantDB-Python-SDK/0.2.0"})
+        self.session.headers.update({"User-Agent": "QuantDB-Python-SDK/0.2.1"})
 
         if api_key:
             self.headers = {"X-API-Key": api_key}
@@ -164,6 +164,11 @@ class QuantDBClient:
             raise ValidationError("layout 仅支持 auto、v1 或 v2")
         return layout  # type: ignore[return-value]
 
+    @staticmethod
+    def _normalise_release_key(key: str) -> str:
+        """兼容历史 release manifest 遗留的 ``v2/`` 对象前缀。"""
+        return key.strip().lstrip("/").removeprefix("v2/")
+
     @staticmethod
     def _normalise_kline(df: pd.DataFrame, start_date: Optional[str], end_date: Optional[str], fields: str, limit: Optional[int]) -> pd.DataFrame:
         """统一 V1/V2 日线结果并在客户端按标的、日期与字段过滤。"""
@@ -641,7 +646,7 @@ class QuantDBClient:
                 for release in releases:
                     release_id = release["release_id"]
                     for obj in release.get("objects", []):
-                        key = obj["key"]
+                        key = self._normalise_release_key(obj["key"])
                         relative_path = obj.get("relative_path") or key
                         target = os.path.join(root, *relative_path.split("/"))
                         old = state.execute("SELECT etag, sha256, path FROM objects WHERE key=?", (key,)).fetchone()

{quantdb_sdk-0.2.0 → quantdb_sdk-0.2.1/quantdb_sdk.egg-info}/PKG-INFO

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

{quantdb_sdk-0.2.0 → quantdb_sdk-0.2.1}/tests/test_async_client.py

@@ -55,7 +55,7 @@ async def test_a_query_kline_without_range_forces_v1_layout():
 async def test_a_sync_dataset_uses_release_cursor(tmp_path):
     payload = b"release-parquet"
     digest = __import__("hashlib").sha256(payload).hexdigest()
-    respx.get(f"{API_HOST}/api/v1/data/releases").mock(return_value=httpx.Response(200, json={"releases": [{"release_id": "20260726_180000", "objects": [{"key": "1_kline_data/daily_forward/dt=20260726/data.parquet", "etag": "etag-1", "sha256": digest}]}]}))
+    respx.get(f"{API_HOST}/api/v1/data/releases").mock(return_value=httpx.Response(200, json={"releases": [{"release_id": "20260726_180000", "objects": [{"key": "v2/1_kline_data/daily_forward/dt=20260726/data.parquet", "etag": "etag-1", "sha256": digest}]}]}))
     route = respx.get(f"{API_HOST}/api/v1/data/download").mock(return_value=httpx.Response(200, content=payload))
     async with AsyncQuantDBClient(api_host=API_HOST, api_key="test-key") as client:
         result = await client.a_sync_dataset("daily_forward", str(tmp_path))

{quantdb_sdk-0.2.0 → quantdb_sdk-0.2.1}/tests/test_client.py

@@ -79,7 +79,7 @@ def test_sync_dataset_uses_release_cursor_and_object_key(tmp_path):
     digest = __import__("hashlib").sha256(payload).hexdigest()
     responses.get(
         f"{API_HOST}/api/v1/data/releases",
-        json={"releases": [{"release_id": "20260726_180000", "objects": [{"key": "1_kline_data/daily_forward/dt=20260726/data.parquet", "etag": "etag-1", "sha256": digest}]}]}, status=200,
+        json={"releases": [{"release_id": "20260726_180000", "objects": [{"key": "v2/1_kline_data/daily_forward/dt=20260726/data.parquet", "etag": "etag-1", "sha256": digest}]}]}, status=200,
     )
     responses.get(f"{API_HOST}/api/v1/data/download", body=payload, status=200)
     client = QuantDBClient(api_host=API_HOST, api_key="test-key")