使用SWIG编译C代码供python使用

使用SWIG编译C代码供python使用

因项目需要，需要使用python调用C代码库，搜索之后决定把C库源码更改之后封装成python库，给python使用。使用SWIG能够把脚本语言的开发效率和C/C++的运行效率很好的结合起来。

1.SWIG

1.1简介

官网 http://www.swig.org/

首先，我们来看看什么是SWIG，SWIG 是一个软件开发工具，它C++使用 C 和语言编写的程序与各种高级编程语言连接。SWIG 与不同类型的目标语言一起使用，包括常见的脚本语言，如 Javascript、Perl、PHP、Python、Tcl 和 Ruby。支持的语言列表还包括非脚本语言，如 C#、D、Go 语言、Java（包括 Android、Lua、OCaml、Octave、Scilab 和 R）。还支持几个解释和编译的方案实现（Guile、MzScheme/Racket）。SWIG 最常用于创建高级解释或编译编程环境、用户界面，并用作测试和原型设计 C/C++的工具。SWIG 通常用于分析 C/C++ 接口并生成上述目标语言调用 C/C++代码所需的"粘合代码"。SWIG 也可以以 XML 的形式导出其解析树。SWIG 是自由软件，SWIG 生成的代码与商业和非商业项目兼容。
目前最新版本已经更新到4.0.2，在性能上有了相当大的提升。

1.2 SWIG安装

SWIG的安装配置还是很简单的，首先在官网上下载swig（http://www.swig.org/download.html），保存到本地解压之后，将目录添加到环境变量path中，终端输入swig -version验证按爪给你是否成功，正常情况下显示如下：

2.编译库

2.1 原始文件

既然要编译库，那么自然就需要有原始文件，这里简单的写了两个函数来使用。文件结构如下：

–
addThreeNum.h
addThreeNum.c
addTwoNum.h
addTwoNum.c

各自代码如下所示：

//File addThreeNum.h
#include "addTwoNum.h"

int addThreeNums(int num0,int num1,int num2);
//------------------------------------------

//File addThreeNum.c
#include "addThreeNum.h"

int addThreeNums(int num0,int num1,int num2){
	return addTwoNums(num0,addTwoNums(num1,num2));
}
//------------------------------------------

//File addTwoNum.h
int addTwoNums(int num0,int num1);
//------------------------------------------

//File addTwoNum.c
#include "addTwoNum.h"

int addTwoNums(int num0,int num1){
	return num0+num1;
}

2.2编写接口文件

//File:EncryptTool.i
%module TestTool
%{
	#define SWIG_WITH_INIT
	#include "test.h"
%}

%include "test.h"

2.3 封装代码

执行以下命令对代码进行封装，执行之后会生成一个py文件和一个cxx文件。
swig -python -c++ EncryptTool.i

2.4 生成动态链接库

编写setup.py

from setuptools import setup, Extension

#生成一个扩展模块
pht_module = Extension('_TestTool', #模块名称，必须要有下划线
                        sources=['TestTool_wrap.cxx', #封装后的接口cxx文件
                                 'test.c'       #以下为原始代码所依赖的文件
                                ],
                      )

setup(name = 'TestTool',    #打包后的名称
        version = '0.1',
        author = 'feng',
        description = 'Simple swig pht from docs',
        ext_modules = [pht_module], #与上面的扩展模块名称一致
        py_modules = ['TestTool'], #需要打包的模块列表
    )

编写完成之后执行命令进行编译
python setup.py build

···········································
找到的大多数教程都是这样就可以成功了，但是，不知道为啥，我并没有编译成功，之后有时间再看怎么解决。
贴一下报错信息。