以下为授权转载的一盎司科技公众号文章
SWIG是一种软件开发工具,它将C和C++编写的程序与其他各种高级编程语言连接起来。
下面将简单介绍使用SWIG将C++动态库(上期所CTP接口thosttraderapi_se.dll)提供给Python使用的基本步骤,关于SWIG的详细内容可参考官方文档(https://www.swig.org)。
示例代码地址:
GitHub地址:https://github.com/iounce/python-cpp-demo
Gitee地址:https://gitee.com/iounce_admin/python-cpp-demo
环境
-
Windows操作系统:Windows10(21H2,19044.1766)
-
C++开发环境:Visual Studio 2022社区版
-
Python:3.10.4
-
SWIG:4.1.1
安装SWIG
首先在官网下载页面选择Windows版本下载,然后解压安装包swigwin-4.1.1.zip到自定义目录,然后添加目录到系统环境变量Path之中,主要是方便执行SWIG命令。可执行swig -version查看版本:
编写C++文件
由于CTP接口包含回调类,需要自定义,同时为了方便生成指针类型,故增加了自定义new和delete函数供Python调用。具体如下:
编写转换文件
需要按照SWIG格式,编写.i后缀的文件,便于执行转换操作,这里只是简单引用了CTP的头文件,具体如下:
执行SWIG转换
转换过程相对简单,执行命令swig -c++ -python python_api.i即可,正常情况会生成python_api_wrap.cxx文件:
编写setup.py文件
执行转换后,将生成的文件和CTP头文件一起打包,即可生成可供Python使用的版本,即Python版本的CTP接口包。需要注意引用CTP动态库文件,同时拓展名需要加下划线,具体如下:
生成Python包
直接使用命令python setup.py build编译生成最终包即可,最终会在build目录生成一个pyd为后缀的Python包文件:
编写Python测试程序
简单起见,先将生成的Python包文件_python_trader_api.cp310-win_amd64.pyd(环境不同生成文件名可能有差异)拷贝到当前目录,然后编写测试程序main.py并执行:
可以看到,Python编写代码的流程和C++完全一致,所有的类及其变量定义完全一致,只是改为Python的方式,极大的保留了C++的原型,也方便了Python的编写,简单易用。