RustDX 项目使用教程

1. 项目介绍

RustDX 是一个受 pytdx 启发的 A 股数据获取工具，使用 Rust 语言编写。它包含两个主要组件：

• rustdx: 一个 Rust 通用库，用于获取和处理 A 股数据。
• rustdx-cmd: 一个命令行工具，提供便捷的数据获取和处理功能。

该项目的主要目标是提供一个高效、可靠的工具，用于获取和处理 A 股市场的历史和实时数据。

2. 项目快速启动

2.1 安装

你可以通过以下几种方式安装 rustdx-cmd：

2.1.1 下载已编译的 release 版本

从项目的 GitHub Releases 页面下载适合你操作系统的预编译二进制文件。

2.1.2 使用 Cargo 安装

如果你已经安装了 Rust 和 Cargo，可以通过以下命令安装 rustdx-cmd：

cargo install rustdx-cmd

2.1.3 从源码编译安装

1. 克隆项目仓库：

git clone https://github.com/zjp-CN/rustdx.git
cd rustdx

2. 编译并安装 rustdx-cmd：

cargo build -p rustdx-cmd --release
cargo install --path rustdx-cmd

2.2 使用示例

2.2.1 解析通达信 day 文件

rustdx day /path/to/tdx/sh/ /path/to/tdx/sz/ -l official -g /path/to/gbbq -t rustdx_factor

2.2.2 获取东方财富当日 A 股数据

rustdx east -p factor.csv -t rustdx_factor

3. 应用案例和最佳实践

3.1 历史数据补齐

假设你需要补齐某只股票的历史数据，可以使用以下步骤：

1. 解析历史数据并计算复权数据：

rustdx day /path/to/tdx/sh/ /path/to/tdx/sz/ -l official -g /path/to/gbbq -t rustdx_factor

2. 将解析后的数据插入到 ClickHouse 数据库：

clickhouse-client --query "INSERT INTO rustdx_factor FORMAT CSVWithNames" < stocks.csv

3.2 每日数据更新

在每个交易日收盘后，更新当天的数据：

rustdx east -p factor.csv -t rustdx_factor

4. 典型生态项目

4.1 ClickHouse

RustDX 支持将数据直接插入到 ClickHouse 数据库中，ClickHouse 是一个高性能的列式数据库，非常适合存储和查询大量的金融数据。

4.2 MongoDB

除了 ClickHouse，RustDX 也支持将数据插入到 MongoDB 中，MongoDB 是一个文档型数据库，适合存储结构化或半结构化的数据。

4.3 pytdx

pytdx 是一个用 Python 编写的 A 股数据获取工具，RustDX 在设计上受到了 pytdx 的启发，如果你已经熟悉 pytdx，可以很容易地迁移到 RustDX。

通过以上步骤，你可以快速上手并使用 RustDX 进行 A 股数据的获取和处理。