easy-tdx 1.0.0__tar.gz

easy_tdx-1.0.0/.claude/settings.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python scripts/ruff_hook.py",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}

easy_tdx-1.0.0/.claude/settings.local.json

@@ -0,0 +1,25 @@
+{
+  "permissions": {
+    "allow": [
+      "Skill(update-config)",
+      "Bash(echo '{\"tool_name\":\"Edit\",\"tool_input\":{\"file_path\":\"D:\\\\\\\\python\\\\\\\\xmtdx\\\\\\\\src\\\\\\\\xmtdx\\\\\\\\__init__.py\"}}')",
+      "Bash(python -c \"import sys,json,subprocess;d=json.load\\(sys.stdin\\);f=d.get\\('tool_input',{}\\).get\\('file_path',''\\);exec\\('' if not f.endswith\\(\\\\\\\\'.py\\\\\\\\'\\) else 'subprocess.run\\([\\\\\\\\'ruff\\\\\\\\',\\\\\\\\'check\\\\\\\\',\\\\\\\\'--fix\\\\\\\\',f],capture_output=True\\);subprocess.run\\([\\\\\\\\'ruff\\\\\\\\',\\\\\\\\'format\\\\\\\\',f],capture_output=True\\)'\\);print\\(f'done: {f}'\\)\")",
+      "Bash(python *)",
+      "Bash(ruff check *)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Bash(git push *)",
+      "mcp__zread__get_repo_structure",
+      "Bash(pip install *)",
+      "mcp__web-reader__webReader",
+      "Bash(python3 *)",
+      "Bash(where mypy *)",
+      "Bash(pip list *)",
+      "Bash(uv run *)",
+      "Bash(git stash *)",
+      "Bash(dir /s /b src\\\\xmtdx)",
+      "Bash(git remote *)",
+      "Bash(Select-Object -Last 5)"
+    ]
+  }
+}

easy_tdx-1.0.0/.claude/skills/verify/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: verify
+description: Run full offline verification suite (pytest unit tests + mypy + ruff) before committing changes.
+disable-model-invocation: true
+---
+
+# Verify
+
+Run the full offline verification pipeline:
+
+1. Run `python -m pytest tests/unit/ -v` — all unit tests must pass.
+2. Run `mypy src/` — strict type checking must pass with zero errors.
+3. Run `ruff check src/ tests/` — no lint errors.
+4. Run `ruff format --check src/ tests/` — formatting must be clean.
+
+If any step fails, fix the issues and re-run. Do not report completion until all four steps pass.

easy_tdx-1.0.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+*.egg
+.venv/
+venv/

easy_tdx-1.0.0/.omc/project-memory.json

@@ -0,0 +1,161 @@
+{
+  "version": "1.0.0",
+  "lastScanned": 1779424107452,
+  "projectRoot": "D:\\python\\easty_tdx",
+  "techStack": {
+    "languages": [
+      {
+        "name": "Python",
+        "version": null,
+        "confidence": "high",
+        "markers": [
+          "pyproject.toml"
+        ]
+      }
+    ],
+    "frameworks": [
+      {
+        "name": "pytest",
+        "version": null,
+        "category": "testing"
+      }
+    ],
+    "packageManager": null,
+    "runtime": null
+  },
+  "build": {
+    "buildCommand": null,
+    "testCommand": "pytest",
+    "lintCommand": "ruff check",
+    "devCommand": null,
+    "scripts": {}
+  },
+  "conventions": {
+    "namingStyle": null,
+    "importStyle": null,
+    "testPattern": null,
+    "fileOrganization": null
+  },
+  "structure": {
+    "isMonorepo": false,
+    "workspaces": [],
+    "mainDirectories": [
+      "docs",
+      "examples",
+      "scripts",
+      "src",
+      "tests"
+    ],
+    "gitBranches": {
+      "defaultBranch": "main",
+      "branchingStrategy": null
+    }
+  },
+  "customNotes": [],
+  "directoryMap": {
+    "docs": {
+      "path": "docs",
+      "purpose": "Documentation",
+      "fileCount": 2,
+      "lastAccessed": 1779424107425,
+      "keyFiles": [
+        "api_reference.md",
+        "field_mapping.md"
+      ]
+    },
+    "examples": {
+      "path": "examples",
+      "purpose": "Example code",
+      "fileCount": 0,
+      "lastAccessed": 1779424107425,
+      "keyFiles": []
+    },
+    "scripts": {
+      "path": "scripts",
+      "purpose": "Build/utility scripts",
+      "fileCount": 4,
+      "lastAccessed": 1779424107426,
+      "keyFiles": [
+        "probe_unknowns.py",
+        "ruff_hook.py",
+        "verify_fixes_20260415.py",
+        "__init__.py"
+      ]
+    },
+    "src": {
+      "path": "src",
+      "purpose": "Source code",
+      "fileCount": 0,
+      "lastAccessed": 1779424107427,
+      "keyFiles": []
+    },
+    "tests": {
+      "path": "tests",
+      "purpose": "Test files",
+      "fileCount": 1,
+      "lastAccessed": 1779424107427,
+      "keyFiles": [
+        "__init__.py"
+      ]
+    },
+    "venv": {
+      "path": "venv",
+      "purpose": null,
+      "fileCount": 2,
+      "lastAccessed": 1779424107428,
+      "keyFiles": [
+        "pyvenv.cfg"
+      ]
+    },
+    "tests\\fixtures": {
+      "path": "tests\\fixtures",
+      "purpose": "Test fixtures",
+      "fileCount": 24,
+      "lastAccessed": 1779424107429,
+      "keyFiles": [
+        "company_info_category.hex",
+        "company_info_category.json",
+        "company_info_content.hex"
+      ]
+    },
+    "venv\\Lib": {
+      "path": "venv\\Lib",
+      "purpose": "Library code",
+      "fileCount": 0,
+      "lastAccessed": 1779424107430,
+      "keyFiles": []
+    },
+    "venv\\Scripts": {
+      "path": "venv\\Scripts",
+      "purpose": "Build/utility scripts",
+      "fileCount": 10,
+      "lastAccessed": 1779424107430,
+      "keyFiles": [
+        "activate",
+        "activate.bat",
+        "activate.fish"
+      ]
+    }
+  },
+  "hotPaths": [
+    {
+      "path": "pyproject.toml",
+      "accessCount": 2,
+      "lastAccessed": 1779424332759,
+      "type": "file"
+    },
+    {
+      "path": "LICENSE",
+      "accessCount": 1,
+      "lastAccessed": 1779424203577,
+      "type": "file"
+    },
+    {
+      "path": "README.md",
+      "accessCount": 1,
+      "lastAccessed": 1779424203662,
+      "type": "file"
+    }
+  ],
+  "userDirectives": []
+}

easy_tdx-1.0.0/.omc/sessions/1c05c4c7-0987-444f-b329-e1c772d1a048.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "1c05c4c7-0987-444f-b329-e1c772d1a048",
+  "ended_at": "2026-05-21T17:01:21.757Z",
+  "reason": "prompt_input_exit",
+  "agents_spawned": 0,
+  "agents_completed": 0,
+  "modes_used": []
+}

easy_tdx-1.0.0/.omc/sessions/718ffd08-a67f-463d-ae5b-dea1d6703fc8.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "718ffd08-a67f-463d-ae5b-dea1d6703fc8",
+  "ended_at": "2026-05-21T04:31:14.583Z",
+  "reason": "clear",
+  "agents_spawned": 0,
+  "agents_completed": 0,
+  "modes_used": []
+}

easy_tdx-1.0.0/.omc/sessions/84b721c5-06e3-4191-ae03-5f4795cf33f3.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "84b721c5-06e3-4191-ae03-5f4795cf33f3",
+  "ended_at": "2026-05-22T03:33:15.228Z",
+  "reason": "prompt_input_exit",
+  "agents_spawned": 0,
+  "agents_completed": 0,
+  "modes_used": []
+}

easy_tdx-1.0.0/.omc/sessions/8e49af4a-ddee-483a-92bb-550dbb3cc506.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "8e49af4a-ddee-483a-92bb-550dbb3cc506",
+  "ended_at": "2026-05-21T04:31:59.748Z",
+  "reason": "prompt_input_exit",
+  "agents_spawned": 0,
+  "agents_completed": 0,
+  "modes_used": []
+}

easy_tdx-1.0.0/.omc/sessions/a3ab4095-2313-431e-be46-a80ffa727e66.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "a3ab4095-2313-431e-be46-a80ffa727e66",
+  "ended_at": "2026-05-21T17:15:43.971Z",
+  "reason": "prompt_input_exit",
+  "agents_spawned": 0,
+  "agents_completed": 0,
+  "modes_used": []
+}

easy_tdx-1.0.0/.omc/state/checkpoints/checkpoint-2026-05-21T18-43-39-867Z.json

@@ -0,0 +1,16 @@
+{
+  "created_at": "2026-05-21T18:43:39.866Z",
+  "trigger": "manual",
+  "active_modes": {},
+  "todo_summary": {
+    "pending": 0,
+    "in_progress": 0,
+    "completed": 0
+  },
+  "wisdom_exported": false,
+  "background_jobs": {
+    "active": [],
+    "recent": [],
+    "stats": null
+  }
+}

easy_tdx-1.0.0/.omc/state/checkpoints/checkpoint-2026-05-21T19-44-09-192Z.json

@@ -0,0 +1,16 @@
+{
+  "created_at": "2026-05-21T19:44:09.191Z",
+  "trigger": "manual",
+  "active_modes": {},
+  "todo_summary": {
+    "pending": 0,
+    "in_progress": 0,
+    "completed": 0
+  },
+  "wisdom_exported": false,
+  "background_jobs": {
+    "active": [],
+    "recent": [],
+    "stats": null
+  }
+}

easy_tdx-1.0.0/.omc/state/hud-stdin-cache.json

@@ -0,0 +1 @@
+{"session_id":"5cd5ba61-645e-434d-8bac-a6d106a4b5fe","transcript_path":"C:\\Users\\毛利哥\\.claude\\projects\\D--python-easty-tdx\\5cd5ba61-645e-434d-8bac-a6d106a4b5fe.jsonl","cwd":"D:\\python\\easty_tdx","effort":{"level":"medium"},"model":{"id":"glm-5.1","display_name":"glm-5.1"},"workspace":{"current_dir":"D:\\python\\easty_tdx","project_dir":"D:\\python\\easty_tdx","added_dirs":[],"repo":{"host":"github.com","owner":"handsomejustin","name":"easy_tdx"}},"version":"2.1.145","output_style":{"name":"default"},"cost":{"total_cost_usd":0.36701300000000003,"total_duration_ms":283709,"total_api_duration_ms":88737,"total_lines_added":24,"total_lines_removed":0},"context_window":{"total_input_tokens":30175,"total_output_tokens":22,"context_window_size":200000,"current_usage":{"input_tokens":223,"output_tokens":22,"cache_creation_input_tokens":0,"cache_read_input_tokens":29952},"used_percentage":15,"remaining_percentage":85},"exceeds_200k_tokens":false,"fast_mode":false,"thinking":{"enabled":true}}

easy_tdx-1.0.0/.omc/state/last-tool-error.json

@@ -0,0 +1,7 @@
+{
+  "tool_name": "Bash",
+  "tool_input_preview": "{\"command\":\"pip install build twine 2>&1 | Select-Object -Last 5\",\"description\":\"Install build and twine\"}",
+  "error": "Exit code 127\n/usr/bin/bash: line 1: Select-Object: command not found",
+  "timestamp": "2026-05-22T04:32:32.312Z",
+  "retry_count": 1
+}

easy_tdx-1.0.0/.omc/state/sessions/1c05c4c7-0987-444f-b329-e1c772d1a048/hud-state.json

@@ -0,0 +1,6 @@
+{
+  "timestamp": "2026-05-21T04:37:36.738Z",
+  "backgroundTasks": [],
+  "sessionStartTimestamp": "2026-05-21T04:35:51.188Z",
+  "sessionId": "1c05c4c7-0987-444f-b329-e1c772d1a048"
+}

easy_tdx-1.0.0/.omc/state/sessions/4a6378cc-96bc-4f30-809a-a6b4c4243d5e/session-started.json

@@ -0,0 +1,6 @@
+{
+  "session_id": "4a6378cc-96bc-4f30-809a-a6b4c4243d5e",
+  "started_at": "2026-05-21T17:02:00.621Z",
+  "cwd": "D:\\python\\easty_tdx",
+  "pid": 13160
+}

easy_tdx-1.0.0/.omc/state/sessions/5cd5ba61-645e-434d-8bac-a6d106a4b5fe/hud-state.json

@@ -0,0 +1,6 @@
+{
+  "timestamp": "2026-05-22T04:28:50.834Z",
+  "backgroundTasks": [],
+  "sessionStartTimestamp": "2026-05-22T04:28:27.433Z",
+  "sessionId": "5cd5ba61-645e-434d-8bac-a6d106a4b5fe"
+}

easy_tdx-1.0.0/.omc/state/sessions/5cd5ba61-645e-434d-8bac-a6d106a4b5fe/session-started.json

@@ -0,0 +1,6 @@
+{
+  "session_id": "5cd5ba61-645e-434d-8bac-a6d106a4b5fe",
+  "started_at": "2026-05-22T04:28:27.408Z",
+  "cwd": "D:\\python\\easty_tdx",
+  "pid": 36228
+}

easy_tdx-1.0.0/.omc/state/sessions/718ffd08-a67f-463d-ae5b-dea1d6703fc8/hud-state.json

@@ -0,0 +1,6 @@
+{
+  "timestamp": "2026-05-21T04:21:33.768Z",
+  "backgroundTasks": [],
+  "sessionStartTimestamp": "2026-05-21T04:21:11.890Z",
+  "sessionId": "718ffd08-a67f-463d-ae5b-dea1d6703fc8"
+}

easy_tdx-1.0.0/.omc/state/sessions/84b721c5-06e3-4191-ae03-5f4795cf33f3/hud-state.json

@@ -0,0 +1,6 @@
+{
+  "timestamp": "2026-05-21T17:33:21.608Z",
+  "backgroundTasks": [],
+  "sessionStartTimestamp": "2026-05-21T17:30:31.097Z",
+  "sessionId": "84b721c5-06e3-4191-ae03-5f4795cf33f3"
+}

easy_tdx-1.0.0/.omc/state/sessions/8e49af4a-ddee-483a-92bb-550dbb3cc506/hud-state.json

@@ -0,0 +1,6 @@
+{
+  "timestamp": "2026-05-21T04:31:15.192Z",
+  "backgroundTasks": [],
+  "sessionStartTimestamp": "2026-05-21T04:31:14.919Z",
+  "sessionId": "8e49af4a-ddee-483a-92bb-550dbb3cc506"
+}

easy_tdx-1.0.0/.omc/state/sessions/a3ab4095-2313-431e-be46-a80ffa727e66/hud-state.json

@@ -0,0 +1,6 @@
+{
+  "timestamp": "2026-05-21T17:07:49.338Z",
+  "backgroundTasks": [],
+  "sessionStartTimestamp": "2026-05-21T17:07:32.750Z",
+  "sessionId": "a3ab4095-2313-431e-be46-a80ffa727e66"
+}

easy_tdx-1.0.0/CLAUDE.md

@@ -0,0 +1,55 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build / Test / Lint
+
+```bash
+# 单元测试（无需网络，使用 tests/fixtures/ 中的 hex 数据）
+python -m pytest tests/unit/ -v
+
+# 集成测试（需要网络，默认跳过）
+XMTDX_LIVE=1 python -m pytest tests/integration/ -v
+
+# 类型检查（strict mypy）
+mypy src/
+
+# lint + format
+ruff check src/ tests/
+ruff format --check src/ tests/
+```
+
+## 架构
+
+```
+src/easy_tdx/
+├── client.py          # TdxClient / AsyncTdxClient（高层 API）
+├── transport/
+│   ├── sync.py        # TdxConnection（socket）+ ping_host / ping_all
+│   └── async_.py      # AsyncTdxConnection（asyncio）
+├── commands/          # 每条命令：build_request() + parse_response()，无 IO
+├── codec/             # price / volume / datetime / frame 编解码
+└── models/            # 纯 dataclass，无业务逻辑
+```
+
+commands 层不依赖 transport，可独立单测。修改 codec 或 commands 时不需要网络。
+
+## 协议编解码注意事项
+
+- **价格编码**：变长有符号整数（类 LEB128），bit8=继续，bit7=符号。差分编码（相邻 tick 存 delta）。
+- **成交量编码**：4 字节自定义浮点（`_decode_volume`），字节 3=指数，字节 0-2=精度。**不可用于价格字段**。
+- **握手**：连接后必须顺序发送 3 条 setup 命令，响应丢弃。
+- **帧格式**：16 字节响应头，body 按需 zlib 解压。
+- 新增编解码逻辑时务必在 `tests/fixtures/` 中补充 hex fixture 并编写对应的离线解析测试。
+
+## 已知限制
+
+- `Market.BJ` 的 `get_security_list()` 不能稳定获取（服务器端问题），不要尝试依赖它。
+- `limit_up` / `limit_down` 在 `SecurityQuote` 中默认为 `None`，涨跌停价应通过 `get_price_limits()` 或 `compute_price_limits()` 计算。
+
+## 代码风格
+
+- ruff: line-length 100, target py310, rules: E/F/I/UP
+- mypy strict mode
+- 所有 `get_*` 公开方法返回 `pd.DataFrame`（通过 `_df._to_df()` 转换）。内部方法仍使用 dataclass 列表。
+- 依赖：pandas（>=2.0）、tzdata（>=2024.1）。

easy_tdx-1.0.0/LICENSE

@@ -0,0 +1,34 @@
+MIT License
+
+Copyright (c) 2025-present easy-tdx contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This project contains code inspired by or derived from the following projects,
+each originally released under the MIT License:
+
+1. pytdx — https://github.com/rainx/pytdx
+   Copyright (c) rainx and contributors
+   Licensed under the MIT License.
+
+2. xmtdx — https://github.com/minionszyw/xmtdx
+   Copyright (c) minionszyw and contributors
+   Licensed under the MIT License.

easy_tdx-1.0.0/NOTICE

@@ -0,0 +1,24 @@
+easy-tdx
+========
+
+This project is an independent implementation of the TongDaXin (TDX)
+TCP protocol client for Chinese A-share market data.
+
+Attribution
+-----------
+
+This project was inspired by and incorporates ideas from:
+
+- pytdx (https://github.com/rainx/pytdx)
+  The offline data reading module (daily bars, minute bars, block data,
+  gbbq share structure changes, historical financial data) borrows file
+  format parsing methods from pytdx. The gbbq XOR decryption key is
+  directly ported from pytdx.
+
+- xmtdx (https://github.com/minionszyw/xmtdx)
+  The initial project structure and online protocol implementation were
+  based on xmtdx, which has since been substantially rewritten with bug
+  fixes, new features, and a different architecture.
+
+Both upstream projects are licensed under the MIT License.
+Their original copyright notices are preserved in the LICENSE file.