v0.4.0: 初始开源发布

通达信(TDX)行情数据客户端 —— 动态连接池 + 双层TTL缓存 + 3连接并发分页,
纯 asyncio、零运行时依赖。一套接口覆盖 A股(沪/深/北) / 港股 / 美股 / 期货 / 期权。

主要能力:
- 四层架构:api → pool(标准/MAC/EX 三池) → protocol(16 命令模块) → cache(内存+SQLite)
- TdxData 提供 51 个公开异步方法;CLI(tdx) 提供 19 个子命令
- 服务器文件下载 + 解析:板块 block_*.dat / 行业 tdxhy.cfg / 历史财报 gpcw*.zip
- 85 个离线测试(协议 / 连接池 / 缓存 / 分页 / API / 文件解析 / CLI)

协议层参照 easy-tdx 的字节级格式独立实现,不依赖 easy-tdx 包。
This commit is contained in:
openbot-coder committed 2026-09-15 11:38:44 +08:00
commit 9183c3294f
68 files changed
+9249

No files matched your search

+120
View File
@@ -0,0 +1,120 @@
"""连接池/健康分单元测试(mock服务器,不连真实网络)"""
from __future__ import annotations
import asyncio
import sys
import unittest.mock as mock
import pytest
from pytdxdata.pool.health import HealthEngine
from pytdxdata.pool.pool import DynamicPool, PoolTimeoutError
# ---------- HealthEngine ----------
def test_health_default_score():
h = HealthEngine()
assert h.score("server1") == 1.0
def test_health_failure_penalty():
h = HealthEngine()
h.record_failure("s1")
assert h.score("s1") == 0.5
h.record_failure("s1")
h.record_failure("s1")
assert h.in_cooldown("s1") # 连续3次失败进入冷却
def test_health_success_recovery():
h = HealthEngine()
h.record_failure("s1")
h.record_success("s1")
assert h.score("s1") == pytest.approx(0.7)
assert not h.in_cooldown("s1")
def test_health_rank():
h = HealthEngine()
h.record_success("fast", latency=0.05)
h.record_success("slow", latency=0.5)
ranked = h.rank(["slow", "fast"])
assert ranked[0] == "fast"
# ---------- DynamicPool ----------
class FakeConn:
def __init__(self, host):
self.host = host
self.alive_flag = True
@property
def alive(self):
return self.alive_flag
async def connect(self):
pass
async def ping(self):
return 0.01
async def close(self):
self.alive_flag = False
async def execute(self, cmd):
return "ok"
@pytest.fixture
def fake_pool():
with mock.patch("pytdxdata.pool.pool.TdxConnection", side_effect=lambda h, p=7709, t=10.0: FakeConn(h)):
pool = DynamicPool(["s1", "s2"], min_size=1, max_size=3, per_server_cap=2,
idle_ttl=0.2, scale_down_grace=0, reaper_interval=0.05)
yield pool
@pytest.mark.asyncio
async def test_pool_acquire_release(fake_pool):
await fake_pool.start()
pc = await fake_pool.acquire()
assert pc.server in ("s1", "s2")
assert fake_pool.stats.borrowed == 1
await fake_pool.release(pc)
assert fake_pool.stats.borrowed == 0
await fake_pool.close()
@pytest.mark.asyncio
async def test_pool_acquire_many(fake_pool):
await fake_pool.start()
conns = await fake_pool.acquire_many(2)
assert len(conns) == 2
servers = {c.server for c in conns}
for c in conns:
await fake_pool.release(c)
await fake_pool.close()
@pytest.mark.asyncio
async def test_pool_broken_release(fake_pool):
await fake_pool.start()
pc = await fake_pool.acquire()
await fake_pool.release(pc, broken=True)
assert fake_pool.stats.total <= fake_pool.min_size
await fake_pool.close()
@pytest.mark.asyncio
async def test_pool_scale_down(fake_pool):
"""空闲连接超时后缩容到 min_size。"""
await fake_pool.start()
pc1 = await fake_pool.acquire()
await fake_pool.release(pc1)
pc2 = await fake_pool.acquire()
await fake_pool.release(pc2)
total_before = fake_pool.stats.total
await asyncio.sleep(0.3) # 等 reaper 缩容
assert fake_pool.stats.total <= total_before
await fake_pool.close()