"""交易日判断（首版仅周末判断，节假日后续扩展）。

TODO: 后续接入 A 股法定节假日列表（交易所日历数据源或手动配置文件）。
"""
from datetime import date


def is_trading_day(day: date | None = None) -> bool:
    """判断是否为 A 股交易日。

    首版：周一至周五 True，周六周日 False。
    法定节假日（国庆/春节/清明等）暂不处理——miniQMT broker 会自行拒绝，
    调用方可根据返回值在响应中加 warning 提示。

    Args:
        day: 待判断日期，None = 今天。

    Returns:
        True = 工作日（大概率交易日），False = 周末。
    """
    if day is None:
        day = date.today()
    # TODO: 接入 A 股法定节假日列表（目前仅排除周末）
    return day.weekday() < 5  # 0=Mon..4=Fri, 5=Sat, 6=Sun