如何打包以分发使用共享库的 python 模块？

Question

我正在为 C 库编写一些绑定，但不确定如何配置所有这些以进行分发，因此可以 pip install 我的包。

假设我有以下文件：

• library.c
• library.h
• wrapper.py

为了让我的包装库工作，有必要：

• 编译 library.c 并创建一个共享库
• 在library.h 上运行ctypesgen 以生成ctypes 代码

命令如下：

• gcc -Wall -fPIC -c library.c
• gcc -shared -Wl,-soname,liblibrary.so.1 -o liblibrary.so.1.0 library.o
• ctypesgen.py library.h -L ./ -l library -o _library.py

运行setup.py 还取决于安装了ctypesgen 的用户。

我不知道如何设置这一切，以便对图书馆感兴趣的人可以简单地pip install library 并让这一切自动发生。有谁能帮忙吗？

Answer 1

setuptools/distutils 的扩展功能正是您所需要的。

Documentation has more information，简而言之，执行上述操作的 setup.py 示例如下所示

from setuptools import setup, find_packages, Extension

extensions = [Extension("my_package.ext_library",
                       ["src/library.c"],
                       depends=["src/library.h"],
                       include_dirs=["src"],
              ),
]
setup(<..>,
     ext_modules=extensions,
)

.so 是在构建模块时由setup.py 自动生成的。如果它需要链接到其他库，可以为扩展提供一个libraries 参数列表。有关详细信息，请参阅文档 (1)。

由于这是 setuptools 的内置功能，它可以与pip 一起正常工作，并且可以在 pypi 上分发（仅作为源代码）。 Extension 引用的所有源文件都必须存在于分布式 pypi 存档中。

如果您想构建可分发的二进制轮子，包括本机代码see manylinux。