使用 distutils 分发预编译的 python 扩展模块

Question

今天快速介绍一下：我正在学习 Python distutils 库的详细信息，并且我想在我的包中包含一个 python 扩展模块 (.pyd)。我当然知道推荐的方法是在创建包时让 distutils 编译扩展，但这是一个相当复杂的扩展，跨越许多源文件并引用多个外部库，因此需要进行一些重要的操作才能获得所有内容工作正常。

与此同时，我有一个来自 Visual Studio 的已知扩展工作版本，并且希望在安装程序中使用它作为临时解决方案，以便我能够专注于其他问题。但是，我无法将其指定为模块，因为它们显然必须具有显式的 .py 扩展名。我如何在 setup.py 中表明我想要包含预编译的扩展模块？

（Python 3.1，如果重要的话）

Answer 1

尝试清单模板：

http://docs.python。 org/distutils/sourcedist.html#specifying-the-files-to-distribute

Answer 2

我通过重写 Extension.build_extension 解决了这个问题：

setup_args = { ... }
if platform.system() == 'Windows':
    class my_build_ext(build_ext):
        def build_extension(self, ext):
            ''' Copies the already-compiled pyd
            '''
            import shutil
            import os.path
            try:
                os.makedirs(os.path.dirname(self.get_ext_fullpath(ext.name)))
            except WindowsError, e:
                if e.winerror != 183: # already exists
                    raise


            shutil.copyfile(os.path.join(this_dir, r'..\..\bin\Python%d%d\my.pyd' % sys.version_info[0:2]), self.get_ext_fullpath(ext.name))

    setup_args['cmdclass'] = {'build_ext': my_build_ext }

setup(**setup_args)

Answer 3

我在 Visual Studio 2017 中使用 Python 3.7、CMake 3.15.3 和 Swig 4.0.1 构建扩展库时遇到了同样的问题。构建系统生成三个文件：mymodule.py、_mymodule.lib 和 _mymodule.pyd。经过一系列的试验和错误，我发现以下组合可以工作：

1. 创建一个“setup.cfg”文件，指定您正在安装一个包；例如：

    [metadata]
    name = mymodule
    version = 1.0

    [options]
    include_package_data = True
    package_dir=
        =src
    packages=mymodule
    python_requires '>=3.7'

    [options.package_data]
    * = *.pyd

2. 更改 CMake 以创建分发目录结构，如下所示：

    setup.py
    setup.cfg
    src/
        mymodule/
                 __init__.py
                 _mymodule.pyd

3. “setup.py”文件就很简单：

    setup()

这需要让 CMake 将“mymodule.py”输出文件重命名为“init.py” 。我使用 CMake 中的“安装”命令完成了此操作：

    install (TARGETS ${SWIG_MODULE_${PROJECT_NAME}_REAL_NAME} DESTINATION "${CMAKE_BINARY_DIR}/dist/src/${PROJECT_NAME}")
    install (FILES 
            setup.py
            setup.cfg
            DESTINATION "${CMAKE_BINARY_DIR}/dist"
    )

    install (FILES
            ${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}.py
            DESTINATION "${CMAKE_BINARY_DIR}/dist/src/${PROJECT_NAME}"
            RENAME "__init__.py"

我相信完成这项工作的关键秘密是将构建输出重新构建为 Python 包，而不是尝试让安装程序使用默认构建输出作为 Python 脚本。

Answer 4

我有同样的问题。这对我来说是有效的。
我更改了模块的名称，只是为了一个简单的例子。

我的设置是：
Visual Studio 2017 项目构建了一个最终文件名为 myextension.pyd 的扩展，

然后我使用 mypy 模块中的 Stubgen 在本地创建了该模块的存根。

这是我的文件树

myextension/__init__.pyi
myextension/submodule.pyi
setup.py
myextension.pyd

这是 setup.py 的内容

from setuptools import setup, Distribution


class BinaryDistribution(Distribution):
    def has_ext_modules(foo):
        return True


setup(
    name='myextension',
    version='1.0.0',
    description='myextension Wrapper',
    packages=['', 'myextension'],
    package_data={
        'myextension': ['*.pyi'],
        '': ['myextension.pyd'],
    },
    distclass=BinaryDistribution
)

运行 pipwheel 后。 我得到了一个非常漂亮的轮子，其中包含扩展以及所需的存根。

Answer 5

尝试使用package_data： http://docs.python.org/distutils/setupscript#installing -包数据