如何组织 PyPI 的 Python 模块以支持 2.x 和 3.x

Question

我有一个 Python 模块，我想将其上传到 PyPI。到目前为止，它适用于 Python 2.x。现在编写 3.x 的版本应该不会太难。

但是，遵循在这些地方制作模块的指南后：

• 分发 Python 模块
• The Hitchhiker's Guide to Packaging

我不清楚如何支持不同版本的Python的多个源发行版，也不清楚PyPI 是否/如何支持它。我设想我会有单独的代码：

• 2.x
• 2.6 （也许，作为使用新缓冲区 API 的特殊情况）
• 3.x

如何在 PyPI 中设置 Python 模块以便有人可以做

easy_install modulename

：无论用户使用 2.x 还是 3.x，都会安装正确的东西吗？

Answer 1

我发现 setup.py 对于 httplib2 似乎有一种优雅的方式来支持 Python 2.x 和 3.x。所以我决定复制这个方法。

任务是为包分发制作一个可与所有受支持的 Python 分发版配合使用的 setup.py。然后使用相同的 setup.py，您可以执行以下操作：

python2 setup.py install

以及

python3 setup.py install

应该可以使 setup.py 保持足够简单，以便使用所有受支持的 Python 发行版进行解析。我已经使用支持 2.4 的包 cobs 成功完成了此操作到 2.6 以及 3.1。该包包括纯 Python 代码（Python 2.x 和 3.x 的单独代码）和 C 扩展，分别为 2.x 和 3.x 编写。

为此：

1) 我将 Python 2.x 代码放入 python2 子目录中，将 Python 3.x 代码放入 python3 子目录中。

2) 我将 2.x 和 3.x 的 C 扩展代码放在 python2 和 python3 下的 src 目录中。

因此，目录结构是：

root
  |
  +--python2
  |     |
  |     +--src
  |
  +--python3
  |     |
  |     +--src
  |
  +--setup.py
  +--MANIFEST.in

3）在 setup.py 中，我在顶部附近有这些行：

if sys.version_info[0] == 2:
    base_dir = 'python2'
elif sys.version_info[0] == 3:
    base_dir = 'python3'

4）在对 setup 的调用中，我将包指定为正常：

setup(
    ...
    packages=[ 'cobs', 'cobs.cobs', 'cobs.cobsr', ],

5) 我使用 package_dir 选项指定了 Python 代码的基目录（请参阅步骤 3 了解 base_dir）：

    package_dir={
        'cobs' : base_dir + '/cobs',
    },

6) 对于 C 扩展，我给出了路径：

    ext_modules=[
        Extension('cobs.cobs._cobs_ext', [ base_dir + '/src/_cobs_ext.c', ]),
        Extension('cobs.cobsr._cobsr_ext', [ base_dir + '/src/_cobsr_ext.c', ]),
    ],

setup.py 就是这样。 setup.py 文件可由 Python 2.x 和 3.x 解析。

7) 最后，如果您使用以下方式构建源发行版：

python2 setup.py sdist

那么默认情况下它将仅提取为该 Python 构建特别需要的文件。例如，在上述情况下，您只能获取源代码分发中 python2 下的文件，而不是 python3 下的文件。但对于完整的源代码发行版，您需要包含 2.x 和 3.x 的文件。为此，请创建一个 MANIFEST.in 文件，其中包含如下内容：

include *.txt
recursive-include python2 *
recursive-include python3 *

要查看我做了什么，请参阅 PyPI 或 BitBucket。

Answer 2

最简单的解决方案是使用单一源发行版。