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

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

@@ -3,6 +3,19 @@
 所有 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
+- **User-Agent 统一规范**：同步同步客户端 (`client.py`) 与异步客户端 (`async_client.py`) 的 `User-Agent` 标头为 `QuantDB-Python-SDK/0.1.3`，提升服务端请求追踪与日志分流精度。
+- **服务端 Redis 集中式缓存兼容**：完全兼容服务端网关新上线的 Redis 集中缓存层（自动接收 `X-Cache-Hit` 响应标头）。
+
 ## [0.1.2] - 2026-07-25
 
 ### Added

{quantdb_sdk-0.1.2/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.2
+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.2 → 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.2 → quantdb_sdk-0.1.4}/pyproject.toml

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

{quantdb_sdk-0.1.2 → 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.0"}
+        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}")
 
     # ========== 订阅与支付 ==========