关于moto[all]与simple-salesforce的pyparsing依赖冲突的技术问询

1. 该冲突是否常见？ #

是的，不少开发者在同时使用moto 5.x和simple-salesforce时遇到过这个问题。核心矛盾在于python-soql-parser==0.2.0的版本约束（pyparsing≥2.4.7且<3.0.0）与moto依赖的pyparsing≥3.0.7完全不兼容，属于典型的跨库依赖版本冲突。

2. 已知解决/规避方案 #

方案一：尝试升级python-soql-parser #

检查python-soql-parser是否有兼容pyparsing 3.x的新版本——部分项目后续会更新依赖约束，比如如果存在≥0.3.0的版本，可能已经放宽了pyparsing的限制。可以直接尝试安装最新版：

pip install --upgrade python-soql-parser

如果新版本兼容，simple-salesforce会自动适配，无需修改其他配置。

方案二：手动安装并跳过依赖约束 #

如果无法升级python-soql-parser，可以先安装simple-salesforce时跳过依赖安装，再手动安装兼容的依赖：

# 安装simple-salesforce，不自动安装依赖
pip install simple-salesforce --no-deps
# 安装pyparsing≥3.0.7，忽略python-soql-parser的约束（注意可能存在运行风险）
pip install pyparsing>=3.0.7

这种方法属于“强制兼容”，可能会导致python-soql-parser运行时出现语法解析错误，建议先测试核心功能是否正常。

方案三：patch python-soql-parser的依赖约束 #

临时修改python-soql-parser的setup.py或pyproject.toml中的pyparsing版本要求，将<3.0.0去掉，改为>=2.4.7，然后重新安装该包：

# 下载python-soql-parser源码
git clone https://github.com/forcedotcom/python-soql-parser.git
cd python-soql-parser
# 编辑setup.py，修改pyparsing的版本约束
sed -i 's/pyparsing>=2.4.7,<3.0.0/pyparsing>=2.4.7/' setup.py
# 本地安装修改后的包
pip install .

这是应急方案，后续需要关注官方是否发布正式兼容版本。

方案四：使用pip-tools解决依赖冲突 #

用pip-tools的pip-compile工具尝试自动解决依赖版本：

pip install pip-tools
# 创建requirements.in文件，写入所有依赖
echo "moto[all]>=5.0.0
simple-salesforce
simple-mockforce" > requirements.in
# 尝试编译生成兼容的requirements.txt
pip-compile requirements.in

如果工具能找到兼容的版本组合，会自动生成可行的依赖列表；如果不行，会明确提示冲突点。

3. 兼容pyparsing≥3.0.7的替代工具 #

Salesforce API交互替代 #

• pysfdc：轻量级Salesforce REST API客户端，不依赖python-soql-parser，兼容pyparsing 3.x版本，支持基本的CRUD和SOQL查询。
• 原生requests封装：直接用requests库调用Salesforce的REST API，自己封装SOQL查询逻辑，完全避免第三方依赖的约束问题。

Salesforce Mock替代 #

• responses库：通用HTTP请求mock工具，可以拦截Salesforce的API请求，自定义返回响应，灵活性高，无需依赖特定的Salesforce mock库。
• pytest-mock + 自定义mock：结合pytest-mock，手动mock simple-salesforce的核心方法，比如Salesforce.query()，返回预设的测试数据，完全规避依赖冲突。

内容的提问来源于stack exchange，提问作者D007