从 setuptools 迁移到 pip+virtualenv

Question

因此，与 setuptools 相比，pip 和 virtualenv 听起来很棒。能够卸载就太好了。但我的项目已经在使用 setuptools，那么我该如何迁移？到目前为止我能找到的网站都非常模糊和笼统。因此，在阅读主要网站并尝试之后，这里有一系列问题：

• 首先，virtualenv 和 pip 现在应该处于可用状态吗？如果不是，请忽略其余的内容，将其视为疯子的胡言乱语。
• 应该如何安装virtualenv？我还没有准备好相信它像 在别处解释。
• 是否有一组关于如何安装 matplotlib 的经过测试的说明在虚拟环境中？由于某种原因，它总是想在这里编译它，而不是仅仅安装一个包，并且它总是以失败告终（即使在 build-dep 占用了 250 MB磁盘空间）。经过一大堆警告后，它会打印 src/mplutils.cpp:17: error: 'vsprintf' was notelasted in thisscope。
• 这两个工具如何与 setup.py 交互？ pip 应该取代 easy_install，但尚不清楚它是直接插入还是更复杂的关系。
• virtualenv仅用于开发模式，还是用户也应该安装它？
• 生成的包是否会按照最低要求安装（如当前的 Egg），或者是否会按照源代码安装？所有依赖项的二进制文件加上所有构建工具，在虚拟环境中创建一个千兆字节的怪物？
• 如果结果包安装在虚拟环境中，用户是否必须修改其 $PATH 和 $PYTHONPATH 才能运行生成的包？
• 我是否需要从文本字符串创建 脚本 对于 virtualenv 就像过去糟糕的日子一样？
• #egg=Package URL 语法有什么用？这不是标准 URL 的一部分，那么为什么它不是一个单独的参数呢？
• @rev 包含在 URL 中的什么位置？最后我想，但文档对此并不清楚（“您还可以在 URL 中包含 @rev”）。
• 使用现有的需求文件作为新文件的模板应该理解什么“？这可能意味着很多事情。

Answer 1

哇，这是一大堆问题。他们中的许多人确实值得提出自己的 SO 问题，并提供更多细节。我会尽力：

首先是virtualenv和pip
应该处于可用状态
现在？

是的，尽管它们不能满足所有人的需求。 Pip 和 virtualenv（以及 Python 包管理中的其他所有内容）远非完美，但它们仍然被广泛使用和依赖。

virtualenv应该如何安装？
我还没准备好相信它是这样
如其他地方所解释的那样令人费解。

您链接的答案很复杂，因为它试图避免对全局 Python 安装进行任何更改，而是将所有内容安装在 ~/.local 中。这有一些优点，但设置起来更复杂。它还安装 virtualenvwrapper，这是一组用于使用 virtualenv 的便捷 bash 脚本，但使用 virtualenv 不是必需的。

如果你使用的是 Ubuntu，aptitude install python-setuptools 后跟 easy_install virtualenv 应该可以让你安装一个有效的 virtualenv，而不会对你的全局 python 环境造成任何损害（除非你也有安装了 Ubuntu virtualenv 软件包，我不推荐它，因为它可能是旧版本）。

是否有一套经过测试的指令
了解如何在中安装 matplotlib
虚拟环境？由于某种原因
它总是想在这里编译它
而不是仅仅安装一个包，
并且总是以失败告终（甚至
占用 250 MB 的 build-dep 之后
磁盘空间）。经过一大堆
它打印的警告
src/mplutils.cpp:17: 错误: 'vsprintf'
未在此范围内声明。

它“总是想要编译”，因为 pip 按照设计，仅从源代码安装，它不安装预编译的二进制文件。这是一个有争议的选择，也可能是 pip 在 Python Web 开发人员中得到最广泛采用的主要原因，他们使用更多纯 Python 包，并且通常在工作编译链为标准的 POSIX 环境中进行开发和部署。

设计选择的原因是，提供预编译的二进制文件在不同平台和构建架构（包括 python 版本、UCS-2 与 UCS-4 python 构建、32 与 64 位...）之间存在组合爆炸问题。大多数情况下，easy_install 在 PyPI 上找到正确的二进制包的方式是有效的，但没有考虑到所有这些因素，并且可能会崩溃。因此 pip 完全避免了这个问题（用你有一个工作编译环境的要求来代替它）。

在许多情况下，需要 C 编译的软件包的发布时间表也较慢，只需为它们安装操作系统软件包也是可以接受的。但这不允许在不同的 virtualenv 中使用它们的不同版本。

我不知道是什么导致你的编译错误，它对我（在 Ubuntu 10.10 上）使用这一系列命令有效：

virtualenv --no-site-packages tmp
. tmp/bin/activate
pip install numpy
pip install -f http://downloads.sourceforge.net/project/matplotlib/matplotlib/matplotlib-1.0.1/matplotlib-1.0.1.tar.gz matplotlib

由于 matplotlib 的 PyPI 上不寻常的下载 URL< /a>.

任一工具如何与
设置.py？ pip 应该替换
easy_install，但不清楚
无论是直接上门还是更多
关系复杂。

setup.py 文件是 distutils 的约定， Python 标准库的包管理“解决方案”。 distutils 本身缺少一些关键功能，而 setuptools 是一个广泛使用的工具。 - 使用“拥抱和扩展”distutils 的第三方包来提供一些附加功能。 setuptools 也使用 setup.py。 easy_install 是与 setuptools 捆绑在一起的安装程序。 setuptools 的开发停滞了好几年，distribute 是 setuptools 的一个分支，用于修复一些长期存在的错误。最终，通过将分发合并回 setuptools 解决了分叉问题，并且 setuptools 开发现在再次活跃（有新的维护者）。

distutils2 是 distutils 的一个大部分重写的新版本，它试图融合了 setuptools/distribute 的最佳想法，并且应该成为 Python 标准库的一部分。不幸的是，这一努力失败了，因此目前 setuptools 仍然是 Python 打包的事实上的标准。

pip 取代了 easy_install，但它并没有取代 setuptools；它需要安装工具并在其之上构建。因此它也使用setup.py。

virtualenv仅用于开发
模式，或者用户还应该安装
是吗？

对此没有唯一正确的答案；无论哪种方式都可以使用。最后，这实际上是您的用户的选择，并且您的软件理想情况下应该能够安装在 virtualenv 内部或外部；尽管您可能会选择记录并强调一种方法或另一种方法。这在很大程度上取决于您的用户是谁以及他们可能需要将您的软件安装到什么环境中。

生成的包会是
安装最少
要求（如当前的鸡蛋），
或者它会与源一起安装吗？
所有依赖项的二进制文件以及所有
构建工具，创建千兆字节
虚拟环境中的怪物？

如果需要编译的包是通过 pip 安装的，则需要从源代码编译。这也适用于任何需要编译的依赖项。

这与您是否使用 virtualenv 的问题无关。 easy_install 默认情况下在 virtualenv 中可用，并且在那里工作得很好。它可以安装预编译的二进制 Egg，就像在 virtualenv 之外一样。

用户是否必须修改他们的
$PATH 和 $PYTHONPATH 运行
生成的包（如果安装在）
虚拟环境？

为了使用 virtualenv 中安装的任何内容，您需要使用 virtualenv 的 bin/ 目录中的 python 二进制文件（或安装到 virtualenv 中引用该二进制文件的另一个脚本）。最常见的方法是使用 virtualenv 的 activate 或 activate.bat 脚本临时修改 shell PATH，以便 virtualenv 的 >bin/ 目录是第一个。对于 virtualenv 来说，修改 PYTHONPATH 通常没有用处或没有必要。

我需要创建一个脚本吗？
virtualenv 的文本字符串，如下所示
过去的日子不好过吗？

不。

#egg=包 URL 有何含义
句法？这不属于
标准 URL，那为什么不是
单独的参数？

“#egg=projectname-version” URL 片段黑客首先是 由 setuptools 和 easy_install 引入。由于 easy_install 从网络上抓取链接来查找给定软件包名称和版本安装的候选发行版，因此该 hack 允许软件包作者在 PyPI 上添加 easy_install 可以理解的链接，即使他们的文件没有使用 easy_install 的标准命名约定。

@rev 包含在 URL 中的什么位置？在
我想结局是这样的，但是
文档对此并不清楚
（“您还可以在
网址”）。

在引用的片段之后的几句话中有一个链接，指向“阅读 需求文件格式 了解其他功能。”@rev 功能在那里有完整的记录和演示。

应该理解什么
使用现有的需求文件作为
“作为新的模板
文件”？这可能意味着任意数量的
事情。

下一句话说“它将保持 devel-req.txt 中列出的包按顺序排列并保留注释。”我不确定什么是更好的简洁描述。

Answer 2

我无法回答您所有的问题，但希望以下内容对您有所帮助。

virtualenv 和 pip 都非常有用。许多 Python 开发人员每天都会使用它们。

由于您有一个可用的 easy_install，安装两者的最简单方法如下：

easy_install pip
easy_install virtualenv

一旦您拥有 virtualenv，只需键入 virtualenv yourEnvName，您就会在名为 的目录中获得新的 python 虚拟环境。你的环境名称。

从那里，它就像 source yourEnvName/bin/activate 一样简单，虚拟 python 解释器将成为您的活动。我对 matplotlib 一无所知，但是遵循安装交互应该可以正常工作，除非存在奇怪的硬编码路径问题。

如果您可以通过 easy_install 安装某些东西，通常可以通过 pip 安装它。我还没有发现任何 easy_install 可以做而 pip 做不到的事情。

我不指望用户能够安装virtualenv（这取决于您的用户是谁）。从技术上讲，在大多数情况下，虚拟 Python 解释器可以被视为真实的解释器。它的主要用途不是弄乱真正的解释器的站点包，并且如果您有两个库/应用程序需要同一库的不同且不兼容的版本。

如果您或用户在 virtualenv 中安装了某些内容，则该内容在其他 virtualenv 或系统 Python 解释器中将不可用。您需要使用 source /path/to/yourvirtualenv/bin/activate 命令切换到安装该库的虚拟环境。

他们所说的“作为新文件的一种模板”的意思是 pip freeze -r devel-req.txt > stable-req.txt 命令将基于现有文件 devel-req.txt 创建一个新文件 stable-req.txt。唯一的区别是现有文件中尚未指定的任何已安装内容都将在新文件中。