zsdtdx 0.1.0__tar.gz

zsdtdx-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sida
+
+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.

zsdtdx-0.1.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include LICENSE
+include THIRD_PARTY_NOTICES.md
+recursive-include src/zsdtdx *.yaml
+global-exclude __pycache__
+global-exclude *.py[cod]

zsdtdx-0.1.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: zsdtdx
+Version: 0.1.0
+Summary: Unified wrapper around pytdx-style market data APIs.
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas
+Requires-Dist: PyYAML
+Requires-Dist: six
+Requires-Dist: psutil
+Dynamic: license-file
+
+# zsdtdx
+
+`zsdtdx` 是一个面向 A 股/期货行情场景的 Python 封装库，基于 pytdx 体系做统一 API、连接池、重试与并行抓取增强，目标是提供更稳定的一致化数据接口。
+
+## 安装
+
+```bash
+pip install zsdtdx
+```
+
+## 快速开始
+
+```python
+import queue as py_queue
+from zsdtdx import StockKlineTask, get_client, get_stock_kline, get_stock_latest_price
+
+with get_client() as client:
+    prices = get_stock_latest_price(["600000", "000001"])
+
+    q = py_queue.Queue()
+    payloads = get_stock_kline(
+        task=[
+            StockKlineTask(code="600000", freq="d", start_time="2026-02-01", end_time="2026-02-14"),
+            {"code": "000001", "freq": "60", "start_time": "2026-02-01", "end_time": "2026-02-14"},
+        ],
+        queue=q,
+        mode="sync",
+    )
+
+    print(prices)
+    print(len(payloads))
+```
+
+## 配置说明
+
+- 默认情况下，`get_client()` 会读取包内置的 `config.yaml`。
+- 你可以按需传入自定义配置路径：
+
+```python
+from zsdtdx import get_client
+
+with get_client(config_path=r"D:\\configs\\zsdtdx.yaml") as client:
+    ...
+```
+
+- 时间窗口按左闭右开 `[start_time, end_time)` 解释。
+- `get_stock_kline` 只接受 `task` 列表输入（`StockKlineTask` 或 `dict`）。
+
+## API 概览
+
+- `get_client`
+- `get_supported_markets`
+- `get_stock_code_name`
+- `get_all_future_list`
+- `get_stock_kline`
+- `get_future_kline`
+- `get_company_info`
+- `get_stock_latest_price`
+- `get_future_latest_price`
+- `get_runtime_failures`
+- `get_runtime_metadata`
+
+## 运行环境与依赖
+
+- Python: `>=3.10`
+- 依赖：`pandas`、`PyYAML`、`six`、`psutil`
+
+## 开发文档
+
+以下文档用于开发维护，不作为对外安装说明主文档：
+
+- `HANDOFF.md`
+- `PERFORMANCE_REPORT.md`
+- `examples/`
+
+## 许可证与来源
+
+- 本项目以 MIT 许可证发布，见 `LICENSE`。
+- 本项目基于 `pytdx` 生态进行改写与扩展，归属说明见 `THIRD_PARTY_NOTICES.md`。

zsdtdx-0.1.0/README.md

@@ -0,0 +1,79 @@
+# zsdtdx
+
+`zsdtdx` 是一个面向 A 股/期货行情场景的 Python 封装库，基于 pytdx 体系做统一 API、连接池、重试与并行抓取增强，目标是提供更稳定的一致化数据接口。
+
+## 安装
+
+```bash
+pip install zsdtdx
+```
+
+## 快速开始
+
+```python
+import queue as py_queue
+from zsdtdx import StockKlineTask, get_client, get_stock_kline, get_stock_latest_price
+
+with get_client() as client:
+    prices = get_stock_latest_price(["600000", "000001"])
+
+    q = py_queue.Queue()
+    payloads = get_stock_kline(
+        task=[
+            StockKlineTask(code="600000", freq="d", start_time="2026-02-01", end_time="2026-02-14"),
+            {"code": "000001", "freq": "60", "start_time": "2026-02-01", "end_time": "2026-02-14"},
+        ],
+        queue=q,
+        mode="sync",
+    )
+
+    print(prices)
+    print(len(payloads))
+```
+
+## 配置说明
+
+- 默认情况下，`get_client()` 会读取包内置的 `config.yaml`。
+- 你可以按需传入自定义配置路径：
+
+```python
+from zsdtdx import get_client
+
+with get_client(config_path=r"D:\\configs\\zsdtdx.yaml") as client:
+    ...
+```
+
+- 时间窗口按左闭右开 `[start_time, end_time)` 解释。
+- `get_stock_kline` 只接受 `task` 列表输入（`StockKlineTask` 或 `dict`）。
+
+## API 概览
+
+- `get_client`
+- `get_supported_markets`
+- `get_stock_code_name`
+- `get_all_future_list`
+- `get_stock_kline`
+- `get_future_kline`
+- `get_company_info`
+- `get_stock_latest_price`
+- `get_future_latest_price`
+- `get_runtime_failures`
+- `get_runtime_metadata`
+
+## 运行环境与依赖
+
+- Python: `>=3.10`
+- 依赖：`pandas`、`PyYAML`、`six`、`psutil`
+
+## 开发文档
+
+以下文档用于开发维护，不作为对外安装说明主文档：
+
+- `HANDOFF.md`
+- `PERFORMANCE_REPORT.md`
+- `examples/`
+
+## 许可证与来源
+
+- 本项目以 MIT 许可证发布，见 `LICENSE`。
+- 本项目基于 `pytdx` 生态进行改写与扩展，归属说明见 `THIRD_PARTY_NOTICES.md`。

zsdtdx-0.1.0/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,24 @@
+# Third-Party Notices
+
+This project (`zsdtdx`) is developed with reference to and partial adaptation of
+the upstream project:
+
+- Project: `pytdx`
+- Homepage: <https://github.com/rainx/pytdx>
+- PyPI: <https://pypi.org/project/pytdx/>
+
+## Attribution
+
+Portions of protocol parsing and API behavior are derived from or inspired by
+`pytdx`, with additional wrapper, retry, routing, batching, and parallel-fetch
+logic implemented in this project.
+
+## License Status Note
+
+During packaging preparation, the `pytdx` 1.72 source distribution metadata on
+PyPI reports `License: UNKNOWN`, and the source archive does not contain a
+standalone `LICENSE` file.
+
+Before public distribution, maintainers should verify the upstream license terms
+from the authoritative upstream repository and retain any required notices in
+this file.

zsdtdx-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zsdtdx"
+version = "0.1.0"
+description = "Unified wrapper around pytdx-style market data APIs."
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = [
+    "pandas",
+    "PyYAML",
+    "six",
+    "psutil",
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+]
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["zsdtdx*"]
+
+[tool.setuptools.package-data]
+zsdtdx = ["config.yaml"]

zsdtdx-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

zsdtdx-0.1.0/src/zsdtdx/__init__.py

@@ -0,0 +1,38 @@
+"""zsdtdx 对外导出入口。"""
+
+from zsdtdx.simple_api import (
+    StockKlineTask,
+    get_all_future_list,
+    get_client,
+    get_company_info,
+    get_future_kline,
+    get_future_latest_price,
+    get_runtime_failures,
+    get_runtime_metadata,
+    get_stock_code_name,
+    get_stock_kline,
+    get_stock_latest_price,
+    get_supported_markets,
+)
+from zsdtdx.parallel_fetcher import StockKlineJob
+from zsdtdx.wrapper.unified_client import UnifiedTdxClient
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "__version__",
+    "UnifiedTdxClient",
+    "StockKlineTask",
+    "StockKlineJob",
+    "get_client",
+    "get_supported_markets",
+    "get_stock_code_name",
+    "get_all_future_list",
+    "get_stock_kline",
+    "get_future_kline",
+    "get_company_info",
+    "get_stock_latest_price",
+    "get_future_latest_price",
+    "get_runtime_failures",
+    "get_runtime_metadata",
+]