qdc 0.2.2__tar.gz → 0.2.3__tar.gz

{qdc-0.2.2 → qdc-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qdc
-Version: 0.2.2
+Version: 0.2.3
 Summary: QDC online data client (tushare-compatible) for the QDC cloud data bridge.
 Author: QDC Data
 License: Proprietary
@@ -30,7 +30,7 @@ pip install -U qdc
 内网或离线环境连不上公共源时,可以按完整地址装(版本号要自己跟着换):
 
 ```bash
-pip install https://api.qdc-data.com:8443/release/qdc-0.2.2-py3-none-any.whl
+pip install https://api.qdc-data.com:8443/release/qdc-0.2.3-py3-none-any.whl
 ```
 
 > 2026-09-06 起 qdc 已发布在 PyPI(https://pypi.org/project/qdc/)。
@@ -150,6 +150,24 @@ except qdc.QDCError as e:
 
 ## 版本
 
+### 0.2.3(2026-09-07)
+
+**默认超时从 30 秒放宽到 180 秒。** 服务端高档位单条查询就允许 60 秒,前面还可能排队等并发槽 ——
+30 秒会让客户端在服务端还在干活时先断开,表现成「网络错误」,而那次取数机会已经扣掉了。
+断开时服务端会立刻停止查询,所以放宽它不会让服务器白干。
+
+同批服务端修复(不用升级连接器也生效):
+
+- **失败的请求不再扣掉当天的取数机会。** 以前字段名写错先 422、改正后重试就 429,
+  一次数据没拿到、机会没了。现在任何失败都会把那次记账撤销。
+- **`start > end` 直接报错**,不再返回 200 + 0 行 —— 0 行和「真的没数据」长得一模一样。
+- **完整代码能搜到了。** 以前 `lookup("600519")` 有结果而 `lookup("600519.SH")` 没有 ——
+  本工具自己吐出来的代码自己不认。同时返回里标明**只检索 A 股**,查美股为空时会说清是范围问题。
+- **字段字典的日期类型订正为字符串。** 库内是毫秒时间戳,返回前已格式化成 `"20260803"`,
+  而字段字典此前照抄原始列类型报的是整数,客户照着解析会崩。
+- **逐笔成交取「最新一笔」不再取错。** 排序键在笔内不唯一,拿到的是开盘集合竞价那笔;
+  现已补上笔序号排序。
+
 ### 0.2.2(2026-09-07)
 
 三处,前两处都属于「不报错、只给错答案」:

{qdc-0.2.2 → qdc-0.2.3}/README.md

@@ -18,7 +18,7 @@ pip install -U qdc
 内网或离线环境连不上公共源时,可以按完整地址装(版本号要自己跟着换):
 
 ```bash
-pip install https://api.qdc-data.com:8443/release/qdc-0.2.2-py3-none-any.whl
+pip install https://api.qdc-data.com:8443/release/qdc-0.2.3-py3-none-any.whl
 ```
 
 > 2026-09-06 起 qdc 已发布在 PyPI(https://pypi.org/project/qdc/)。
@@ -138,6 +138,24 @@ except qdc.QDCError as e:
 
 ## 版本
 
+### 0.2.3(2026-09-07)
+
+**默认超时从 30 秒放宽到 180 秒。** 服务端高档位单条查询就允许 60 秒,前面还可能排队等并发槽 ——
+30 秒会让客户端在服务端还在干活时先断开,表现成「网络错误」,而那次取数机会已经扣掉了。
+断开时服务端会立刻停止查询,所以放宽它不会让服务器白干。
+
+同批服务端修复(不用升级连接器也生效):
+
+- **失败的请求不再扣掉当天的取数机会。** 以前字段名写错先 422、改正后重试就 429,
+  一次数据没拿到、机会没了。现在任何失败都会把那次记账撤销。
+- **`start > end` 直接报错**,不再返回 200 + 0 行 —— 0 行和「真的没数据」长得一模一样。
+- **完整代码能搜到了。** 以前 `lookup("600519")` 有结果而 `lookup("600519.SH")` 没有 ——
+  本工具自己吐出来的代码自己不认。同时返回里标明**只检索 A 股**,查美股为空时会说清是范围问题。
+- **字段字典的日期类型订正为字符串。** 库内是毫秒时间戳,返回前已格式化成 `"20260803"`,
+  而字段字典此前照抄原始列类型报的是整数,客户照着解析会崩。
+- **逐笔成交取「最新一笔」不再取错。** 排序键在笔内不唯一,拿到的是开盘集合竞价那笔;
+  现已补上笔序号排序。
+
 ### 0.2.2(2026-09-07)
 
 三处,前两处都属于「不报错、只给错答案」:

{qdc-0.2.2 → qdc-0.2.3}/qdc/__init__.py

@@ -32,7 +32,7 @@ from .client import (
     ProApi,
 )
 
-__version__ = "0.2.2"
+__version__ = "0.2.3"
 
 __all__ = [
     "Client",

{qdc-0.2.2 → qdc-0.2.3}/qdc/client.py

@@ -42,9 +42,16 @@ __all__ = [
 ]
 
 DEFAULT_BASE = "https://data.qdc-data.com"
-_VERSION = "0.2.2"
+_VERSION = "0.2.3"
 _USER_AGENT = "qdc-python/" + _VERSION
 
+# 默认超时。★[2026-09-07] 原来是 30 秒,而服务端高档位单条查询就允许 60 秒
+# (limits.timeout_s),前面还可能排队等并发槽 —— 于是客户端会在服务端还在干活时先断,
+# 表现成「网络错误」,而那次取数机会已经扣掉了。宁可等,也不要制造假故障。
+# ★这个值只是「等多久才放弃」,不影响服务端算多久;真正的上限由服务端 limits 定。
+# ★断连服务端会立刻停止查询(W-410),所以放宽它不会让服务器白干。
+DEFAULT_TIMEOUT = 180
+
 # 翻页安全上限。到顶时【显式告警并标记 meta["complete"]=False】,绝不静默截断。
 _MAX_PAGES = 200
 
@@ -147,7 +154,7 @@ class Client:
     这是「我拿到的是不是全部」唯一可信的判据。
     """
 
-    def __init__(self, key, base=DEFAULT_BASE, device=None, timeout=30,
+    def __init__(self, key, base=DEFAULT_BASE, device=None, timeout=DEFAULT_TIMEOUT,
                  cache_dir=None, max_pages=_MAX_PAGES):
         if not key:
             raise QDCError("API key is required")
@@ -641,7 +648,7 @@ def _require():
     return _default
 
 
-def connect(key, base=DEFAULT_BASE, device=None, timeout=30, cache_dir=None, max_pages=_MAX_PAGES):
+def connect(key, base=DEFAULT_BASE, device=None, timeout=DEFAULT_TIMEOUT, cache_dir=None, max_pages=_MAX_PAGES):
     """Create and register a default Client. Returns the Client.
 
     cache_dir: 给复权因子表这类整表数据做本地缓存的目录(如 "~/.qdc")。不传则只在进程内缓存。
@@ -703,7 +710,7 @@ def describe(sku, table=None):
     return _require().describe(sku, table=table)
 
 
-def pro_api(key=None, base=DEFAULT_BASE, device=None, timeout=30, cache_dir=None):
+def pro_api(key=None, base=DEFAULT_BASE, device=None, timeout=DEFAULT_TIMEOUT, cache_dir=None):
     """Return a tushare-compatible facade.
 
     If `key` is given, a fresh Client is created (and registered as default);

{qdc-0.2.2 → qdc-0.2.3}/qdc.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qdc
-Version: 0.2.2
+Version: 0.2.3
 Summary: QDC online data client (tushare-compatible) for the QDC cloud data bridge.
 Author: QDC Data
 License: Proprietary
@@ -30,7 +30,7 @@ pip install -U qdc
 内网或离线环境连不上公共源时,可以按完整地址装(版本号要自己跟着换):
 
 ```bash
-pip install https://api.qdc-data.com:8443/release/qdc-0.2.2-py3-none-any.whl
+pip install https://api.qdc-data.com:8443/release/qdc-0.2.3-py3-none-any.whl
 ```
 
 > 2026-09-06 起 qdc 已发布在 PyPI(https://pypi.org/project/qdc/)。
@@ -150,6 +150,24 @@ except qdc.QDCError as e:
 
 ## 版本
 
+### 0.2.3(2026-09-07)
+
+**默认超时从 30 秒放宽到 180 秒。** 服务端高档位单条查询就允许 60 秒,前面还可能排队等并发槽 ——
+30 秒会让客户端在服务端还在干活时先断开,表现成「网络错误」,而那次取数机会已经扣掉了。
+断开时服务端会立刻停止查询,所以放宽它不会让服务器白干。
+
+同批服务端修复(不用升级连接器也生效):
+
+- **失败的请求不再扣掉当天的取数机会。** 以前字段名写错先 422、改正后重试就 429,
+  一次数据没拿到、机会没了。现在任何失败都会把那次记账撤销。
+- **`start > end` 直接报错**,不再返回 200 + 0 行 —— 0 行和「真的没数据」长得一模一样。
+- **完整代码能搜到了。** 以前 `lookup("600519")` 有结果而 `lookup("600519.SH")` 没有 ——
+  本工具自己吐出来的代码自己不认。同时返回里标明**只检索 A 股**,查美股为空时会说清是范围问题。
+- **字段字典的日期类型订正为字符串。** 库内是毫秒时间戳,返回前已格式化成 `"20260803"`,
+  而字段字典此前照抄原始列类型报的是整数,客户照着解析会崩。
+- **逐笔成交取「最新一笔」不再取错。** 排序键在笔内不唯一,拿到的是开盘集合竞价那笔;
+  现已补上笔序号排序。
+
 ### 0.2.2(2026-09-07)
 
 三处,前两处都属于「不报错、只给错答案」: