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