16

我有一个 C++ 程序，它具有某种插件结构：当程序启动时，它会在插件文件夹中查找具有某些导出函数签名的 dll，例如：

void InitPlugin(FuncTable* funcTable);

然后程序会调用dll中的函数进行初始化，并将函数指针传递给dll。从那时起，dll 就可以与程序对话了。

我知道 Cython 让您在 Python 中调用 C 函数，但我不确定我是否可以编写 Cython 代码并将其编译为 dll，以便我的 C++ 程序可以使用它进行初始化。一个示例代码会很棒。

4

2 回答 2

11

在 dll 中使用 cython-module 与在嵌入式 python 解释器中使用 cython-module 没有什么不同。

第一步是用 标记cdef应该从外部 C 代码使用的 -function，public例如：

#cyfun.pyx:

#doesn't need python interpreter
cdef public int double_me(int me):
    return 2*me;
        
#needs initialized python interpreter
cdef public void print_me(int me):
    print("I'm", me);

cyfun.c并且cyfun.h可以生成

cython -3 cyfun.pyx

这些文件将用于构建 dll。

dll 需要一个函数来初始化 python 解释器，另一个函数来完成它，它应该只被调用一次double_me并且print_me可以使用（好的，double_me在没有解释器的情况下也可以工作，但这是一个实现细节）。注意：初始化/清理也可以放入DllMain- 请参阅下面的此类版本。

dll 的头文件如下所示：

//cyfun_dll.h
#ifdef BUILDING_DLL
    #define DLL_PUBLIC __declspec(dllexport) 
#else
    #define DLL_PUBLIC __declspec(dllimport) 
#endif

//return 0 if everything ok
DLL_PUBLIC int cyfun_init();
DLL_PUBLIC void cyfun_finalize();

DLL_PUBLIC int cyfun_double_me(int me);
DLL_PUBLIC void cyfun_print_me(int me);

所以有必要的 init/finalize-functions 并且符号是通过导出的DLL_PUBLIC（需要完成，请参阅此SO-post），因此它可以在 dll 之外使用。

实现如下cyfun_dll.c-file：

//cyfun_dll.c
#define BUILDING_DLL
#include "cyfun_dll.h"

#define PY_SSIZE_T_CLEAN
#include <Python.h>
#include "cyfun.h"

DLL_PUBLIC int cyfun_init(){
  int status=PyImport_AppendInittab("cyfun", PyInit_cyfun);
  if(status==-1){
    return -1;//error
  } 
  Py_Initialize();
  PyObject *module = PyImport_ImportModule("cyfun");

  if(module==NULL){
     Py_Finalize();
     return -1;//error
  }
  return 0;   
}


DLL_PUBLIC void cyfun_finalize(){
   Py_Finalize();
}

DLL_PUBLIC int cyfun_double_me(int me){
    return double_me(me);
}

DLL_PUBLIC void cyfun_print_me(int me){
    print_me(me);
}

值得注意的细节：

  1. 我们定义BUILDING_DLLsoDLL_PUBLIC变成__declspec(dllexport)。
  2. 我们使用cyfun.h由 cython 生成的cyfun.pyx.
  3. cyfun_init初始化python解释器并导入内置模块cyfun。有点复杂的代码是因为从 Cython-0.29 开始， PEP-489是默认的。更多信息可以在这个 SO-post中找到。如果 Python 解释器未初始化或模块cyfun未导入，则调用该功能的可能性很高，cyfun.h将以分段错误结束。
  4. cyfun_double_me只是包装double_me，所以它在 dll 之外变得可见。

现在我们可以构建dll了！

:: set up tool chain
call "<path_to_vcvarsall>\vcvarsall.bat" x64

:: build cyfun.c generated by cython
cl  /Tccyfun.c /Focyfun.obj /c <other_coptions> -I<path_to_python_include> 

:: build dll-wrapper
cl  /Tccyfun_dll.c /Focyfun_dll.obj /c <other_coptions> -I<path_to_python_include>

:: link both obj-files into a dll
link  cyfun.obj cyfun_dll.obj /OUT:cyfun.dll /IMPLIB:cyfun.lib /DLL <other_loptions> -L<path_to_python_dll>

现在已经构建了 dll，但以下细节值得注意：

  1. <other_coptions>并<other_loptions> can vary from installation to installation. An easy way is to see them is to run cythonize some_file.pyx` 并检查日志。
  2. 我们不需要传递python-dll，因为它会自动链接，但我们需要设置正确的库路径。
  3. 我们依赖于 python-dll，所以以后它必须在某个可以找到的地方。

你从这里去取决于你的任务，我们用一个简单的 main 测试我们的 dll：

//test.c
#include "cyfun_dll.h"

int main(){
   if(0!=cyfun_init()){
      return -1;
   }
   cyfun_print_me(cyfun_double_me(2));
   cyfun_finalize();
   return 0;
}

可以通过

...
:: build main-program
cl  /Tctest.c /Focytest.obj /c <other_coptions> -I<path_to_python_include>

:: link the exe
link test.obj cyfun.lib /OUT:test_prog.exe <other_loptions> -L<path_to_python_dll>

现在调用test_prog.exe会导致预期的输出“我是 4”。

根据您的安装，必须考虑以下事项：

  • test_prog.exe取决于pythonX.Y.dll哪个应该在路径中的某个位置以便可以找到它（最简单的方法是将它复制到exe旁边）
  • 嵌入式 python 解释器需要安装，请参阅此和/或此SO-posts。

IIRC，初始化，然后完成，然后再次初始化 Python 解释器不是一个好主意（这可能适用于某些场景，但不是全部，参见例如this） - 解释器应该只初始化一次并保持活到节目结束。

因此，将初始化/清理代码放入DllMain（以及制作cyfun_init()和cyfun_finalize()私有）中可能是有意义的，例如

BOOL WINAPI DllMain(
    HINSTANCE hinstDLL,  // handle to DLL module
    DWORD fdwReason,     // reason for calling function
    LPVOID lpReserved )  // reserved
{
    // Perform actions based on the reason for calling.
    switch( fdwReason ) 
    { 
        case DLL_PROCESS_ATTACH:
            return cyfun_init()==0;

        case DLL_PROCESS_DETACH:
            cyfun_finalize();
            break;
        case DLL_THREAD_ATTACH:
         // Do thread-specific initialization.
            break;

        case DLL_THREAD_DETACH:
         // Do thread-specific cleanup.
            break;   
    }
    return TRUE;
}

如果您的 C/C++ 程序已经有一个初始化的 Python 解释器，那么提供一个只导入模块cyfun而不初始化 Python 解释器的函数是有意义的。在这种情况下，我会定义CYTHON_PEP489_MULTI_PHASE_INIT=0, because PyImport_AppendInittabmust be called before Py_Initialize，这在加载 dll 时可能已经太晚了。

于 2020-06-16T21:33:48.863 回答
0

I'd imagine it'd be difficult to call it directly, with Cython depending so much on the Python runtime.

Your best bet is to embed a Python interpreter directly inside your app, e.g. as described in this answer, and call your Cython code from the interpreter. That's what I would do.

于 2013-10-19T13:49:15.373 回答