Metadata-Version: 2.4
Name: tdxgbbqckz
Version: 1.0.0
Summary: 通达信 gbbq（除权除息）文件读取器，核心解密由 C 扩展实现
Project-URL: Homepage, https://github.com/qiuxiaoying/tdxgbbqckz
Project-URL: Repository, https://github.com/qiuxiaoying/tdxgbbqckz
Project-URL: Release-notes, https://github.com/qiuxiaoying/tdxgbbqckz/releases/tag/v1.0.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: C
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: pandas>=0.24

# tdxgbbqckz

通达信 gbbq（除权除息）文件读取器，核心解密逻辑由 C 扩展实现。

## 特性

- Blowfish 变体解密在 C 扩展中完成，速度快
- `cp38-abi3` 稳定 ABI，一个 wheel 支持 Windows x64 上的 CPython 3.8–3.13
- 附带 `.pyi` 类型存根与 `py.typed` 标记（PEP 561）

## 安装

```
pip install tdxgbbqckz
```

Windows x64 + CPython >= 3.8 直接安装预编译 wheel；其他平台会从 sdist 编译（需要 C 编译器）。

## 使用

```python
from tdxgbbqckz import GbbqReader

reader = GbbqReader()

# 返回 pandas DataFrame
df = reader.get_df("gbbq")

# 不依赖 pandas，返回元组列表
rows = reader.read_rows("gbbq")
```

每行字段：

| 字段 | 含义 |
| --- | --- |
| market | 市场 |
| code | 证券代码 |
| datetime | 日期 |
| category | 类别 |
| hongli_panqianliutong | 红利／盘前流通 |
| peigujia_qianzongguben | 配股价／前总股本 |
| songgu_qianzongguben | 送股／前总股本 |
| peigu_houzongguben | 配股／后总股本 |

## 仓库

<https://github.com/qiuxiaoying/tdxgbbqckz>
