"""协议层单元测试:帧/价格差分/浮点/命令解析(黄金字节向量,对照 easy-tdx 已验证实现)""" from __future__ import annotations import struct from collections import Counter from datetime import date, datetime import pytest from pytdxdata.models import Adjust, KlinePeriod, SecurityBar from pytdxdata.protocol.commands.ex_proto import GetExInstrumentBarsCmd from pytdxdata.protocol.commands.kline import GetSecurityBarsCmd from pytdxdata.protocol.commands.mac import MacKlineCmd from pytdxdata.protocol.commands.minute import GetHistoryMinuteTimeDataCmd from pytdxdata.protocol.commands.quotes import price_decimal_digits from pytdxdata.protocol.commands.transaction import MacTransactionCmd from pytdxdata.protocol.frame import FrameHeader, decompress_body, parse_header from pytdxdata.protocol.price import decode_ohlc_diffs, get_price, put_price from pytdxdata.protocol.volume import decode_volume # ---------- 变长有符号整数 ---------- @pytest.mark.parametrize("value", [0, 1, -1, 63, 64, -64, 127, -128, 1000, -100000, 2**20]) def test_price_roundtrip(value: int): enc = put_price(value) dec, pos = get_price(enc, 0) assert dec == value assert pos == len(enc) def test_price_negative_flag(): # 首字节 bit6=符号 enc = put_price(-5) assert enc[0] & 0x40 dec, _ = get_price(enc, 0) assert dec == -5 # ---------- OHLC 差分还原 ---------- def test_decode_ohlc_diffs(): # 手工构造:open_diff=100, close_diff=-20, high_diff=10, low_diff=-30 body = bytearray() for v in (100, -20, 10, -30): body.extend(put_price(v)) od, cd, hd, ld, pos = decode_ohlc_diffs(body, 0) assert (od, cd, hd, ld) == (100, -20, 10, -30) assert pos == len(body) # ---------- 自定义4字节浮点 ---------- def test_decode_volume_zero(): assert decode_volume(0) == 0.0 def test_decode_volume_known(): # 经验值:0x00000001 应为极小正数(非0) assert decode_volume(1) > 0 # ---------- 响应帧头 ---------- def test_frame_header(): # magic=7654321, 未压缩: zipsize==unzipsize buf = struct.pack(" bytes: """构造 0x23FF 响应体:20B头(count@18) + 每条32B(4B时间 + 28B行情)。""" body = bytearray(20 + len(raw_dates) * 32) struct.pack_into(" SecurityBar: return SecurityBar(market=market, code="X", open=1.0, high=1.0, low=1.0, close=1.0, vol=1.0, amount=1.0, year=y, month=mo, day=d, hour=h, minute=mi) def test_us_evening_segment_keeps_date(): # 北京 21:31 ~ 23:59 与美东交易日属同一自然日,日期不动 b = _bar(74, 2026, 10, 12, 21, 31) assert b.datetime == datetime(2026, 10, 12, 21, 31) assert b.trading_date == "2026-10-12" def test_us_midnight_segment_rolls_to_next_day(): # 北京次日 00:00 ~ 04:00 实际是美东 12:00~16:00,日期要 +1 天 b = _bar(74, 2026, 10, 12, 4, 0) assert b.datetime == datetime(2026, 10, 13, 4, 0) assert (b.hour, b.minute) == (4, 0) # 时分不参与归一化 assert b.trading_date == "2026-10-12" # 仍归属美东 10-12 交易日 def test_us_split_hour_boundary(): assert _bar(74, 2026, 10, 12, 11, 59).day == 13 assert _bar(74, 2026, 10, 12, 12, 0).day == 12 def test_us_month_and_year_rollover(): assert _bar(74, 2026, 10, 31, 4, 0).datetime == datetime(2026, 11, 1, 4, 0) assert _bar(74, 2026, 12, 31, 4, 0).datetime == datetime(2027, 1, 1, 4, 0) def test_cn_and_hk_bars_untouched(): cn = _bar(1, 2026, 10, 12, 9, 31) # A股/标准通道 assert (cn.year, cn.month, cn.day) == (2026, 10, 12) assert cn.trading_date == "2026-10-12" hk = _bar(31, 2026, 10, 12, 4, 0) # 港股同为 UTC+8,凌晨段不应 +1 assert (hk.year, hk.month, hk.day) == (2026, 10, 12) assert hk.trading_date == "2026-10-12" def test_us_full_session_is_monotonic_and_single_trading_day(): # 实测口径:北京 21:31~23:59(149 根)+ 次日 00:00~04:00(241 根)= 390 根 mins = list(range(21 * 60 + 31, 24 * 60)) + list(range(4 * 60 + 1)) assert len(mins) == 390 bars = [_bar(74, 2026, 10, 12, m // 60, m % 60) for m in mins] bars.sort(key=lambda b: b.datetime) dts = [b.datetime for b in bars] assert dts == sorted(dts) # 归一化后严格单调 assert dts[0] == datetime(2026, 10, 12, 21, 31) assert dts[-1] == datetime(2026, 10, 13, 4, 0) # 全部归属于同一个美东交易日 assert {b.trading_date for b in bars} == {"2026-10-12"} # 但横跨两个北京自然日(这正是不能用 datetime.date() 聚合的原因) by_day = Counter(b.datetime.date() for b in bars) assert by_day[date(2026, 10, 12)] == 149 assert by_day[date(2026, 10, 13)] == 241 # ---------- MAC 通道 K线(0x122E)同样归一化 ---------- def _mac_bars_body(records: list[tuple[int, int]]) -> bytes: """构造 0x122E 响应体:33B头(count@24) + 每条36B(4B ymd + 4B time秒 + 7float)。""" body = bytearray(33 + len(records) * 36) struct.pack_into(" list: """构造 usAAPL 的 390 条分时:从北京 21:30 起连续 n 分钟。""" from pytdxdata.models import MinuteBar start = 21 * 60 + 30 return [ MinuteBar(price=100.0 + i * 0.01, vol=1.0, hour=(start + i) // 60, minute=(start + i) % 60, market=74, code="AAPL", date=20261022) for i in range(n) ] def test_minute_bar_us_hour_is_valid_clock_value(): """EX 分时的 minutes 是「自开盘起的连续分钟数」,直接 //60 会得到 hour=27。""" bars = _us_minutes() assert all(0 <= b.hour < 24 for b in bars) # 归一化前的原始值确实越界(21:30 + 390min = 28:00) assert max(b.hour + b.day_offset * 24 for b in bars) > 23 def test_minute_bar_us_day_offset_marks_next_day(): bars = _us_minutes() assert bars[0].day_offset == 0 # 21:30 当晚 assert bars[-1].day_offset == 1 # 03:59 次日 assert (bars[-1].hour, bars[-1].minute) == (3, 59) def test_minute_bar_us_datetime_is_monotonic_across_midnight(): bars = _us_minutes() dts = [b.datetime for b in bars] assert dts == sorted(dts) assert dts[0] == datetime(2026, 10, 22, 21, 30) assert dts[-1] == datetime(2026, 10, 23, 3, 59) def test_minute_bar_us_trading_date_spans_two_calendar_days(): """一个美股交易日的分时横跨两个北京自然日,trading_date 必须都是同一天。""" bars = _us_minutes() tds = {b.trading_date for b in bars} assert tds == {"2026-10-22"} # 而 datetime.date() 会给出两天 —— 这正是不能用它的原因 assert len({b.datetime.date() for b in bars}) == 2 def test_minute_bar_cn_unchanged(): """A股/港股分时 hour 本就合法,归一化必须零行为变化。""" from pytdxdata.models import MinuteBar for hour, minute in ((9, 30), (11, 29), (13, 0), (14, 59)): b = MinuteBar(price=10.0, vol=1.0, hour=hour, minute=minute, market=1, code="600000", date=20261022) assert (b.hour, b.minute) == (hour, minute) assert b.day_offset == 0 assert b.datetime == datetime(2026, 10, 22, hour, minute) assert b.trading_date == "2026-10-22" def test_minute_bar_cn_datetime_monotonic_full_session(): """A股全天 240 条(09:30~11:29 + 13:00~14:59)时间轴严格递增。""" from pytdxdata.models import MinuteBar bars = [] for idx in range(240): if idx < 120: hour, minute = 9 + (30 + idx) // 60, (30 + idx) % 60 else: hour, minute = 13 + (idx - 120) // 60, (idx - 120) % 60 bars.append(MinuteBar(price=10.0, vol=1.0, hour=hour, minute=minute, market=1, code="600000", date=20261022)) dts = [b.datetime for b in bars] assert dts == sorted(dts) assert dts[0] == datetime(2026, 10, 22, 9, 30) assert dts[-1] == datetime(2026, 10, 22, 14, 59) assert {b.trading_date for b in bars} == {"2026-10-22"}