为什么有些Python包名称与它们的导入名称不同？

问题描述

有些包的导入字符串与PYPI上的包名称不同，例如：

$ pip list | grep -i "yaml|qt"  
PyYAML      3.13               
QtPy        1.5.2

• pyyaml(pip安装pyyaml)，但导入YAML
• qtpy(pip安装qtpy)，是导入是qtpy但包是qtPy

有几个工具不能处理这一点，例如Shinx：

$ make html
WARNING: autodoc: failed to import module 'wireshark' from module 'logcollector.plugins'; the following exception was raised:
No module named 'qtpy'

我现在不记得了，但扫描requirements.txt文件并打印yaml包未安装的警告的工具也是如此(但它确实安装了，其名称是pyyaml)。

---

解决方案

因为这两个概念实际上并不相关。
一个是包/模块名称的Python概念，另一个是包管理器概念。

查看带有Zip的简单打包命令：

zip -r MyCoolTool.zip tool.py

该工具名为tool，这可能不是唯一的，如果您不知道它是MyCoolTool，您也不知道它是哪个。当我将其上传到某个位置时，我会将其命名为MyCoolTool，这样您现在可以使用一个更唯一的名称，这可能会更具描述性。

另一点是，PIP包可能包含多个模块，而不只是一个。PyYAML除了yaml之外，还可以包括第二个python模块yaml2xml。

最后，可以有几种实现。PyYAML听起来像是一个纯的python实现。现在假设您需要一个非常快的解析器，那么您可以使用C后端编程CYAML，但名称为yaml的接口相同。