Metadata-Version: 2.4
Name: ffdata
Version: 0.2.7
Summary: ffdata lightweight Python client for governed financial-data APIs
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.28.0
Requires-Dist: pandas>=3.0.5
Requires-Dist: polars>=1.43.2
Requires-Dist: pyarrow>=21.0.0
Requires-Dist: pydantic>=2.11.0

# ffdata

`ffdata` 是面向量化研究的轻量 Python 客户端。它只通过 HTTP 调用已部署的
ffdata 数据服务，不包含服务端、JYDB SQL、数据库配置或后台管理实现。

完整的客户端职责说明见 [客户端模块说明](../docs/模块说明/客户端.md)；安装、构建和升级见
[客户端打包与交付](../docs/部署与运维/客户端打包与交付.md)；每个对外 API 的可运行案例见
[使用案例](examples/README.md)。

## 配置服务地址与 Token

安装客户端 wheel 后运行：

```bash
source "$(dirname "$(command -v ffdata)")/configure_ffdata.sh"
```

脚本会交互式设置 `FFDATA_BASE_URL` 与 `FFDATA_TOKEN`，Token 输入不回显，并将两者写入
`~/.bash_profile`（仅当前用户可读）。因此新的 Bash 终端及其他项目都能直接读取配置；若当前使用
的是 zsh 等其他 shell，可执行 `source ~/.bash_profile` 加载。
