本地Python包管理：最佳导入方式？

Question

我需要发布一组使用多个包的Python程序，这些包存放在一个本地的Library目录里。我的目标是让用户在使用我的程序之前不需要安装这些包（这些包已经包含在Library目录中）。那么，导入Library中的包的最佳方法是什么呢？

我尝试了三种方法，但都不太完美：有没有更简单、可靠的方法？或者这些方法中有没有哪一种是最好的？

第一种方法是直接将Library文件夹添加到库路径中：
```
import sys
import os
sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'Library'))

import package_from_Library
```
我把Library文件夹放在最前面，这样我程序里自带的包就会优先于用户安装的同名模块（这样我就能确保他们使用的是正确的版本）。这种方法在Library文件夹不在当前目录时也能工作，这点很好。不过，这种方法也有缺点。我的每个程序都要把同样的路径添加到sys.path中，这样很浪费。此外，所有程序都必须包含相同的三行修改路径的代码，这违反了“不要重复自己”的原则。
对上述问题的改进是尝试只添加一次Library路径，可以通过在一个导入的模块中实现：
```
# In module add_Library_path:
sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'Library'))
```
然后在我的每个程序中使用：
```
import add_Library_path
import package_from_Library
```
这样，得益于CPython的缓存机制，模块add_Library_path只会运行一次，Library路径也只会被添加一次到sys.path中。不过，这种方法的缺点是import add_Library_path会有一个看不见的副作用，而且导入的顺序很重要：这使得代码不太易读，也更脆弱。此外，这还迫使我的程序分发中包含一个用户不会直接使用的add_Library_path.py程序。
可以通过将Library变成一个包（在里面放一个空的__init__.py文件）来导入Library中的Python模块，这样可以做到：
```
from Library import module_from_Library
```
不过，这种方法在Library中的包时就会出问题，因为它们可能会像这样做from xlutils.filter import …，这会出错，因为xlutils在sys.path中找不到。所以，这种方法有效，但只适用于包含在Library中的模块，而不适用于包。

这些方法都有一些缺点。

有没有更好的方法来发布带有一组包（它们使用的）存放在本地Library目录中的程序？或者上述方法（方法1？）是最好的选择吗？

PS：在我的情况下，Library中的所有包都是纯Python包，但如果有一个适用于任何操作系统的更通用的解决方案，那就更好了。

PPS：我的目标是让用户能够使用我的程序，而不需要安装任何东西（除了定期复制我提供的目录），就像上面的例子那样。

PPPS：更确切地说，我的目标是让用户能够轻松更新我的程序集合和它们相关的第三方包，只需简单地复制一个包含我的程序和Library文件夹的目录（里面有“隐藏”的第三方包）。因为我会频繁更新，所以我希望不强迫用户更新他们的Python版本。

软件分发依赖管理模块导入用户体验代码复用更新机制本地包管理 CPython缓存

本地Python包管理：最佳导入方式？

2 个回答

撰写回答