mootdx 安装指南：三种 pip 安装方式、依赖分组选择与升级源码安装全解析

mootdx 安装指南三种 pip 安装方式、依赖分组选择与升级源码安装全解析【免费下载链接】mootdx通达信数据读取的一个简便使用封装项目地址: https://gitcode.com/GitHub_Trending/mo/mootdx本指南以 docs/setup.md 为骨架系统讲解 mootdx 通达信数据读取库的标准安装、[cli]命令行依赖安装、[all]全量扩展安装、版本升级以及源码安装四种方式并结合作品仓库的pyproject.toml、requirements.txt、CLI 入口与 Dockerfile 等实现细节说明不同安装方式背后的依赖差异与适用场景帮助你在 Windows / macOS / Linux 上正确部署 Python 3.8 环境并在安装完成后快速验证通达信行情、财务数据读取是否可用。安装前的环境准备在动手安装之前先确认运行环境是否满足 mootdx 的基本要求操作系统Windows / MacOS / Linux 均可运行Python 版本Python 3.8 及以上版本详见 README.md 的运行环境说明。仓库的 pyproject.toml 中同样将 Python 版本约束为python ^3.8并在classifiers中声明支持 Python 3.6 至 3.11而 requirements.txt 中各依赖均标注python_version 3.8 and python_version 4.0因此安装时建议使用 Python 3.8 的解释器以获得完整、稳定的依赖解析。mootdx 的运行时依赖主要包括httpxHTTP 客户端、tenacity重试机制、tdxpy通达信协议基础库、tqdm进度条、prettytable表格渲染、click命令行框架、typing-extensions以及mini-racerJavaScript 引擎绑定等这些依赖会随主包自动安装无需手动逐一处理。标准安装最小化核心依赖对于只需要在 Python 代码中调用 mootdx 的数据读取接口如Reader、Quotes、Affair不需要使用其内置命令行工具的场景直接安装核心包即可# 包含核心依赖安装 pip install -U mootdx这一方式会安装 mootdx 主包及其核心运行时依赖保证 mootdx/reader.py离线数据读取、mootdx/quotes.py在线行情读取、mootdx/affair.py财务数据等核心模块可以被正常导入使用。从源码结构看主包入口 mootdx/init.py 会加载config、consts服务器地址常量、server服务器管理等模块并在__init__.py中暴露__version__与__author__因此核心安装后即可在 Python 中执行import mootdx并读取mootdx.__version__验证安装。命令行依赖安装mootdx[cli]如果希望使用 mootdx 自带的命令行工具CLI例如mootdx quotes读取在线行情数据mootdx reader读取本地通达信数据mootdx bestip测试并挑选最优行情服务器mootdx affair财务文件下载与解析mootdx bundle批量下载行情数据并转存为 CSV、HDF5、Excel、JSON 等格式请使用带[cli]扩展标记的安装方式# 包含命令行依赖安装, 如果使用命令行工具可以使用这种方式安装 pip install -U mootdx[cli]CLI 入口定义在 mootdx/main.py其通过[tool.poetry.scripts]中的mootdx mootdx.__main__:entry见 pyproject.toml注册为可执行命令。__main__.py顶部会尝试导入click与prettytable两个库若缺少则会输出告警并退出try: import click from prettytable import PrettyTable except (ImportError, ModuleNotFoundError): logging.basicConfig(levellogging.WARNING) warnings.warn(!!! 缺少命令行依赖, 请使用次命令进行安装: pip install mootdx[cli], DeprecationWarning) logging.warning(!!! 缺少命令行依赖, 请使用次命令进行安装: pip install mootdx[cli]) exit(-1)这正是官方文档建议“如果使用命令行工具可以使用mootdx[cli]这种方式安装”的根本原因核心安装并不保证click、prettytable这两个 CLI 必需依赖的存在。仓库的 Dockerfile 也使用了RUN pip install mootdx[cli]来构建带命令行的镜像环境并紧接着执行RUN mootdx bestip -v验证 CLI 可用。安装完成后可通过以下命令验证 CLI 是否就绪mootdx --help mootdx --version python -m mootdx --help全量扩展安装mootdx[all]新手推荐如果你不确定自己需要哪些依赖或希望一次性获得完整功能包括命令行工具及其他扩展依赖官方文档推荐使用全量扩展安装# 包含所有扩展依赖安装, 如果不清楚各种依赖关系就用这个命令 pip install -U mootdx[all]新手建议使用pip install -U mootdx[all]安装 —— 该提示同时出现在 docs/setup.md 与 README.md 中。从依赖关系看[all]是「核心依赖 CLI 依赖 其他扩展依赖」的并集能够避免因缺少某个可选依赖而导致功能不可用。由于 pyproject.toml 中已将click、prettytable、tqdm等直接列入主依赖列表仓库当前版本实际上为所有安装方式都带上了这些常用库但对于不同版本、不同发布渠道的发行包[all]依然是覆盖面最广、最不易出错的选择。升级版本当需要将 mootdx 升级到最新版本时直接使用-U或--upgrade参数重新安装即可pip install -U mootdx升级后可以通过 Python 交互环境确认当前版本号import mootdx print(mootdx.__version__)当前仓库的版本号定义在 mootdx/init.py__version__ 0.11.7同时 mootdx/version.py 也提供了一个命令行打印版本号的便捷入口python -m mootdx.version源码安装不建议速度较慢如果希望直接基于 GitHub 仓库的最新代码进行安装例如体验尚未发布到 PyPI 的最新改动可以执行pip install githttps://github.com/mootdx/mootdx.git官方文档明确标注这种方式「不建议速度较慢」原因在于源码安装需要先git clone整个仓库再执行构建流程整体耗时明显高于从 PyPI 拉取预构建发行包仓库的构建后端为poetry-core见 pyproject.toml 的[build-system]源码安装会触发 Poetry 构建解析对网络与本地构建环境有一定要求。因此除非确有使用未发布代码的需求否则日常使用建议优先选择pip install mootdx[all]或pip install mootdx[cli]。安装后的快速验证完成安装后可以参照 docs/quick.md 的快速上手示例验证各功能模块是否正常工作1. 离线数据读取需要本机装有通达信客户端并指定数据目录from mootdx.reader import Reader # market: 参数 std 为标准市场(就是股票), ext 为扩展市场(期货黄金等) # tdxdir: 是通达信的数据目录, 根据自己的情况修改 reader Reader.factory(marketstd, tdxdirC:/new_tdx) # 读取日线数据 reader.daily(symbol600036) # 读取分钟数据 reader.minute(symbol600036) # 读取时间线数据 reader.fzline(symbol600036)2. 线上行情读取from mootdx.quotes import Quotes # 标准市场 client Quotes.factory(marketstd, multithreadTrue, heartbeatTrue, bestipTrue, timeout15) # k 线数据 client.bars(symbol600036, frequency9, offset10) # 指数 client.index(symbol000001, frequency9) # 分钟 client.minute(symbol000001)3. 财务数据读取from mootdx.affair import Affair # 远程文件列表 files Affair.files() # 下载单个 Affair.fetch(downdirtmp, filenamegpcw19960630.zip) # 下载全部 Affair.fetch(downdirtmp)以上示例分别对应离线数据mootdx/reader.py、在线行情mootdx/quotes.py与财务数据mootdx/affair.py三大核心功能均已在 README 与快速上手文档中作为官方用法给出安装完成后可依次执行以确认依赖完整、数据通路正常。常见安装问题1. 执行mootdx命令提示缺少命令行依赖如果以核心方式pip install mootdx安装后直接运行mootdx命令mootdx/main.py 会在缺少click或prettytable时输出类似!!! 缺少命令行依赖, 请使用次命令进行安装: pip install mootdx[cli]的告警并退出。解决方案是补装 CLI 依赖pip install -U mootdx[cli]2. 环境冲突或依赖版本不兼容mootdx 依赖httpx、tdxpy、tenacity、mini-racer等多个库见 requirements.txt 中的版本锁定如tdxpy0.2.6、httpx0.25.0。若与既有项目存在版本冲突建议使用虚拟环境如venv、conda隔离安装或直接采用mootdx[all]让 pip 统一解析依赖版本。3. M1 Mac 上 PyMiniRacer 不可用README 的常见问题一节提到 M1 Mac 系统上 PyMiniRacer 可能无法使用此问题与mini-racer依赖在 Apple Silicon 平台上的二进制兼容性有关。若遇到该问题可关注mini-racer上游的修复版本或考虑使用 x86_64 兼容环境运行。总结如何选择安装方式安装方式命令适用场景标准安装pip install -U mootdx仅用 Python API 读取数据不需要命令行工具命令行安装pip install -U mootdx[cli]需要使用mootdx quotes/reader/bestip/affair/bundle等 CLI 命令全量安装pip install -U mootdx[all]新手或不清楚依赖关系希望一次装全升级pip install -U mootdx将已安装版本升级到最新源码安装pip install githttps://github.com/mootdx/mootdx.git需要体验仓库最新未发布代码速度较慢不建议常规使用对于绝大多数使用者直接执行pip install -U mootdx[all]是最稳妥的选择日常仅做数据读取的开发者可以选用pip install -U mootdx保持环境精简而需要命令行批量操作行情的用户则务必通过pip install -U mootdx[cli]安装避免出现 CLI 入口因缺少click、prettytable而无法运行的问题。【免费下载链接】mootdx通达信数据读取的一个简便使用封装项目地址: https://gitcode.com/GitHub_Trending/mo/mootdx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考