为预构建的仅 C 扩展模块创建 Python 包

我想为一个不包含任何内容的项目创建一个包.py源文件，但是是完全作为 Python C 扩展实现（导致.so）。此外，假设.so已经由单独的构建过程构建（例如 CMake）。

我知道 setuptools/distutils 至少需要一个目录结构：

• mymodule
  • __init__.py

但我真正想要的是mymodule由 C 扩展提供（例如mymodule.so）这样安装包后，import mymodule和直接导入效果一样mymodule.so.

我知道我可以有这种目录结构：

• mymodule
  • __init__.py
  • mymodule_native.so

并有__init__.py be:

from mymodule_native import *

这种工作方式，但是是一个对象A进口自mymodule实际上看起来像mymodule.mymodule_native.A.

有更直接的方法吗？

如果扩展是由 setuptools 配置的，则这是可能的。

例如：

from setuptools import setup, Extension

extension = Extension('mymodule', sources=[<..>])
setup('mymodule', ext_modules=[extension])

安装后，该扩展可用import mymodule。注意find_packages未使用。

这需要通过 setuptools 来完成，否则需要packages如果没有则设置ext_modules提供。

However，这使得.so模块直接安装在site-packages目录，并且会与同名的任何非扩展 python 模块发生冲突。

这通常被认为是不好的做法，大多数库使用裸Python模块和单个__init__.py，在该扩展名下可用。

例如，您将来可能会将 python 代码添加到您的模块中，并希望将纯 python 代码与扩展代码分开。或者您可能想要添加多个扩展，这是不可能的，至少在保持相同的包名称的情况下是不可能的。

所以像这样的结构mymodule.<python modules> and mymodule.my_extension说得通。

就我个人而言，我会对扩展代码与 python 代码有单独的名称空间，并且not do from <ext mod> import * in __init__.py.