按「数据类型」合并同类查询接口:一个数据类型 = 一个方法,跨市场自动选路。 - 28 个统一接口(get_universe/get_quotes/get_bars/get_indicators/get_ticks/ get_minutes/get_f10/get_file/get_boards/get_board_of/get_snapshot 等), 标的统一字符串写法(sz000001 / hk00700 / usAAPL / cffex:IFL0); 同名旧方法不再兼容 (market, code) 元组。 - 旧 51 个按通道/市场分裂的接口:33 个保留为 deprecated 别名(1.0 移除), 18 个同名升级为统一接口。公开方法共 63 个。 - 新增库层标的解析 pytdxdata.symbols;数据模型追加 symbol/name/fields 兜底字段。 - 修复:分页器连接泄漏、日期区间 K线返回 0 条(偏移方向探测)、池子全冷却死等。 - 文档/README/SKILL/llms.txt 全量同步;新增 docs/refactor-audit.md 审查报告。 - 测试 127 个用例全绿(含 tests/test_all_interfaces.py 全 63 方法回归)。
52 lines
1.8 KiB
Python
52 lines
1.8 KiB
Python
"""缓存键构造:{category}|{market}|{code}|{period}|{start}|{count}|{extra}"""
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass, field
|
|
from typing import Sequence
|
|
|
|
|
|
@dataclass(frozen=True, slots=True)
|
|
class CacheKey:
|
|
category: str # kline|quote|transaction|list|minute|xdxr|finance
|
|
market: int | None = None
|
|
code: str | None = None
|
|
period: str | None = None
|
|
start: int | None = None
|
|
count: int | None = None
|
|
extra: str = "" # adjust/date/股票集哈希 等规范化参数
|
|
|
|
def to_str(self) -> str:
|
|
return "|".join([
|
|
self.category,
|
|
"" if self.market is None else str(self.market),
|
|
self.code or "",
|
|
self.period or "",
|
|
"" if self.start is None else str(self.start),
|
|
"" if self.count is None else str(self.count),
|
|
self.extra,
|
|
])
|
|
|
|
@classmethod
|
|
def from_str(cls, s: str) -> "CacheKey":
|
|
parts = s.split("|")
|
|
while len(parts) < 7:
|
|
parts.append("")
|
|
def _i(v: str) -> int | None:
|
|
return int(v) if v else None
|
|
return cls(
|
|
category=parts[0], market=_i(parts[1]), code=parts[2] or None,
|
|
period=parts[3] or None, start=_i(parts[4]), count=_i(parts[5]),
|
|
extra=parts[6],
|
|
)
|
|
|
|
@classmethod
|
|
def quote_key(cls, stocks: Sequence[tuple[int, str]],
|
|
tag: str = "") -> "CacheKey":
|
|
"""报价键:对股票集规范化排序,顺序无关可命中。
|
|
|
|
``tag`` 区分取数口径(标准五档 / MAC·EX 字段位),不同口径不互相命中。
|
|
"""
|
|
norm = sorted(f"{m}:{c}" for m, c in stocks)
|
|
extra = ",".join(norm)
|
|
return cls(category="quote", extra=f"{tag}#{extra}" if tag else extra)
|