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

2022-04-21 00:00:00 python pip python-sphinx pyyaml qtpy

问题描述

有些包的导入字符串与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的接口相同。

相关文章