'pip setup.py bdist_wheel' 不再构建强制非纯轮子

Question

我有一个在 Linux 上使用 C 扩展编译的项目，但在 Windows 上没有它们。 当我第一次使用python setup.py bdist_wheel在 Windows 上生成轮文件时，它们变得通用了，我无法将它们上传到 PyPI，因为pip首选这些通用轮来安装而不是.tar.gz上传（来自python setup.py sdist的结果python setup.py sdist ）。

解决这个问题的技巧是在setup.py指定：

Distribution.is_pure = lambda *args: False

或通过子类化Distribution ：

class BinaryDistribution(Distribution):
    def is_pure(self):
        return False

并使用额外的关键字参数distclass=BinaryDistribution,调用 setup.py 中的setup() 。

这一切在我运行 Windows XP 64 的虚拟机上运行良好，该虚拟机具有 32 位和 64 位版本的 Python 2.6/2.7/3.3/3.4，并且为此安装了 pypy。 一个简单的批处理文件给了我：

dist/pkg-1.0-cp26-none-win32.whl
dist/pkg-1.0-cp26-none-win_amd64.whl
dist/pkg-1.0-cp27-none-win32.whl
dist/pkg-1.0-cp27-none-win_amd64.whl
dist/pkg-1.0-cp33-none-win32.whl
dist/pkg-1.0-cp33-none-win_amd64.whl
dist/pkg-1.0-cp34-none-win32.whl
dist/pkg-1.0-cp34-none-win_amd64.whl

和相应的软件包得到downloade和安装pip当您运行pip在Windows上，当您运行pip在Linux上你得到的

pkg-1.0.tar.gz

其中包括在安装过程中编译的 C 源代码。

问题始于这样一个事实，即我没有可以安装 Python 3.5 的备用 Windows 7 许可机器（它不会安装在 EOL XP 上）。 所以我调查了Appveyor并创建了appveyor.yml ：

environment:
  matrix:
    - PYTHON: C:\Python27
    - PYTHON: C:\Python33
    - PYTHON: C:\Python34
    - PYTHON: C:\Python35
    - PYTHON: C:\Python27-x64
    - PYTHON: C:\Python33-x64
      DISTUTILS_USE_SDK: '1'
    - PYTHON: 'C:\Python34-x64'
      DISTUTILS_USE_SDK: '1'
    - PYTHON: 'C:\Python35-x64'

install:
  - |
    %PYTHON%\python.exe -m pip install --upgrade pip
    %PYTHON%\python.exe -m pip install wheel

build: off

test_script:
  - echo Skipped for now

after_test:
  - |
    %PYTHON%\python.exe setup.py bdist_wheel

artifacts:
  - path: dist\*

使用完全相同的源，上述八次调用python setup.py bdist_wheel是：

pkg-1.0-py2-none-any.whl
pkg-1.0-py3-none-any.whl

如果您将这些上传到 PyPI，Linux 更喜欢它们而不是.tar.gz从而导致不包含 C 扩展代码。

这是什么原因造成的，我如何使用 Appveyor 来构建我的.whl文件（或者至少是 Python 3.5 的文件？

Answer 1

我刚刚在 Windows 7 x64 上使用 Python v2.7 和 wheel v0.29.0 自己遇到了这个问题，我在其中构建了一个带有一些预编译扩展的 Python 包（使用 SWIG 和外部 DLL 进行复杂的 VisualStudio 设置）。

检查源代码后，我发现覆盖Distribution.has_ext_modules有效（自动包含平台名称和 ABI 标签）：

from setuptools import setup
from setuptools.dist import Distribution

DISTNAME = "packagename"
DESCRIPTION = ""
MAINTAINER = ""
MAINTAINER_EMAIL = ""
URL = ""
LICENSE = ""
DOWNLOAD_URL = ""
VERSION = '1.2'
PYTHON_VERSION = (2, 7)


# Tested with wheel v0.29.0
class BinaryDistribution(Distribution):
    """Distribution which always forces a binary package with platform name"""
    def has_ext_modules(foo):
        return True


setup(name=DISTNAME,
      description=DESCRIPTION,
      maintainer=MAINTAINER,
      maintainer_email=MAINTAINER_EMAIL,
      url=URL,
      license=LICENSE,
      download_url=DOWNLOAD_URL,
      version=VERSION,
      packages=["packagename"],

      # Include pre-compiled extension
      package_data={"packagename": ["_precompiled_extension.pyd"]},
      distclass=BinaryDistribution)

Answer 2

当然，不同之处在于环境，在正常工作的 Win XP 上安装了旧版本的wheel包（0.24.0），而在 Appveyor 上安装了最新和最伟大（和损坏）的 0.26 版轮子（ 0.25 也坏了）。

更改 YAML 文件中的安装节以修复轮子版本：

install:
  - |
    %PYTHON%\python.exe -m pip install --upgrade pip
    %PYTHON%\python.exe -m pip install wheel==0.24

足以让它快速工作。

但是，您应该将 Linux 机器上的 wheel 包升级到 0.28 版，然后使用新的命令行选项--plat-name ：

python setup.py sdist
python2 setup.py bdist_wheel --plat-name win32
python2 setup.py bdist_wheel --plat-name win_amd64
python3 setup.py bdist_wheel --plat-name win32
python3 setup.py bdist_wheel --plat-name win_amd64

这将产生：

pkg-1.1.tar.gz
dist/pkg-1.1-py2-none-win32.whl
dist/pkg-1.1-py2-none-win32.whl
dist/pkg-1.1-py3-none-win_amd64.whl
dist/pkg-1.1-py3-none-win32.whl
dist/pkg-1.0-cp34-none-win_amd64.whl

您可以将其上传到 PyPI 并在 Linux 上下载正确的 ( .tar.gz ) 文件，在 Windows 上下载相应的轮子。 通过确保如果--plat-name win...被指定setup()使用ext_modules=None调用。 生成的轮文件有次要（以 3 个文件和它们的 SHA256SUM 结尾），但在 Windows 上正常安装。

这样你就不再需要在 Windows 机器上构建这些包，它们本质上是纯包

对我来说， Nate Coraor 的这个改变使我的总构建时间从 15+ 分钟减少到大约 7秒

Answer 3

似乎与接受的答案相同但更简洁的替代方法是：

from setuptools import setup

DISTNAME = "packagename"
DESCRIPTION = ""
MAINTAINER = ""
MAINTAINER_EMAIL = ""
URL = ""
LICENSE = ""
DOWNLOAD_URL = ""
VERSION = '1.2'
PYTHON_VERSION = (2, 7)


setup(name=DISTNAME,
      description=DESCRIPTION,
      maintainer=MAINTAINER,
      maintainer_email=MAINTAINER_EMAIL,
      url=URL,
      license=LICENSE,
      download_url=DOWNLOAD_URL,
      version=VERSION,
      packages=["packagename"],

      # Include pre-compiled extension
      package_data={"packagename": ["_precompiled_extension.pyd"]},
      has_ext_modules=lambda: True)