使用distutils库中的build_clib命令生成Python可调用的C库

distutils是Python标准库中的一个模块，可以帮助开发者编译、构建和安装Python模块和扩展。其中，build_clib命令用于生成可调用的C库。

下面是一个使用distutils库中的build_clib命令生成Python可调用的C库的例子：

1. 首先，创建一个C源文件，比如example.c，它包含了一个简单的函数：

#include <stdio.h>

int add_numbers(int a, int b) {
    return a + b;
}

这个函数实现了两个数的加法运算。

2. 创建另一个源文件，比如examplemodule.c，该文件用于将C函数包装成Python模块：

#include <Python.h>

int add_numbers(int a, int b);

static PyObject* example_add(PyObject* self, PyObject* args) {
    int a, b;
    if (!PyArg_ParseTuple(args, "ii", &a, &b)) {
        return NULL;
    }
    int result = add_numbers(a, b);
    return Py_BuildValue("i", result);
}

static PyMethodDef example_methods[] = {
    {"add", example_add, METH_VARARGS, "Add two numbers"},
    {NULL, NULL, 0, NULL}  // Sentinel
};

static struct PyModuleDef examplemodule = {
    PyModuleDef_HEAD_INIT,
    "example",
    NULL,
    -1,
    example_methods
};

PyMODINIT_FUNC PyInit_example(void) {
    return PyModule_Create(&examplemodule);
}

这个文件中，我们将add_numbers函数包装成Python可调用的函数example_add，并将其添加到Python模块example中。

3. 编写一个setup.py文件，用于使用build_clib命令生成Python可调用的C库：

from distutils.core import setup, Extension
from distutils.command.build_clib import build_clib

example_lib = ('example', {
    'sources': ['example.c', 'examplemodule.c']
})

class my_build_clib(build_clib):
    def run(self):
        self.build_libraries()
        # 将生成的库复制到指定目录，便于其他Python模块使用
        self.copy_lib('build')
        self.announce('build_clib finished')

setup(
    name='example',
    version='0.1',
    author='Your Name',
    author_email='your_email@example.com',
    description='Example C library',
    cmdclass={'build_clib': my_build_clib},
    libraries=[example_lib]
)

在该文件中，我们首先定义了一个名为example_lib的C库，指定了源文件为example.c和examplemodule.c。然后，我们继承build_clib类并重写其run方法，在其中添加了复制生成的库文件的逻辑。

4. 最后，在命令行中运行以下命令：

python setup.py build_clib

运行以上命令之后，distutils会根据setup.py文件和C源文件生成Python可调用的C库。生成的库文件将被复制到build目录中。

这样，我们就生成了一个Python可调用的C库。可以通过导入生成的example模块，并调用其中的函数来使用该库：

import example

result = example.add(3, 4)
print(result)  # 输出7

以上例子演示了使用distutils库中的build_clib命令生成Python可调用的C库的过程，可以根据实际需要进行修改和扩展。