quantdb-sdk 0.1.3__tar.gz → 0.1.4__tar.gz

{quantdb_sdk-0.1.3 → quantdb_sdk-0.1.4}/CHANGELOG.md

@@ -3,6 +3,13 @@
 所有 notable 变更都会记录在此文件。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## [0.1.4] - 2026-07-25
+
+### Fixed
+- **用户名密码登录**：先初始化 HTTP 会话再登录，修复 `QuantDBClient(username=..., password=...)` 初始化时访问未创建会话的错误。
+- **API Key 删除**：`delete_api_key()` / `a_delete_api_key()` 改为调用服务端实际的 `DELETE /api/v1/auth/api-keys/{id}` 接口，并明确接受 API Key ID。
+- **流量用量**：`get_usage()` / `a_get_usage()` 将余额购买的额外流量纳入剩余流量和活跃状态计算，并新增 `purchased_gb` 返回字段。
+
 ## [0.1.3] - 2026-07-25
 
 ### Changed

{quantdb_sdk-0.1.3/quantdb_sdk.egg-info → quantdb_sdk-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quantdb-sdk
-Version: 0.1.3
+Version: 0.1.4
 Summary: QuantDB 量化数据平台官方 Python SDK
 Author: QuantDB Team
 License: MIT
@@ -90,7 +90,7 @@ client = QuantDBClient(username="admin", password="admin123")
 
 ## 流量说明
 
-每月前 30 GB 下载流量免费，超出部分按 ¥1/GB 计费；账户余额不足时，下载会被限流，充值后即可恢复。
+免费注册用户获赠 100 MB 一次性体验流量；订阅用户每月含 30 GB 下载流量，超出部分按 ¥1/GB 从账户余额扣减。余额不足时下载会被拦截。
 
 ## 文档
 

{quantdb_sdk-0.1.3 → quantdb_sdk-0.1.4}/README.md

@@ -53,7 +53,7 @@ client = QuantDBClient(username="admin", password="admin123")
 
 ## 流量说明
 
-每月前 30 GB 下载流量免费，超出部分按 ¥1/GB 计费；账户余额不足时，下载会被限流，充值后即可恢复。
+免费注册用户获赠 100 MB 一次性体验流量；订阅用户每月含 30 GB 下载流量，超出部分按 ¥1/GB 从账户余额扣减。余额不足时下载会被拦截。
 
 ## 文档
 

{quantdb_sdk-0.1.3 → quantdb_sdk-0.1.4}/pyproject.toml

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

{quantdb_sdk-0.1.3 → quantdb_sdk-0.1.4}/quantdb_sdk/async_client.py

@@ -35,7 +35,7 @@ class AsyncQuantDBClient:
     ):
         self.api_host = api_host.rstrip("/")
         self.timeout = timeout
-        headers = {"User-Agent": "QuantDB-Python-SDK/0.1.3"}
+        headers = {"User-Agent": "QuantDB-Python-SDK/0.1.4"}
         if api_key:
             headers["X-API-Key"] = api_key
         elif token:
@@ -82,6 +82,10 @@ class AsyncQuantDBClient:
         resp = await self._request("POST", path, json=json)
         return self._check_response(resp)
 
+    async def _delete(self, path: str) -> dict:
+        resp = await self._request("DELETE", path)
+        return self._check_response(resp)
+
     def _check_response(self, response: httpx.Response) -> dict:
         if response.status_code == 200:
             try:
@@ -123,15 +127,17 @@ class AsyncQuantDBClient:
         used = data.get("used_traffic", 0)
         limit = data.get("traffic_limit", 0)
         credit = data.get("credit_limit", 0)
+        purchased = data.get("purchased_traffic", 0)
         subscription = data.get("subscription", {}) or {}
         return {
             "used_gb": bytes_to_gb(used),
             "limit_gb": bytes_to_gb(limit),
             "credit_gb": bytes_to_gb(credit),
-            "remaining_gb": max(0.0, bytes_to_gb(limit + credit - used)),
+            "purchased_gb": bytes_to_gb(purchased),
+            "remaining_gb": max(0.0, bytes_to_gb(limit + credit + purchased - used)),
             "balance_yuan": data.get("balance_yuan", 0.0),
             "subscription": subscription,
-            "is_active": subscription.get("status") == "active" and used < limit + credit,
+            "is_active": subscription.get("status") == "active" and used < limit + credit + purchased,
         }
 
     async def a_register(self, username: str, email: str, password: str) -> Dict[str, Any]:
@@ -159,16 +165,16 @@ class AsyncQuantDBClient:
         """创建新的 API Key（每个账号限制 1 个有效 Key）。"""
         return await self._post("/api/v1/auth/api-keys", json={"description": description})
 
-    async def a_delete_api_key(self, key_token: str) -> Dict[str, Any]:
+    async def a_delete_api_key(self, key_id: int) -> Dict[str, Any]:
         """删除指定的 API Key。
 
         Args:
-            key_token: 要删除的 API Key 令牌。
+            key_id: ``a_list_api_keys()`` 返回的 API Key ID。
 
         Returns:
             删除结果信息。
         """
-        return await self._post(f"/api/v1/auth/api-keys/{key_token}/delete")
+        return await self._delete(f"/api/v1/auth/api-keys/{key_id}")
 
     # ========== 订阅与支付 ==========
 

{quantdb_sdk-0.1.3 → quantdb_sdk-0.1.4}/quantdb_sdk/client.py

@@ -42,6 +42,10 @@ class QuantDBClient:
         self.timeout = timeout
         self.token: Optional[str] = None
         self.headers: Dict[str, str] = {}
+        self.session = requests.Session()
+        # User-Agent 中的版本与 pyproject.toml 同步，用于服务端日志归因
+        # 维护提示：每次版本号变化必须同步改这里（init 里的 __version__ 走 metadata 自动同步）
+        self.session.headers.update({"User-Agent": "QuantDB-Python-SDK/0.1.4"})
 
         if api_key:
             self.headers = {"X-API-Key": api_key}
@@ -50,10 +54,6 @@ class QuantDBClient:
         else:
             raise ValueError("必须提供 api_key 或 username+password")
 
-        self.session = requests.Session()
-        # User-Agent 中的版本与 pyproject.toml 同步，用于服务端日志归因
-        # 维护提示：每次版本号变化必须同步改这里（init 里的 __version__ 走 metadata 自动同步）
-        self.session.headers.update({"User-Agent": "QuantDB-Python-SDK/0.1.3"})
         if self.headers:
             self.session.headers.update(self.headers)
 
@@ -112,6 +112,10 @@ class QuantDBClient:
         resp = self._request("POST", path, json=json)
         return self._check_response(resp)
 
+    def _delete(self, path: str) -> dict:
+        resp = self._request("DELETE", path)
+        return self._check_response(resp)
+
     def _check_response(self, response: requests.Response) -> dict:
         if response.status_code == 200:
             try:
@@ -163,15 +167,17 @@ class QuantDBClient:
         used = data.get("used_traffic", 0)
         limit = data.get("traffic_limit", 0)
         credit = data.get("credit_limit", 0)
+        purchased = data.get("purchased_traffic", 0)
         subscription = data.get("subscription", {}) or {}
         return {
             "used_gb": bytes_to_gb(used),
             "limit_gb": bytes_to_gb(limit),
             "credit_gb": bytes_to_gb(credit),
-            "remaining_gb": max(0.0, bytes_to_gb(limit + credit - used)),
+            "purchased_gb": bytes_to_gb(purchased),
+            "remaining_gb": max(0.0, bytes_to_gb(limit + credit + purchased - used)),
             "balance_yuan": data.get("balance_yuan", 0.0),
             "subscription": subscription,
-            "is_active": subscription.get("status") == "active" and used < limit + credit,
+            "is_active": subscription.get("status") == "active" and used < limit + credit + purchased,
         }
 
     def register(self, username: str, email: str, password: str) -> Dict[str, Any]:
@@ -203,16 +209,16 @@ class QuantDBClient:
         """创建新的 API Key（每个账号限制 1 个有效 Key）。"""
         return self._post("/api/v1/auth/api-keys", json={"description": description})
 
-    def delete_api_key(self, key_token: str) -> Dict[str, Any]:
+    def delete_api_key(self, key_id: int) -> Dict[str, Any]:
         """删除指定的 API Key。
 
         Args:
-            key_token: 要删除的 API Key 令牌。
+            key_id: ``list_api_keys()`` 返回的 API Key ID。
 
         Returns:
             删除结果信息。
         """
-        return self._post(f"/api/v1/auth/api-keys/{key_token}/delete")
+        return self._delete(f"/api/v1/auth/api-keys/{key_id}")
 
     # ========== 订阅与支付 ==========
 
@@ -609,4 +615,3 @@ class DuckDBWarehouse:
     def list_views(self) -> Dict[str, str]:
         """列出当前已注册的视图及其对应本地路径。"""
         return dict(self._views)
-

{quantdb_sdk-0.1.3 → quantdb_sdk-0.1.4/quantdb_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quantdb-sdk
-Version: 0.1.3
+Version: 0.1.4
 Summary: QuantDB 量化数据平台官方 Python SDK
 Author: QuantDB Team
 License: MIT
@@ -90,7 +90,7 @@ client = QuantDBClient(username="admin", password="admin123")
 
 ## 流量说明
 
-每月前 30 GB 下载流量免费，超出部分按 ¥1/GB 计费；账户余额不足时，下载会被限流，充值后即可恢复。
+免费注册用户获赠 100 MB 一次性体验流量；订阅用户每月含 30 GB 下载流量，超出部分按 ¥1/GB 从账户余额扣减。余额不足时下载会被拦截。
 
 ## 文档
 

{quantdb_sdk-0.1.3 → quantdb_sdk-0.1.4}/tests/test_async_client.py

@@ -72,6 +72,7 @@ async def test_a_get_usage_with_subscription():
                 "used_traffic": 1073741824,
                 "traffic_limit": 53687091200,
                 "credit_limit": 0,
+                "purchased_traffic": 1073741824,
                 "balance_yuan": 0.0,
                 "subscription": {"plan_id": "pro-annual", "status": "active"},
             },
@@ -81,6 +82,8 @@ async def test_a_get_usage_with_subscription():
         usage = await client.a_get_usage()
     assert usage["used_gb"] == 1.0
     assert usage["limit_gb"] == 50.0
+    assert usage["purchased_gb"] == 1.0
+    assert usage["remaining_gb"] == 50.0
     assert usage["subscription"]["status"] == "active"
     assert usage["is_active"] is True
 
@@ -115,11 +118,11 @@ async def test_a_create_order():
 @pytest.mark.asyncio
 @respx.mock
 async def test_a_delete_api_key():
-    respx.post(f"{API_HOST}/api/v1/auth/api-keys/qdb_abc123/delete").mock(
+    respx.delete(f"{API_HOST}/api/v1/auth/api-keys/42").mock(
         return_value=httpx.Response(200, json={"message": "API Key 撤销成功"})
     )
     async with AsyncQuantDBClient(api_host=API_HOST, api_key="test-key") as client:
-        result = await client.a_delete_api_key("qdb_abc123")
+        result = await client.a_delete_api_key(42)
     assert result["message"] == "API Key 撤销成功"
 
 

{quantdb_sdk-0.1.3 → quantdb_sdk-0.1.4}/tests/test_client.py

@@ -74,6 +74,7 @@ def test_get_usage_with_subscription():
             "used_traffic": 1073741824,
             "traffic_limit": 32212254720,
             "credit_limit": 0,
+            "purchased_traffic": 1073741824,
             "balance_yuan": 0.0,
             "subscription": {"plan_id": "pro-monthly", "status": "active"},
         },
@@ -83,6 +84,8 @@ def test_get_usage_with_subscription():
     usage = client.get_usage()
     assert usage["used_gb"] == 1.0
     assert usage["limit_gb"] == 30.0
+    assert usage["purchased_gb"] == 1.0
+    assert usage["remaining_gb"] == 30.0
     assert usage["subscription"]["status"] == "active"
     assert usage["is_active"] is True
 
@@ -114,13 +117,13 @@ def test_create_order():
 
 @responses.activate
 def test_delete_api_key():
-    responses.post(
-        f"{API_HOST}/api/v1/auth/api-keys/qdb_abc123/delete",
+    responses.delete(
+        f"{API_HOST}/api/v1/auth/api-keys/42",
         json={"message": "API Key 撤销成功"},
         status=200,
     )
     client = QuantDBClient(api_host=API_HOST, api_key="test-key")
-    result = client.delete_api_key("qdb_abc123")
+    result = client.delete_api_key(42)
     assert result["message"] == "API Key 撤销成功"
 
 
@@ -149,4 +152,3 @@ def test_duckdb_warehouse(tmp_path):
     df = wh.query("SELECT * FROM stock_val WHERE val > 15")
     assert len(df) == 1
     assert df.iloc[0]["code"] == "600519.SH"
-