【亲测免费】 MOOTDX 开源项目教程

1. 项目目录结构及介绍

MOOTDX 是一个基于 Python 的通达信(TDXT) 行情数据接口实现。其目录结构大致如下：

mootdx/
├── docs/          # 文档资料
├── src/           # 主要代码库
│   ├── mootdx/    # 项目的核心模块
│   │   ├── __init__.py
│   │   └── ...     # 其他子模块
│   ├── reader/     # 离线数据读取模块
│   ├── quotes/     # 实时行情模块
│   ├── affair/     # 财务数据模块
│   └── cli/        # 命令行工具
├── tests/         # 测试用例
├── setup.py       # 项目安装脚本
└── README.md      # 项目README

• docs/: 存放项目文档和在线帮助。
• src/: 项目的主要代码目录，包括各种功能模块。
• reader/: 提供对通达信本地离线数据的读取接口。
• quotes/: 用于获取实时的通达信行情数据。
• affair/: 提供财务报告数据相关操作。
• cli/: 包含命令行工具，便于调试和数据导出。
• tests/: 测试用例，确保代码功能正确性。
• setup.py: 用于构建和安装项目的Python脚本。

2. 项目的启动文件介绍

setup.py是项目的安装脚本，它定义了如何安装和配置MOOTDX。你可以通过执行以下命令来安装项目：

pip install -U git+https://github.com/mootdx/mootdx.git

或者在克隆项目到本地后使用：

pip install -U .

启动文件并不直接执行，而是通过pip或python setup.py install进行安装后，可以直接导入mootdx模块到Python环境中开始使用。

例如，下面是如何在Python中使用MOOTDX的示例：

from mootdx.reader import Reader
reader = Reader.factory(market='std', tdxdir='C:/new_tdx')
data = reader.daily(symbol='600036')

3. 项目的配置文件介绍

MOOTDX 并未采用单一的全局配置文件，而是通过代码参数来设置运行环境。例如，对于通达信数据目录（tdxdir）和服务器选择（如bestip），可以在初始化相应类实例时传入。

例如，如果你想指定通达信数据路径并使用最快服务器，可以这样做：

from mootdx.reader import Reader
from mootdx.quotes import Quotes

# 离线数据读取配置
reader = Reader.factory(market='std', tdxdir='C:/your/tdx/path')

# 线上行情读取配置
client = Quotes.factory(market='std', multithread=True, heartbeat=True, bestip=True)

某些特定功能，如数据存储位置或连接超时时限，可以通过在代码中直接设置相应的类属性来调整。如果需要更复杂的配置管理，可以根据项目需求自定义配置类，并在创建对象时传入实例。但请注意，这不算是MOOTDX的标准做法，需要开发者自行实现。