quantdb-sdk 0.1.1__tar.gz → 0.1.3__tar.gz

quantdb_sdk-0.1.3/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+所有 notable 变更都会记录在此文件。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
+版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
+
+## [0.1.3] - 2026-07-25
+
+### Changed
+- **User-Agent 统一规范**：同步同步客户端 (`client.py`) 与异步客户端 (`async_client.py`) 的 `User-Agent` 标头为 `QuantDB-Python-SDK/0.1.3`，提升服务端请求追踪与日志分流精度。
+- **服务端 Redis 集中式缓存兼容**：完全兼容服务端网关新上线的 Redis 集中缓存层（自动接收 `X-Cache-Hit` 响应标头）。
+
+## [0.1.2] - 2026-07-25
+
+### Added
+- **CLI 入口**：`[project.scripts]` 注册 `quantdb` 命令，装包后可直接 `quantdb --help` / `quantdb check <key>`，等价于 `python -m quantdb_sdk`。修复了 0.1.0/0.1.1 README 中 `python -m quantdb`（用连字符）会报 `No module named quantdb` 的问题。
+- `CHANGELOG.md` 与 `LICENSE`（MIT）文本随仓库发布。
+- `pyproject.toml` 新增 `Changelog` 项目 URL。
+
+### Notes
+- 0.1.2 严格向后兼容 0.1.1，仅元数据层面的修补，不改任何运行时行为。
+- 若 0.1.1 已经在生产环境运行，可选升级；不升级也不受影响。
+
+## [0.1.1] - 2026-07-25
+
+### Fixed
+- **关键 packaging bug**：`pyarrow` 未声明在 `pyproject.toml` 的运行时依赖，但 `client.py:482` 与 `async_client.py:413` 调用了 `pd.read_parquet(io.BytesIO(...))`。
+- **影响**：任何 `pip install quantdb-sdk==0.1.0` 的用户，在首次调用 `query_kline` / `query_tick` / `query_financial` 等下载类接口时会抛 `ImportError: Missing optional dependency 'pyarrow'`。只有 `get_usage` / `query_stock_list` 等非 parquet 接口 OOTB 可用。
+- **修复**：在 `dependencies` 加入 `pyarrow>=10.0.0`。
+- **服务端 User-Agent** 同步从 `0.1.0` 升级到 `0.1.1`，便于服务端按版本做调用归因与问题分流。
+
+## [0.1.0] - 2026-07-22
+
+### Added
+- 初版发布。
+- `QuantDBClient` 同步客户端（基于 `requests`）。
+- `AsyncQuantDBClient` 异步客户端（基于 `httpx`）。
+- `DuckDBWarehouse` 本地仓库管理：自动下载 Parquet → 注册 DuckDB 视图 → 跨表 SQL 查询。
+- 异常体系：`QuantDBError` / `AuthError` / `RateLimitError` / `InsufficientTrafficError` / `NotFoundError` / `ServerError` / `ValidationError`。
+- 覆盖接口：流量查询、用户信息、API Key 管理、订阅与订单、股票列表、交易日历、K 线、Tick、财务、按日分片分钟线。
+- `py.typed` 标记（PEP 561），第三方库可获得完整类型信息。

quantdb_sdk-0.1.3/LICENSE

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

quantdb_sdk-0.1.3/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include pyproject.toml
+recursive-include quantdb_sdk *.py *.typed

{quantdb_sdk-0.1.1/quantdb_sdk.egg-info → quantdb_sdk-0.1.3}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: quantdb-sdk
-Version: 0.1.1
+Version: 0.1.3
 Summary: QuantDB 量化数据平台官方 Python SDK
 Author: QuantDB Team
 License: MIT
 Project-URL: Homepage, https://www.quantmindai.cn
 Project-URL: Documentation, https://www.quantmindai.cn/docs/sdk.html
 Project-URL: Repository, https://github.com/quantdb/quantdb
+Project-URL: Changelog, https://github.com/quantdb/quantdb/blob/main/CHANGELOG.md
 Keywords: quant,finance,data,a-share,parquet
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -21,6 +22,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Office/Business :: Financial
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: requests>=2.25.0
 Requires-Dist: pandas>=1.3.0
 Requires-Dist: httpx>=0.24.0
@@ -31,6 +33,7 @@ Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: responses>=0.23.0; extra == "dev"
 Requires-Dist: respx>=0.20.0; extra == "dev"
+Dynamic: license-file
 
 # QuantDB Python SDK
 

{quantdb_sdk-0.1.1 → quantdb_sdk-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "quantdb-sdk"
-version = "0.1.1"
+version = "0.1.3"
 description = "QuantDB 量化数据平台官方 Python SDK"
 readme = "README.md"
 license = {text = "MIT"}
@@ -37,6 +37,13 @@ dependencies = [
     "pyarrow>=10.0.0",
 ]
 
+# 0.1.2 新增：装包后提供 `quantdb` shell 命令，等价于 `python -m quantdb_sdk`。
+# 0.1.0/0.1.1 README 写的是 `python -m quantdb`（用了 PyPI 名带连字符），
+# 但 Python 模块名是下划线，安装后 `python -m quantdb` 会报 No module named quantdb。
+# 加这个 entry point 后两个名字都能用，README 不需要再改。
+[project.scripts]
+quantdb = "quantdb_sdk.__main__:main"
+
 [project.optional-dependencies]
 dev = [
     "pytest>=7.0.0",
@@ -49,7 +56,12 @@ dev = [
 Homepage = "https://www.quantmindai.cn"
 Documentation = "https://www.quantmindai.cn/docs/sdk.html"
 Repository = "https://github.com/quantdb/quantdb"
+Changelog = "https://github.com/quantdb/quantdb/blob/main/CHANGELOG.md"
 
 [tool.setuptools.packages.find]
 where = ["."]
 include = ["quantdb_sdk*"]
+
+# 0.1.2 新增：让 wheel 包含 LICENSE 和 CHANGELOG.md
+[tool.setuptools.package-data]
+quantdb_sdk = ["py.typed"]

{quantdb_sdk-0.1.1 → quantdb_sdk-0.1.3}/quantdb_sdk/async_client.py

@@ -35,7 +35,7 @@ class AsyncQuantDBClient:
     ):
         self.api_host = api_host.rstrip("/")
         self.timeout = timeout
-        headers = {"User-Agent": "QuantDB-Python-SDK/0.1.0"}
+        headers = {"User-Agent": "QuantDB-Python-SDK/0.1.3"}
         if api_key:
             headers["X-API-Key"] = api_key
         elif token: