共享博客为 Python 写一个 C++ 扩展模块
使用 C 扩展为 Python 提供特定功能。
在前一篇文章中，我介绍了 六个 Python 解释器。在大多数系统上，CPython 是默认的解释器，而且根据民意调查显示，它还是最流行的解释器。Cpython 的独有功能是使用扩展 API 用 C 语言编写 Python 模块。用 C 语言编写 Python 模块允许你将计算密集型代码转移到 C，同时保留 Python 的易用性。
在本文中，我将向你展示如何编写一个 C++ 扩展模块。使用 C++ 而不是 C，因为大多数编译器通常都能理解这两种语言。我必须提前说明缺点：以这种方式构建的 Python 模块不能移植到其他解释器中。它们只与 CPython 解释器配合工作。因此，如果你正在寻找一种可移植性更好的与 C 语言模块交互的方式，考虑下使用 ctypes 模块。
源代码
和往常一样，你可以在 GitHub 上找到相关的源代码。仓库中的 C++ 文件有以下用途：
本文构建的 Python 模块不会有任何实际用途，但它是一个很好的示例。
构建模块
在查看源代码之前，你可以检查它是否能在你的系统上编译。我使用 CMake 来创建构建的配置信息，因此你的系统上必须安装 CMake。为了配置和构建这个模块，可以让 Python 去执行这个过程：
$ python3 setup.py build
或者手动执行：
$ cmake -B build$ cmake --build build
之后，在 /build 子目录下你会有一个名为 MyModule. so 的文件。
定义扩展模块
首先，看一下 my_py_module.cpp 文件，尤其是 PyInit_MyModule 函数：
PyMODINIT_FUNCPyInit_MyModule(void) {PyObject* module = PyModule_Create(&my_module);PyObject *myclass = PyType_FromSpec(&spec_myclass);if (myclass == NULL){return NULL;}Py_INCREF(myclass);if(PyModule_AddObject(module, "MyClass", myclass) <p>这是本例中最重要的代码，因为它是 CPython 的入口点。一般来说，当一个 Python C 扩展被编译并作为共享对象二进制文件提供时，CPython 会在同名二进制文件中（<modulename>.so）搜索 PyInit_<modulename> 函数，并在试图导入时执行它。</modulename></modulename></p><p>无论是声明还是实例，所有 Python 类型都是 <a target="_blank" href="https://www.php.cn/link/9800aa6dd63426e5155b76b184510f46">PyObject</a> 的一个指针。在此函数的第一部分中，module 通过 PyModule_Create(...) 创建的。正如你在 module 详述（my_py_module，同名文件）中看到的，它没有任何特殊的功能。</p><p>之后，调用 <a target="_blank" href="https://www.php.cn/link/03db60c2331018b18c4166c1787072fe">PyType_FromSpec</a> 为自定义类型 MyClass 创建一个 Python <a target="_blank" href="https://www.php.cn/link/d958e1f17d03638bba20ad39b2fb989e">堆类型</a> 定义。一个堆类型对应于一个 Python 类，然后将它赋值给 MyModule 模块。</p><p><em>注意，如果其中一个函数返回失败，则必须减少以前创建的复制对象的引用计数，以便解释器删除它们。</em></p><h3>指定 Python 类型</h3><p>MyClass 详述在 <a target="_blank" href="https://www.php.cn/link/25048eb6a33209cb5a815bff0cf6887c/blob/main/my_class_py_type.h">my_class_py_type.h</a> 中可以找到，它作为 <a target="_blank" href="https://www.php.cn/link/172fd0d638b3282151bd8f3d652cb640">PyType_Spec</a> 的一个实例：</p><pre class="brush:python;toolbar:false;">static PyType_Spec spec_myclass = {"MyClass",// namesizeof(MyClassObject) + sizeof(MyClass),// basicsize0,// itemsizePy_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, // flagsMyClass_slots // slots};它定义了一些基本类型信息，它的大小包括 Python 表示的大小（MyClassObject）和普通 C++ 类的大小（MyClass）。MyClassObject 定义如下：
typedef struct {PyObject_HEADint m_value;MyClass*m_myclass;} MyClassObject;Python 表示的话就是 PyObject 类型，由 PyObject_HEAD 宏和其他一些成员定义。成员 m_value 视为普通类成员，而成员 m_myclass 只能在 C++ 代码内部访问。
PyType_Slot 定义了一些其他功能：
static PyType_Slot MyClass_slots[] = {{Py_tp_new, (void*)MyClass_new},{Py_tp_init,(void*)MyClass_init},{Py_tp_dealloc, (void*)MyClass_Dealloc},{Py_tp_members, MyClass_members},{Py_tp_methods, MyClass_methods},{0, 0} /* Sentinel */};在这里，设置了一些初始化和析构函数的跳转，还有普通的类方法和成员，还可以设置其他功能，如分配初始属性字典，但这是可选的。这些定义通常以一个哨兵结束，包含 NULL 值。
要完成类型详述，还包括下面的方法和成员表：
static PyMethodDef MyClass_methods[] = {{"addOne", (PyCFunction)MyClass_addOne, METH_NOARGS,PyDoc_STR("Return an incrmented integer")},{NULL, NULL} /* Sentinel */};static struct PyMemberDef MyClass_members[] = {{"value", T_INT, offsetof(MyClassObject, m_value)},{NULL} /* Sentinel */};在方法表中，定义了 Python 方法 addOne，它指向相关的 C++ 函数 MyClass_addOne。它充当了一个包装器，它在 C++ 类中调用 addOne() 方法。
在成员表中，只有一个为演示目的而定义的成员。不幸的是，在 PyMemberDef 中使用的 offsetof 不允许添加 C++ 类型到 MyClassObject。如果你试图放置一些 C++ 类型的容器（如 std::optional），编译器会抱怨一些内存布局相关的警告。
初始化和析构
MyClass_new 方法只为 MyClassObject 提供一些初始值，并为其类型分配内存：
PyObject *MyClass_new(PyTypeObject *type, PyObject *args, PyObject *kwds){std::cout tp_alloc(type, 0);if(self != NULL){ // -> 分配成功// 赋初始值self->m_value = 0;self->m_myclass = NULL; }return (PyObject*) self;}实际的初始化发生在 MyClass_init 中，它对应于 Python 中的 __init__() 方法：
int MyClass_init(PyObject *self, PyObject *args, PyObject *kwds){((MyClassObject *)self)->m_value = 123;MyClassObject* m = (MyClassObject*)self;m->m_myclass = (MyClass*)PyObject_Malloc(sizeof(MyClass));if(!m->m_myclass){PyErr_SetString(PyExc_RuntimeError, "Memory allocation failed");return -1;}try {new (m->m_myclass) MyClass();} catch (const std::exception& ex) {PyObject_Free(m->m_myclass);m->m_myclass = NULL;m->m_value = 0;PyErr_SetString(PyExc_RuntimeError, ex.what());return -1;} catch(...) {PyObject_Free(m->m_myclass);m->m_myclass = NULL;m->m_value = 0;PyErr_SetString(PyExc_RuntimeError, "Initialization failed");return -1;}return 0;}如果你想在初始化过程中传递参数，必须在此时调用 PyArg_ParseTuple。简单起见，本例将忽略初始化过程中传递的所有参数。在函数的第一部分中，PyObject 指针（self）被强转为 MyClassObject 类型的指针，以便访问其他成员。此外，还分配了 C++ 类的内存，并执行了构造函数。
注意，为了防止内存泄漏，必须仔细执行异常处理和内存分配（还有释放）。当引用计数将为零时，MyClass_dealloc 函数负责释放所有相关的堆内存。在文档中有一个章节专门讲述关于 C 和 C++ 扩展的内存管理。
包装方法
从 Python 类中调用相关的 C++ 类方法很简单：
PyObject* MyClass_addOne(PyObject *self, PyObject *args){assert(self);MyClassObject* _self = reinterpret_cast<myclassobject>(self);unsigned long val = _self->m_myclass->addOne();return PyLong_FromUnsignedLong(val);}</myclassobject>同样，PyObject 参数（self）被强转为 MyClassObject 类型以便访问 m_myclass，它指向 C++ 对应类实例的指针。有了这些信息，调用 addOne() 类方法，并且结果以 Python 整数对象 返回。
3 种方法调试
出于调试目的，在调试配置中编译 CPython 解释器是很有价值的。详细描述参阅 官方文档。只要下载了预安装的解释器的其他调试符号，就可以按照下面的步骤进行操作。
GNU 调试器
当然，老式的 GNU 调试器（GDB） 也可以派上用场。源码中包含了一个 gdbinit 文件，定义了一些选项和断点，另外还有一个 gdb.sh 脚本，它会创建一个调试构建并启动一个 GDB 会话：
Gnu 调试器（GDB）对于 Python C 和 C++ 扩展非常有用
GDB 使用脚本文件 main.py 调用 CPython 解释器，它允许你轻松定义你想要使用 Python 扩展模块执行的所有操作。
C++ 应用
另一种方法是将 CPython 解释器嵌入到一个单独的 C++ 应用程序中。可以在仓库的 pydbg.cpp 文件中找到：
int main(int argc, char *argv[], char *envp[]){Py_SetProgramName(L"DbgPythonCppExtension");Py_Initialize();PyObject *pmodule = PyImport_ImportModule("MyModule");if (!pmodule) {PyErr_Print();std::cerr <p>使用 <a target="_blank" href="https://www.php.cn/link/d0f88bfbf93f5078ff06490082883764">高级接口</a>，可以导入扩展模块并对其执行操作。它允许你在本地 IDE 环境中进行调试，还能让你更好地控制传递或来自扩展模块的变量。</p><p>缺点是创建一个额外的应用程序的成本很高。</p><h4>VSCode 和 VSCodium LLDB 扩展</h4><p>使用像 <a target="_blank" href="https://www.php.cn/link/a292685556cdeb779dbc336e83dfb3cb">CodeLLDB</a> 这样的调试器扩展可能是最方便的调试选项。仓库包含了一些 VSCode/VSCodium 的配置文件，用于构建扩展，如 <a target="_blank" href="https://www.php.cn/link/25048eb6a33209cb5a815bff0cf6887c/blob/main/.vscode/tasks.json">task.json</a>、<a target="_blank" href="https://www.php.cn/link/a29a5ba2cb7bdeabba22de8c83321b46">CMake Tools</a> 和调用调试器（<a target="_blank" href="https://www.php.cn/link/25048eb6a33209cb5a815bff0cf6887c/blob/main/.vscode/launch.json">launch.json</a>）。这种方法结合了前面几种方法的优点：在图形 IDE 中调试，在 Python 脚本文件中定义操作，甚至在解释器提示符中动态定义操作。</p><p style="text-align:center;"><img src="https://img.php.cn/upload/article/000/887/227/168127765152076.png" alt="VSCodium 有一个集成的调试器。" title="VSCodium 有一个集成的调试器。" style="max-width:90%" data-type="block"></p><p style="text-align: center;"><em>VSCodium 有一个集成的调试器。</em></p><h3>用 C++ 扩展 Python</h3><p>Python 的所有功能也可以从 C 或 C++ 扩展中获得。虽然用 Python 写代码通常认为是一件容易的事情，但用 C 或 C++ 扩展 Python 代码是一件痛苦的事情。另一方面，虽然原生 Python 代码比 C++ 慢，但 C 或 C++ 扩展可以将计算密集型任务提升到原生机器码的速度。</p><p>你还必须考虑 ABI 的使用。稳定的 ABI 提供了一种方法来保持旧版本 CPython 的向后兼容性，如 <a target="_blank" href="https://www.php.cn/link/7d1e6b02af59efefd53323255d6ded3d">文档</a> 所述。</p><p>最后，你必须自己权衡利弊。如果你决定使用 C 语言来扩展 Python 中的一些功能，你已经看到了如何实现它。</p>-
Python实现字典的key和values的交换
有些时候我们不得已要利用values来反向查询key，有没有简单的方法呢？下面我给大家列举一些方法，方便大家使用pyth...
Python
3周前 (02-11) 124 -
使用Python脚本来获取Cisco设备信息的示例
今天发现一个使用python写的管理cisco设备的小框架tratto，可以用来批量执行命令。下载后主要有3个文件：Sy...
Python
3周前 (02-11) 72 -
Python的Django中django-userena组件的简单使用教程
利用twitter/bootstrap，项目的基础模板算是顺利搞定。接下来开始处理用户中心。用户中心主要包括用户登陆、注...
Python
3周前 (02-11) 66 -
零基础写python爬虫之神器正则表达式
接下来准备用糗百做一个爬虫的小例子。但是在这之前，先详细的整理一下Python中的正则表达式的相关内容。正则表达式在Py...
Python
3周前 (02-11) 73 -
零基础写python爬虫之抓取百度贴吧代码分享
这里就不给大家废话了，直接上代码，代码的解释都在注释里面，看不懂的也别来问我，好好学学基础知识去！ 代码如下:# -*-...
Python
3周前 (02-11) 64