Files
pytdxdata/src/pytdxdata/cache/key.py
T
openbot-coder 3e0beb27a6 release: v0.6.0(统一对外接口重构)
按「数据类型」合并同类查询接口:一个数据类型 = 一个方法,跨市场自动选路。

- 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 方法回归)。
2026-09-17 11:34:52 +08:00

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)