Compare commits
2
Commits
v0.6.7
...
2cf3657f4b
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
2cf3657f4b | ||
|
|
dc78d81be8 |
No files matched your search
@@ -2,6 +2,80 @@
|
|||||||
|
|
||||||
本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
|
本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
|
||||||
|
|
||||||
|
## [0.6.9] - 2026-10-23
|
||||||
|
|
||||||
|
### 修复
|
||||||
|
|
||||||
|
- **`get_universe` 冷启动 12~18s / 偶发失败:证券清单请求多发了 2 字节,污染连接**。
|
||||||
|
|
||||||
|
`GetSecurityListCmd` 的请求体是「12 字节命令头 + market(H) + start(H)」= **16 字节**,
|
||||||
|
但实现里多塞了一个 `H`(写死 0),实际发出 **18 字节**。服务端只消费前 16 字节,
|
||||||
|
剩下的 `00 00` 停在它的接收缓冲里,把**下一个请求**的开头吃掉 —— 于是同一条连接
|
||||||
|
「第一次成功、第二次起永远无响应」。
|
||||||
|
|
||||||
|
分页器复用连接,等于每拉一页都要先失败重连,冷启动被拖到 12~18s,还经常直接抛
|
||||||
|
`ConnectionError`。
|
||||||
|
|
||||||
|
| 场景 | 修复前 | 修复后 |
|
||||||
|
|---|---|---|
|
||||||
|
| `get_universe("sh")` 冷启动(27,534 条 / 28 页) | 12,267ms | **1,610ms** |
|
||||||
|
| `get_universe("sz")` 冷启动(24,460 条 / 25 页) | 18,260ms | **571ms** |
|
||||||
|
| `get_universe()` 全市场冷启动(146,848 条) | 19,085ms | **4,371ms** |
|
||||||
|
| `get_universe()` 热缓存 | — | 669ms |
|
||||||
|
| 同一连接连发 2 次清单(27 台主机) | **0/27 成功** | **27/27 成功** |
|
||||||
|
|
||||||
|
- **北交所清单不再卡 15s 后报错,改为立即返回空列表**。
|
||||||
|
|
||||||
|
`0x053E` 对 `market=2` 在实测的 **27 台标准主机上全部无响应**(26 台 6s 无回包、
|
||||||
|
1 台立刻拒连),而同市场的 `0x053D` 数量接口正常(返回 389)。原实现会重试 2 次、
|
||||||
|
每次 3s 超时,最后让 `get_universe()`(不带参数)整批失败。
|
||||||
|
|
||||||
|
现在该市场直接返回空列表并 `WARNING` 一次,**北交所标的本身不受影响**:
|
||||||
|
`get_quotes("bj920992")` / `get_bars` / 逐笔全部正常(实测 11.79 与日线 close 一致)。
|
||||||
|
|
||||||
|
### 优化
|
||||||
|
|
||||||
|
- **`get_universe()` 的 EX 全量只取一次**:命中缓存也要反序列化 10 万条(~200ms),
|
||||||
|
原先十几个 EX 市场各来一次,纯属白烧。
|
||||||
|
- **EX 商品列表改并发翻页**(110 页,8 并发):全市场冷启动的一半时间花在这里。
|
||||||
|
|
||||||
|
### 文档
|
||||||
|
|
||||||
|
- `get_universe` docstring 写明北交所限制;`API_REFERENCE` / `llms.txt` / `SKILL.md` 同步。
|
||||||
|
- 新增 `tests/test_universe.py` 7 项:请求长度锁定 16 字节、无尾部 padding、
|
||||||
|
北交所返回空且**不碰连接池**、`_ex_all` 只取一次。
|
||||||
|
|
||||||
|
### 已知限制(非本次引入)
|
||||||
|
|
||||||
|
- EX 全量列表含**非证券条目**(如人员名录),`(market, code)` 在原始数据里就不唯一,
|
||||||
|
且重复项出现在**同一页内部**。属数据源特性,未做去重(去重会丢真实品种)。
|
||||||
|
|
||||||
|
## [0.6.8] - 2026-10-23
|
||||||
|
|
||||||
|
### 修复
|
||||||
|
|
||||||
|
- **CLI 价格按品种小数位显示;`tdx minute` 时间列改回真实时钟**。
|
||||||
|
|
||||||
|
两处纯显示层缺陷,数据本身没问题(分时/逐笔数值见 0.6.7 的核对结论):
|
||||||
|
|
||||||
|
| 现象 | 原因 |
|
||||||
|
|---|---|
|
||||||
|
| `tdx transactions sh113708` 打印 `128.89` | 价格写死 `%8.2f`;可转债报价步长 0.001 元,末位被截掉 |
|
||||||
|
| `tdx minute sh113708` 时间列 `00:00~03:59` | 按序号推算 `i // 60, i % 60`,与 bar 自带时间无关 |
|
||||||
|
| `tdx quotes sh113708` 打印 `128.8920` | `price_decimal_digits` 是**解码位数**(原始整数 / 10⁴),第 4 位恒为 0 |
|
||||||
|
|
||||||
|
| 位置 | 变化 |
|
||||||
|
|---|---|
|
||||||
|
| `_price_fmt(dp)`(新) | 宽度随小数位走(`%8.2f` → `%9.3f`),不破坏表格对齐 |
|
||||||
|
| `_display_dp(market, code)`(新) | 可转债(沪 `110/111/113/118`、深 `123/127/128`)由解码 4 位降到显示 3 位;其余沿用 `price_decimal_digits`(ETF 3 位、国债/回购 4 位、股票/指数 2 位) |
|
||||||
|
| `cmd_kline` / `cmd_transactions` / `cmd_minute` / `_print_quote` | 统一改用上面的格式串 |
|
||||||
|
| `cmd_minute` | 时间取 `MinuteBar.hour/minute`,不再用序号推算 |
|
||||||
|
| `cmd_transactions` / `cmd_minute` | 改调 `get_ticks` / `get_minutes`,消掉 `get_transactions` / `get_minute` 的 DeprecationWarning |
|
||||||
|
|
||||||
|
新增回归测试 8 项(`tests/test_cli_format.py`)。
|
||||||
|
|
||||||
|
文档:`docs/cli.md` 补「价格小数位按品种适配」对照表与 `tdx minute` 时间列说明。
|
||||||
|
|
||||||
## [0.6.7] - 2026-10-22
|
## [0.6.7] - 2026-10-22
|
||||||
|
|
||||||
### 性能
|
### 性能
|
||||||
|
|||||||
@@ -139,13 +139,14 @@ await td.get_bars("cffex:IFL0", KlinePeriod.DAY, count=700) # 期货合约
|
|||||||
|
|
||||||
| 需求 | 方法 |
|
| 需求 | 方法 |
|
||||||
|---|---|
|
|---|---|
|
||||||
| 全市场标的清单(A股+港股+期货…) | `get_universe(market=None)` |
|
| 全市场标的清单(A股+港股+期货…;**北交所返回空**) | `get_universe(market=None)` |
|
||||||
| 日/周/月/分钟 K 线(任意市场) | `get_bars(symbols, period, *, count, adjust, start_date, end_date)` |
|
| 日/周/月/分钟 K 线(任意市场) | `get_bars(symbols, period, *, count, adjust, start_date, end_date)` |
|
||||||
| K 线 + MACD/KDJ/RSI/BOLL | `get_indicators(symbols, indicators, ...)` |
|
| K 线 + MACD/KDJ/RSI/BOLL | `get_indicators(symbols, indicators, ...)` |
|
||||||
| 实时五档报价(A股)/ 基础报价(港股/美股/期货) | `get_quotes(symbols, *, fields=None, pipeline=True)` |
|
| 实时五档报价(A股)/ 基础报价(港股/美股/期货) | `get_quotes(symbols, *, fields=None, pipeline=True)` |
|
||||||
| 逐笔成交(任意市场) | `get_ticks(symbols, *, date)` |
|
| 逐笔成交(任意市场) | `get_ticks(symbols, *, date)` |
|
||||||
| 分时图 / 缩略采样 | `get_minutes(symbols, *, date, sampling=True)` |
|
| 分时图 / 缩略采样 | `get_minutes(symbols, *, date, sampling=True)` |
|
||||||
| 全市场股票列表(缓存 1 天) | `get_universe("sz")` / `get_universe("sh")` |
|
| 全市场股票列表(缓存 1 天) | `get_universe("sz")` / `get_universe("sh")` |
|
||||||
|
| ~~北交所全量代码~~ | 拿不到:清单命令对 market=2 无响应(27 台全测)。北交所标的仍可直接查 `bj920992` |
|
||||||
| 除权除息 / 财务快照 | `get_xdxr(symbols)` / `get_finance(symbols)` |
|
| 除权除息 / 财务快照 | `get_xdxr(symbols)` / `get_finance(symbols)` |
|
||||||
| F10 公司资料 | `get_f10(symbol, section)` |
|
| F10 公司资料 | `get_f10(symbol, section)` |
|
||||||
| 板块列表 / 成分股 / 涨跌排行 | `get_boards` / `get_board_members` / `get_board_ranking` |
|
| 板块列表 / 成分股 / 涨跌排行 | `get_boards` / `get_board_members` / `get_board_ranking` |
|
||||||
|
|||||||
@@ -47,7 +47,7 @@ from pytdxdata import (
|
|||||||
|
|
||||||
| 方法 | 返回 | 说明 |
|
| 方法 | 返回 | 说明 |
|
||||||
|------|------|------|
|
|------|------|------|
|
||||||
| `get_universe(market=None)` | `list[SecurityInfo]` | 跨市场标的清单(A 股+港股+美股+期货/期权);每条带协议自带的 `decimal_point`(价格小数位)与 `pre_close` |
|
| `get_universe(market=None)` | `list[SecurityInfo]` | 跨市场标的清单(A 股+港股+美股+期货/期权);每条带协议自带的 `decimal_point`(价格小数位)与 `pre_close`。**北交所清单协议不支持,返回空列表** |
|
||||||
| `sync_decimal_points(markets=("sh","sz"))` | `dict` | 从证券清单同步**权威价格小数位表**(`SecurityInfo.decimal_point`),灌进 `price_decimal_digits` 的运行时表;`start()` 已自动做(当日缓存命中则零网络),此方法用于强制刷新/排障 |
|
| `sync_decimal_points(markets=("sh","sz"))` | `dict` | 从证券清单同步**权威价格小数位表**(`SecurityInfo.decimal_point`),灌进 `price_decimal_digits` 的运行时表;`start()` 已自动做(当日缓存命中则零网络),此方法用于强制刷新/排障 |
|
||||||
| `decimal_point_status()` | `dict` | 小数位表状态:`source`(`cache`/`universe`/空)、`stock`、`mixed_prefixes`、`syncing` |
|
| `decimal_point_status()` | `dict` | 小数位表状态:`source`(`cache`/`universe`/空)、`stock`、`mixed_prefixes`、`syncing` |
|
||||||
|
|
||||||
|
|||||||
+11
@@ -56,6 +56,17 @@ tdx minute sz000001 # 今日分时
|
|||||||
tdx minute sz000001 --date 20260811 # 历史分时
|
tdx minute sz000001 --date 20260811 # 历史分时
|
||||||
```
|
```
|
||||||
|
|
||||||
|
价格列的小数位**按品种自动适配**,不用自己换算:
|
||||||
|
|
||||||
|
| 品种 | 显示小数位 | 示例 |
|
||||||
|
|---|---|---|
|
||||||
|
| 股票 / 指数 | 2 | `12.34` |
|
||||||
|
| ETF / LOF / 沪市 B 股 / 可转债 | 3 | `128.892`(可转债报价步长 0.001 元) |
|
||||||
|
| 债券 / 回购 | 4 | `100.0100` |
|
||||||
|
|
||||||
|
> 可转债的**解码位数**是 4 位(原始整数 / 10⁴),但第 4 位恒为 0,所以显示按 3 位。
|
||||||
|
> `tdx minute` 的时间列是该 bar 的**真实时钟**(`09:31` / `14:57`),不是序号推算。
|
||||||
|
|
||||||
## 板块
|
## 板块
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|||||||
+1
-1
@@ -44,7 +44,7 @@ asyncio.run(main())
|
|||||||
|
|
||||||
标的一律用字符串;以下均为 v0.6 统一接口,跨市场自动选路。
|
标的一律用字符串;以下均为 v0.6 统一接口,跨市场自动选路。
|
||||||
|
|
||||||
- **标的清单**:`get_universe`(A股 + 港股 + 美股 + 期货/期权)
|
- **标的清单**:`get_universe`(A股 + 港股 + 美股 + 期货/期权)。⚠️ 北交所(`market="bj"`)清单**协议不支持**,返回空列表(`0x053E` 对 market=2 无响应,27 台服务器全测);但北交所**标的本身可用** —— 报价/K线/逐笔直接传 `bj920992` 这类代码正常
|
||||||
- **K 线**:`get_bars`(自动并发分页、支持复权与日期区间、多标的并发)
|
- **K 线**:`get_bars`(自动并发分页、支持复权与日期区间、多标的并发)
|
||||||
- **技术指标**:`get_indicators`(K线 + MACD/KDJ/RSI/BOLL/MA/EMA)
|
- **技术指标**:`get_indicators`(K线 + MACD/KDJ/RSI/BOLL/MA/EMA)
|
||||||
- **报价**:`get_quotes`(五档,>80 只自动切批;**单连接流水线**默认开启,全市场 5,200 只 A股 ~0.33s)、`get_snapshot`(个股特征)、`get_market_stat`
|
- **报价**:`get_quotes`(五档,>80 只自动切批;**单连接流水线**默认开启,全市场 5,200 只 A股 ~0.33s)、`get_snapshot`(个股特征)、`get_market_stat`
|
||||||
|
|||||||
+1
-1
@@ -1,6 +1,6 @@
|
|||||||
[project]
|
[project]
|
||||||
name = "pytdxdata"
|
name = "pytdxdata"
|
||||||
version = "0.6.7"
|
version = "0.6.9"
|
||||||
description = "通达信(TongDaXin)行情数据客户端:动态连接池 + 双层TTL缓存 + 3连接并发分页,纯asyncio零运行时依赖,支持A股/港股/美股/期货/期权"
|
description = "通达信(TongDaXin)行情数据客户端:动态连接池 + 双层TTL缓存 + 3连接并发分页,纯asyncio零运行时依赖,支持A股/港股/美股/期货/期权"
|
||||||
readme = "README.md"
|
readme = "README.md"
|
||||||
requires-python = ">=3.11"
|
requires-python = ">=3.11"
|
||||||
|
|||||||
@@ -18,7 +18,7 @@ from .models import (
|
|||||||
XdxrRecord,
|
XdxrRecord,
|
||||||
)
|
)
|
||||||
|
|
||||||
__version__ = "0.6.7"
|
__version__ = "0.6.9"
|
||||||
__all__ = [
|
__all__ = [
|
||||||
"TdxData",
|
"TdxData",
|
||||||
"Market",
|
"Market",
|
||||||
|
|||||||
+36
-7
@@ -155,6 +155,12 @@ _EX_TICK_PAGE = 1800 # 港股逐笔单页
|
|||||||
_ALL_PAGES_CAP = 50 # count=None(全量)时的翻页上限
|
_ALL_PAGES_CAP = 50 # count=None(全量)时的翻页上限
|
||||||
# 集合竞价**委托**记录标记(0x122F 第 5 字段)。不是成交,见 _ticks_one 注释。
|
# 集合竞价**委托**记录标记(0x122F 第 5 字段)。不是成交,见 _ticks_one 注释。
|
||||||
_BS_AUCTION_ORDER = 8
|
_BS_AUCTION_ORDER = 8
|
||||||
|
# 证券清单(0x053E)拿不到的市场。实测 27 台标准主机对 market=2(北交所)**全部
|
||||||
|
# 不响应**(26 台 6s 无回包、1 台立刻拒连),而同 market 的 0x053D 数量接口正常
|
||||||
|
# (返回 389)。故清单直接返回空,避免每次调用白等数秒再抛 ConnectionError。
|
||||||
|
# 北交所**标的本身没问题**:报价/K线/逐笔用 ``bj920992`` 这类代码都正常。
|
||||||
|
_LIST_UNSUPPORTED_MARKETS = frozenset({int(Market.BJ)})
|
||||||
|
_list_unsupported_warned: set[int] = set() # 同一市场只 WARNING 一次
|
||||||
|
|
||||||
# 港股系市场:逐笔走 EX 专用 16B 协议(0x23FC/0x2406),其余扩展市场走 MAC 0x122F
|
# 港股系市场:逐笔走 EX 专用 16B 协议(0x23FC/0x2406),其余扩展市场走 MAC 0x122F
|
||||||
_HK_MARKETS = frozenset({27, 31, 48, 49, 71, 98})
|
_HK_MARKETS = frozenset({27, 31, 48, 49, 71, 98})
|
||||||
@@ -331,11 +337,22 @@ class TdxData:
|
|||||||
返回:
|
返回:
|
||||||
``list[SecurityInfo]``,每条带 ``symbol`` 规范化标的串与 ``kind`` 分类描述。
|
``list[SecurityInfo]``,每条带 ``symbol`` 规范化标的串与 ``kind`` 分类描述。
|
||||||
EX 通道无昨收/单位,对应字段为 0。
|
EX 通道无昨收/单位,对应字段为 0。
|
||||||
|
|
||||||
|
注意:
|
||||||
|
**北交所(``"bj"``)清单返回空列表**:清单命令 0x053E 对 market=2
|
||||||
|
在所有实测服务器上都不响应(27 台全测),协议层根本拿不到。
|
||||||
|
但北交所**标的本身可用** —— 报价/K线/逐笔直接传 ``bj920992`` 这类代码
|
||||||
|
都正常,只是无法枚举全量代码。``market="all"`` 时该市场被跳过,不会报错。
|
||||||
"""
|
"""
|
||||||
out: list[SecurityInfo] = []
|
out: list[SecurityInfo] = []
|
||||||
|
ex_items: list[SecurityInfo] | None = None
|
||||||
for mkt, channel in market_targets(market):
|
for mkt, channel in market_targets(market):
|
||||||
if channel == "ex":
|
if channel == "ex":
|
||||||
out.extend(await self._universe_ex(mkt))
|
# EX 全量只取一次:命中缓存也要反序列化 10 万条(~200ms),
|
||||||
|
# 十几个 EX 市场各来一次纯属白烧。
|
||||||
|
if ex_items is None:
|
||||||
|
ex_items = await self._ex_all()
|
||||||
|
out.extend(it for it in ex_items if it.market == mkt)
|
||||||
else:
|
else:
|
||||||
out.extend(await self._universe_cn(mkt))
|
out.extend(await self._universe_cn(mkt))
|
||||||
return out
|
return out
|
||||||
@@ -374,6 +391,14 @@ class TdxData:
|
|||||||
return decimal_sync.status()
|
return decimal_sync.status()
|
||||||
|
|
||||||
async def _universe_cn(self, market: int) -> list[SecurityInfo]:
|
async def _universe_cn(self, market: int) -> list[SecurityInfo]:
|
||||||
|
if market in _LIST_UNSUPPORTED_MARKETS:
|
||||||
|
if market not in _list_unsupported_warned:
|
||||||
|
_list_unsupported_warned.add(market)
|
||||||
|
log.warning(
|
||||||
|
"市场 %s 的证券清单接口协议不支持(0x053E 无响应),返回空列表;"
|
||||||
|
"该市场标的的报价/K线/逐笔不受影响", market)
|
||||||
|
return []
|
||||||
|
|
||||||
key = CacheKey("list", market)
|
key = CacheKey("list", market)
|
||||||
|
|
||||||
async def fetch() -> bytes:
|
async def fetch() -> bytes:
|
||||||
@@ -402,13 +427,18 @@ class TdxData:
|
|||||||
|
|
||||||
async def fetch() -> bytes:
|
async def fetch() -> bytes:
|
||||||
total = int(await self._execute_ex(GetExInstrumentCountCmd()))
|
total = int(await self._execute_ex(GetExInstrumentCountCmd()))
|
||||||
items: list[SecurityInfo] = []
|
starts = list(range(0, total, _EX_PAGE))
|
||||||
pos = 0
|
sem = asyncio.Semaphore(8) # 实测 8 页并发 292ms(串行 110 页 ~4s)
|
||||||
while pos < total:
|
|
||||||
page = await self._execute_ex(
|
async def one(pos: int) -> list[dict]:
|
||||||
|
async with sem:
|
||||||
|
return await self._execute_ex(
|
||||||
GetExInstrumentInfoCmd(0, pos, _EX_PAGE))
|
GetExInstrumentInfoCmd(0, pos, _EX_PAGE))
|
||||||
|
|
||||||
|
items: list[SecurityInfo] = []
|
||||||
|
for page in await asyncio.gather(*(one(s) for s in starts)):
|
||||||
if not page:
|
if not page:
|
||||||
break
|
continue
|
||||||
for g in page:
|
for g in page:
|
||||||
mkt = int(g["market"])
|
mkt = int(g["market"])
|
||||||
code = str(g["code"]).strip()
|
code = str(g["code"]).strip()
|
||||||
@@ -422,7 +452,6 @@ class TdxData:
|
|||||||
symbol=format_symbol(mkt, code),
|
symbol=format_symbol(mkt, code),
|
||||||
kind=str(g.get("desc", "")).strip(),
|
kind=str(g.get("desc", "")).strip(),
|
||||||
))
|
))
|
||||||
pos += len(page)
|
|
||||||
return pack_payload(items)
|
return pack_payload(items)
|
||||||
|
|
||||||
return unpack_payload(await self._cache.get_or_fetch(key, fetch))
|
return unpack_payload(await self._cache.get_or_fetch(key, fetch))
|
||||||
|
|||||||
@@ -162,9 +162,9 @@ def _print_quote(q) -> None:
|
|||||||
print("=" * 58)
|
print("=" * 58)
|
||||||
label = "%s %s" % (mkt, q.code) if mkt else "%s %s" % (q.code, q.server_time or datetime.now().strftime("%H:%M:%S"))
|
label = "%s %s" % (mkt, q.code) if mkt else "%s %s" % (q.code, q.server_time or datetime.now().strftime("%H:%M:%S"))
|
||||||
print(" %s" % label)
|
print(" %s" % label)
|
||||||
print((" 最新 %-10.*f 涨跌 %+8.*f (%+.2f%%)" % (dp, q.price, dp, q.price - q.pre_close, pct)))
|
print(" 最新 %-10.*f 涨跌 %+8.*f (%+.2f%%)" % (dp, q.price, dp, q.price - q.pre_close, pct))
|
||||||
print((" 今开 %-10.*f 最高 %.*f 最低 %.*f" % (dp, q.open, dp, q.high, dp, q.low)))
|
print(" 今开 %-10.*f 最高 %.*f 最低 %.*f" % (dp, q.open, dp, q.high, dp, q.low))
|
||||||
print((" 昨收 %-10.*f 成交量 %s 成交额 %s" % (dp, q.pre_close, _fmt_num(q.vol), _fmt_num(q.amount))))
|
print(" 昨收 %-10.*f 成交量 %s 成交额 %s" % (dp, q.pre_close, _fmt_num(q.vol), _fmt_num(q.amount)))
|
||||||
if q.bid and q.ask:
|
if q.bid and q.ask:
|
||||||
print(" " + "-" * 56)
|
print(" " + "-" * 56)
|
||||||
pf = _price_fmt(dp)
|
pf = _price_fmt(dp)
|
||||||
|
|||||||
@@ -36,8 +36,12 @@ class GetSecurityListCmd(BaseCommand[list[SecurityInfo]]):
|
|||||||
self.start = start
|
self.start = start
|
||||||
|
|
||||||
def build_request(self) -> bytes:
|
def build_request(self) -> bytes:
|
||||||
|
# 12 字节头 + market(H) + start(H) = **16 字节**。
|
||||||
|
# ⚠️ 曾经多塞一个 H(18 字节):服务端只消费前 16 字节,剩下的 00 00
|
||||||
|
# 留在它的接收缓冲里,会把**下一个请求**的开头吃掉 → 该连接的后续请求
|
||||||
|
# 永远得不到响应(表现为「第一次成功、第二次起全部通信超时」)。
|
||||||
header = bytes.fromhex("0c0118640101060006005004".replace(" ", ""))
|
header = bytes.fromhex("0c0118640101060006005004".replace(" ", ""))
|
||||||
return header + struct.pack("<HHH", self.market, self.start, 0)
|
return header + struct.pack("<HH", self.market, self.start)
|
||||||
|
|
||||||
def parse_response(self, body: bytes) -> list[SecurityInfo]:
|
def parse_response(self, body: bytes) -> list[SecurityInfo]:
|
||||||
(num,) = unpack_from("<H", body, 0, "security list header")
|
(num,) = unpack_from("<H", body, 0, "security list header")
|
||||||
|
|||||||
@@ -0,0 +1,125 @@
|
|||||||
|
"""CLI 价格小数位 / 分时时间列的显示回归。
|
||||||
|
|
||||||
|
覆盖两个曾经出错的地方:
|
||||||
|
|
||||||
|
1. ``tdx minute`` 的时间列按序号推算(``i // 60, i % 60``),240 根分时被打印成
|
||||||
|
``00:00~03:59``,与真实交易时间无关。
|
||||||
|
2. 价格固定写死 ``%8.2f``,可转债(报价步长 0.001 元)会被截成 2 位
|
||||||
|
——``128.892`` 打成 ``128.89``。
|
||||||
|
|
||||||
|
注意 ``price_decimal_digits`` 返回的是**解码位数**(原始整数 / 10**dp),可转债
|
||||||
|
是 4 位,但第 4 位恒为 0,显示层只该给 3 位(见 ``_display_dp``)。
|
||||||
|
"""
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
from pytdxdata.cli import (
|
||||||
|
_display_dp,
|
||||||
|
_dp_of,
|
||||||
|
_price_fmt,
|
||||||
|
cmd_minute,
|
||||||
|
cmd_transactions,
|
||||||
|
parse_symbol,
|
||||||
|
)
|
||||||
|
from pytdxdata.models import MinuteBar, TransactionRecord
|
||||||
|
|
||||||
|
|
||||||
|
class FakeTD:
|
||||||
|
"""只实现 minute / transactions 需要的两个接口。"""
|
||||||
|
|
||||||
|
def __init__(self, minutes=None, ticks=None):
|
||||||
|
self._minutes = minutes or []
|
||||||
|
self._ticks = ticks or []
|
||||||
|
|
||||||
|
async def get_minutes(self, sym, date=None):
|
||||||
|
return self._minutes
|
||||||
|
|
||||||
|
async def get_ticks(self, sym, date=None, count=None):
|
||||||
|
return self._ticks
|
||||||
|
|
||||||
|
|
||||||
|
def _bar(price, hour, minute, vol=100.0, avg=0.0):
|
||||||
|
return MinuteBar(price=price, vol=vol, avg_price=avg or price,
|
||||||
|
hour=hour, minute=minute, fields={})
|
||||||
|
|
||||||
|
|
||||||
|
def _tick(price, vol, trade_count=1, available=True, time="14:59:54"):
|
||||||
|
return TransactionRecord(market=1, code="113708", time=time, price=price, vol=vol,
|
||||||
|
trade_count=trade_count, bs_flag=0, fields={},
|
||||||
|
trade_count_available=available)
|
||||||
|
|
||||||
|
|
||||||
|
# --------------------------------------------------------------------------- #
|
||||||
|
# 小数位判定
|
||||||
|
# --------------------------------------------------------------------------- #
|
||||||
|
|
||||||
|
def test_price_fmt_width_tracks_decimals():
|
||||||
|
assert _price_fmt(2) == "%8.2f" # 股票:保持原宽度,不破坏对齐
|
||||||
|
assert _price_fmt(3) == "%9.3f"
|
||||||
|
assert _price_fmt(4) == "%10.4f"
|
||||||
|
assert _price_fmt(None) == "%8.2f" # 缺省当 2 位
|
||||||
|
|
||||||
|
|
||||||
|
def test_display_dp_by_instrument():
|
||||||
|
assert _display_dp(1, "600000") == 2 # 沪股票
|
||||||
|
assert _display_dp(0, "000001") == 2 # 深股票
|
||||||
|
assert _display_dp(1, "000001") == 2 # 指数
|
||||||
|
assert _display_dp(1, "113708") == 3 # 沪可转债(解码 4 位,显示 3 位)
|
||||||
|
assert _display_dp(1, "110102") == 3
|
||||||
|
assert _display_dp(0, "123235") == 3 # 深可转债
|
||||||
|
assert _display_dp(0, "128136") == 3
|
||||||
|
assert _display_dp(1, "510310") == 3 # ETF
|
||||||
|
assert _display_dp(1, "019547") == 4 # 国债:4 位是真实报价精度
|
||||||
|
|
||||||
|
|
||||||
|
def test_dp_of_uses_cn_only():
|
||||||
|
assert _dp_of(parse_symbol("sh113708")) == 3
|
||||||
|
assert _dp_of(parse_symbol("sh600000")) == 2
|
||||||
|
assert _dp_of(parse_symbol("hk00700")) == 2 # 非 A 股固定 2 位
|
||||||
|
|
||||||
|
|
||||||
|
# --------------------------------------------------------------------------- #
|
||||||
|
# tdx minute
|
||||||
|
# --------------------------------------------------------------------------- #
|
||||||
|
|
||||||
|
async def test_cmd_minute_prints_real_clock(capsys):
|
||||||
|
bars = [_bar(129.271, 9, 30), _bar(129.270, 9, 31), _bar(128.892, 14, 59)]
|
||||||
|
await cmd_minute(FakeTD(minutes=bars), "sh113708", None)
|
||||||
|
out = capsys.readouterr().out
|
||||||
|
assert "09:30" in out and "09:31" in out and "14:59" in out
|
||||||
|
assert "00:00" not in out and "03:59" not in out
|
||||||
|
|
||||||
|
|
||||||
|
async def test_cmd_minute_cb_keeps_three_decimals(capsys):
|
||||||
|
await cmd_minute(FakeTD(minutes=[_bar(128.892, 14, 59)]), "sh113708", None)
|
||||||
|
out = capsys.readouterr().out
|
||||||
|
assert "128.892" in out
|
||||||
|
assert "128.89 " not in out
|
||||||
|
|
||||||
|
|
||||||
|
async def test_cmd_minute_stock_two_decimals(capsys):
|
||||||
|
await cmd_minute(FakeTD(minutes=[_bar(9.62, 15, 0)]), "sh600000", None)
|
||||||
|
out = capsys.readouterr().out
|
||||||
|
assert "9.62" in out and "9.620" not in out
|
||||||
|
|
||||||
|
|
||||||
|
# --------------------------------------------------------------------------- #
|
||||||
|
# tdx transactions
|
||||||
|
# --------------------------------------------------------------------------- #
|
||||||
|
|
||||||
|
async def test_cmd_transactions_cb_price_and_count(capsys):
|
||||||
|
await cmd_transactions(FakeTD(ticks=[_tick(128.892, 3, trade_count=4)]),
|
||||||
|
"sh113708", 50, None)
|
||||||
|
out = capsys.readouterr().out
|
||||||
|
assert "128.892" in out
|
||||||
|
assert "(4笔)" in out
|
||||||
|
|
||||||
|
|
||||||
|
async def test_cmd_transactions_etf_marks_missing_count(capsys):
|
||||||
|
tick = TransactionRecord(market=1, code="510310", time="15:27:35", price=3.989,
|
||||||
|
vol=15, trade_count=0, bs_flag=0, fields={},
|
||||||
|
trade_count_available=False)
|
||||||
|
await cmd_transactions(FakeTD(ticks=[tick]), "sh510310", 50, None)
|
||||||
|
out = capsys.readouterr().out
|
||||||
|
assert "3.989" in out # ETF 也是 3 位
|
||||||
|
assert "(-)" in out # 不打印假笔数
|
||||||
|
assert "笔)" not in out
|
||||||
@@ -0,0 +1,91 @@
|
|||||||
|
"""证券清单(0x053E)回归测试:请求长度 + 北交所降级。全部离线。
|
||||||
|
|
||||||
|
背景(2026-10-23 实测):`build_request` 曾经多塞一个 ``H``(18 字节),
|
||||||
|
服务端只消费前 16 字节,剩下的 ``00 00`` 留在它的接收缓冲里,把**下一个请求**
|
||||||
|
的开头吃掉 → 同一连接「第一次成功、第二次起全部通信超时」。
|
||||||
|
`get_universe` 的分页器复用连接,于是 66/28 页全靠失败重连,冷启动 12~18s。
|
||||||
|
"""
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import struct
|
||||||
|
import unittest.mock as mock
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
from pytdxdata.models import Market
|
||||||
|
from pytdxdata.protocol.commands import GetSecurityListCmd
|
||||||
|
|
||||||
|
_HEADER = bytes.fromhex("0c0118640101060006005004")
|
||||||
|
|
||||||
|
|
||||||
|
def test_request_is_exactly_16_bytes():
|
||||||
|
"""12 字节命令头 + market(H) + start(H),一个字节都不能多。"""
|
||||||
|
req = GetSecurityListCmd(1, 0).build_request()
|
||||||
|
assert len(req) == 16
|
||||||
|
assert req == _HEADER + struct.pack("<HH", 1, 0)
|
||||||
|
|
||||||
|
|
||||||
|
def test_request_encodes_market_and_start_little_endian():
|
||||||
|
req = GetSecurityListCmd(0, 2000).build_request()
|
||||||
|
assert req[:12] == _HEADER
|
||||||
|
market, start = struct.unpack("<HH", req[12:])
|
||||||
|
assert (market, start) == (0, 2000)
|
||||||
|
|
||||||
|
|
||||||
|
def test_request_has_no_trailing_padding():
|
||||||
|
"""尾部不能有 padding:多余的 0 会让服务端解析错位。"""
|
||||||
|
for market in (0, 1, 2):
|
||||||
|
for start in (0, 1000, 27000):
|
||||||
|
req = GetSecurityListCmd(market, start).build_request()
|
||||||
|
assert len(req) == 16, f"market={market} start={start} -> {len(req)} 字节"
|
||||||
|
|
||||||
|
|
||||||
|
def test_parse_response_reads_all_records():
|
||||||
|
"""29 字节/条,头部 2 字节条数。"""
|
||||||
|
code, name = b"600000", "浦发银行".encode("gbk").ljust(8, b"\x00")
|
||||||
|
rec = struct.pack("<6sH8s4sBI4s", code, 100, name, b"\x00" * 4, 2, 0, b"\x00" * 4)
|
||||||
|
assert len(rec) == 29
|
||||||
|
body = struct.pack("<H", 2) + rec + rec
|
||||||
|
rows = GetSecurityListCmd(1, 0).parse_response(body)
|
||||||
|
assert len(rows) == 2
|
||||||
|
assert rows[0].code == "600000"
|
||||||
|
assert rows[0].decimal_point == 2
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.asyncio
|
||||||
|
async def test_bj_universe_returns_empty_without_network():
|
||||||
|
"""北交所清单协议不支持:必须立刻返回空,且**不碰连接池**。"""
|
||||||
|
from pytdxdata.api import TdxData
|
||||||
|
|
||||||
|
td = TdxData()
|
||||||
|
td._std_pool.acquire = mock.AsyncMock(side_effect=AssertionError("不该联网"))
|
||||||
|
td._std_pool.acquire_many = mock.AsyncMock(
|
||||||
|
side_effect=AssertionError("不该联网"))
|
||||||
|
rows = await td.get_universe("bj")
|
||||||
|
assert rows == []
|
||||||
|
td._std_pool.acquire.assert_not_called()
|
||||||
|
td._std_pool.acquire_many.assert_not_called()
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.asyncio
|
||||||
|
async def test_bj_market_is_in_unsupported_set():
|
||||||
|
from pytdxdata import api as api_mod
|
||||||
|
|
||||||
|
assert int(Market.BJ) in api_mod._LIST_UNSUPPORTED_MARKETS
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.asyncio
|
||||||
|
async def test_ex_all_fetched_once_in_get_universe():
|
||||||
|
"""`get_universe()` 跨多个 EX 市场时,EX 全量只能取一次。"""
|
||||||
|
from pytdxdata.api import TdxData
|
||||||
|
|
||||||
|
td = TdxData()
|
||||||
|
calls = {"n": 0}
|
||||||
|
|
||||||
|
async def fake_ex_all():
|
||||||
|
calls["n"] += 1
|
||||||
|
return []
|
||||||
|
|
||||||
|
td._ex_all = fake_ex_all
|
||||||
|
await td.get_universe("all")
|
||||||
|
assert calls["n"] == 1, f"_ex_all 被调用 {calls['n']} 次(应为 1)"
|
||||||
Reference in new issue
Block a user