mirror of
https://ghfast.top/https://github.com/aeroxw/easy_tdx_max.git
synced 2026-09-12 15:44:18 +08:00
GitHub
5a3ad15477
Web 获取 K 线此前用 AsyncTdxClient.get_security_bars（标准协议不支持复权），
导致 REST API 无法取前复权/后复权数据。将 /bars（个股 K 线）迁移到
AsyncMacClient.get_stock_kline（MAC 协议，支持 NONE/QFQ/HFQ + QFQ 负价兜底），
保持旧输出契约不变（日线 date 列、分钟线 datetime 列、OHLC 顺序、无 float_shares），
新增 adjust 参数（默认 QFQ），MAC 主机不可用时自动回退标准 TdxClient。
⚠️ 半破坏性变更：/bars 默认复权从"不复权"改为 QFQ（前复权）。老调用方若需
不复权请显式传 ?adjust=NONE。输出 DataFrame 列名/顺序/字段与旧版完全一致
（_normalize_mac_df 规整），仅价格数值因复权变化。
改动：
- bars.py：/bars 改走 mac_client.get_stock_kline(adjust=...)，MAC 不可用回退
get_security_bars（无复权 + warning）；新增 _normalize_mac_df 规整输出契约；
新增 adjust 查询参数（默认 QFQ）。
- convert.py：period_times_from_category（KlineCategory→Period 映射，显式处理
YEAR 9→YEARLY 11、SEASON→QUARTERLY）+ adjust_from_str。
- deps.py：get_mac_client_optional（未连接返回 None，供回退判断）。
- schemas.py：AdjustEnum（OpenAPI 文档用）。
测试：新增 7 个（period_times 映射全表 + 不可映射值、adjust 转换、_normalize_mac_df
日线/分钟线/空 df）。全套 996 passed；ruff format/check + mypy 改动文件零错误。
不在本次范围：/bars/index（指数 K 线，MAC 另一套接口）、/minute、/transaction*
（MacClient tick_chart 语义不同，暂不迁移）。
86 lines
2.7 KiB
TOML
86 lines
2.7 KiB
TOML
[build-system]
|
||
requires = ["hatchling"]
|
||
build-backend = "hatchling.build"
|
||
|
||
[project]
|
||
name = "easy-tdx"
|
||
version = "1.20.6"
|
||
description = "通达信 TCP 协议行情数据客户端，支持在线行情、离线数据读取与写入同步"
|
||
readme = "README.md"
|
||
requires-python = ">=3.10"
|
||
dependencies = ["pandas>=2.0,<3", "tzdata>=2024.1", "click>=8.0,<9"]
|
||
|
||
[project.scripts]
|
||
easy-tdx = "easy_tdx.cli:cli" # cli/__init__.py exposes the click group
|
||
|
||
[project.optional-dependencies]
|
||
dev = ["pytest>=8.0", "pytest-asyncio>=0.23", "pytest-cov", "mypy>=1.9", "ruff>=0.4", "scipy>=1.10,<1.16", "httpx>=0.27"]
|
||
science = ["scipy>=1.10,<1.16"]
|
||
web = ["fastapi>=0.110,<1", "uvicorn[standard]>=0.29"]
|
||
# 打包成桌面 EXE 用：系统托盘（pystray）+ 图标生成（Pillow）。
|
||
# 仅 PyInstaller 打包态需要，开发态 ``pip install -e .[web]`` 不强制装。
|
||
packaging = ["pystray>=0.19", "Pillow>=10.0"]
|
||
|
||
[tool.hatch.build]
|
||
# 前端 dist 是构建产物（在 .gitignore 里），hatchling 默认不打包。
|
||
# artifacts 让它被 sdist 和 wheel 都强制包含。
|
||
artifacts = [
|
||
"web-ui/dist/",
|
||
]
|
||
|
||
[tool.hatch.build.targets.wheel]
|
||
packages = ["src/easy_tdx"]
|
||
# 前端 dist 映射到包内 easy_tdx/web/dist/。CI（ci.yml）、publish（publish.yml）
|
||
# 和 release（release.yml）都会在 pip install / build 前先 npm run build。
|
||
force-include = { "web-ui/dist" = "easy_tdx/web/dist" }
|
||
|
||
[tool.mypy]
|
||
strict = true
|
||
python_version = "3.12"
|
||
# 跳过未跟踪的本地脚本（依赖外部 unified_config/sqlalchemy/requests，不属于库）
|
||
exclude = ["src/easy_tdx/exchange_margin\\.py"]
|
||
|
||
[[tool.mypy.overrides]]
|
||
module = ["pandas", "tabulate", "matplotlib", "matplotlib.*"]
|
||
ignore_missing_imports = true
|
||
|
||
[[tool.mypy.overrides]]
|
||
module = "easy_tdx.MyTT"
|
||
# Type stubs provided via MyTT.pyi — keep strict checks enabled
|
||
|
||
[[tool.mypy.overrides]]
|
||
module = ["fastapi.*", "uvicorn.*", "pydantic.*"]
|
||
ignore_missing_imports = true
|
||
|
||
[[tool.mypy.overrides]]
|
||
# pystray / Pillow 无 type stubs；tray.py 已用 type: ignore 兜底关键调用
|
||
module = ["pystray", "pystray.*", "PIL", "PIL.*"]
|
||
ignore_missing_imports = true
|
||
|
||
[[tool.mypy.overrides]]
|
||
module = ["scipy", "scipy.*"]
|
||
ignore_missing_imports = true
|
||
|
||
[tool.ruff]
|
||
target-version = "py310"
|
||
line-length = 100
|
||
extend-exclude = ["*.pyi", "src/easy_tdx/exchange_margin.py"]
|
||
|
||
[tool.ruff.lint]
|
||
select = ["E", "F", "I", "UP"]
|
||
|
||
[tool.pytest.ini_options]
|
||
testpaths = ["tests"]
|
||
addopts = "--tb=short"
|
||
asyncio_mode = "auto"
|
||
|
||
[tool.coverage.run]
|
||
source = ["easy_tdx"]
|
||
omit = ["tests/*"]
|
||
|
||
[tool.coverage.report]
|
||
# 覆盖率门槛。从 50 提升到 60（审计 #9）：补充 reconnect/bitmap/config 测试后
|
||
# 实测约 61%。进一步提到 70 需补 web/ 路由与更多 client 镜像测试，留待后续。
|
||
fail_under = 60
|
||
show_missing = true
|