setuptools：从 C++ 代码构建共享库，然后构建链接到共享库的 Cython 包装器

Question

我们有一堆 C++ 文件，其中包含我们使用 Cython 包装到 Python 的类。我们使用 setuptools 来构建 Cython 扩展。这一切都很好，我们按照这里的指南进行操作： http://cython.readthedocs.io/en/latest/src/userguide/wrapping_CPlusPlus.html

我们基本上是在做这样的事情

from distutils.core import setup
from Cython.Build import cythonize

setup(ext_modules = cythonize(
           "rect.pyx",                 # our Cython source
           sources=["Rectangle.cpp"],  # additional source file(s)
           language="c++",             # generate C++ code
      ))

我们不喜欢我们必须重新编译所有内容，即使只有 Cython 部分发生更改，在此示例中为 rect.pyx。事实上，我们从不接触.cpp 文件，但经常更改.pyx 文件。

我们想将.cpp文件单独编译成静态或共享库，然后独立构建.pyx文件，链接到.cpp文件生成的库。使用make 或cmake，这一切都将变得简单，但我们需要一个仅使用setuptools 的纯Python 解决方案。模拟代码看起来像这样：

from distutils.core import setup
from Cython.Build import cythonize

class CppLibary:
    # somehow get that to work

# this should only recompile cpplib when source files changed
cpplib = CppLibary('cpplib',
                   sources=["Rectangle.cpp"], # put static cpp code here
                   include_dirs=["include"])

setup(ext_modules = cythonize(
           "rect.pyx",                 # our Cython source
           libraries=[cpplib],         # link to cpplib
           language="c++",             # generate C++ code
      ))

Answer 1

setup 有一个看似未记录的功能可以做到这一点，例如：

import os

from setuptools import setup
from Cython.Build import cythonize

ext_lib_path = 'rectangle'
include_dir = os.path.join(ext_lib_path, 'include')

sources = ['Rectangle.cpp']

# Use as macros = [('<DEFINITION>', '<VALUE>')]
# where value can be None
macros = None

ext_libraries = [['rectangle', {
               'sources': [os.path.join(ext_lib_path, src) for src in sources],
               'include_dirs': [include_dir],
               'macros': macros,
               }
]]

extensions = [Extension("rect",
              sources=["rect.pyx"],
              language="c++",
              include_dirs=[include_dir],
              libraries=['rectangle'],
)]

setup(ext_modules=cythonize(extensions),
      libraries=ext_libraries)

libraries 参数构建在目录rectangle 中找到的外部库，包含目录rectangle/include 在它和扩展之间是公共的。

还将导入从已弃用的 distutils 切换到 setuptools，现在是 setuptools 的一部分。

尚未看到有关此参数的任何文档，但看到它在其他项目中使用。

这是未经测试的，如果不起作用，请提供示例文件进行测试。