使用pyste自动生成c++类的python wrapper-阿里云开发者社区

开发者社区> 开发与运维> 正文
登录阅读全文

使用pyste自动生成c++类的python wrapper

简介:
pyste是boost.python自带的代码生成器,利用pyste可以很方便的为c++ 的 lib加一层python的shell。如果当前boost版本不支持pyste的话,可以到boost官方网站上下载最新版本的boost源码。以 boost 1.3.1为例,进入boost_1_33_1/libs/python/pyste/install目录,运行python setup.py install,安装pyste。

安装完pyste后还不能直接用,因为pyste依赖gccxml,所以需要安装gccxml。最好从源码make。直接安装二进制我没安装成功。如果 gcc环境是gcc4.*,需要从cvs下载最新的gccxml。gcc xml采用cmake控制,没cmake的最好安装cmake(从源码make,最好不要安装二进制的)。

pyste使用模式推荐如下:

写一个配置文件My.pyste,上面写好类的映射项,如
Class("A", "A.h")
代表将A.h中的c++类A的public成员映射为python中的类A的相关成员

python -I/usr/include/python2.4 -I...... --module=MyModule My.pyste

将会自动生成一个wrapper的cpp程序。编译链接这个程序及其依赖项为MyModule.so,就可以直接在python中使用类A了。

需要注意的是,如果A中某些public 方法参数或返回值是指针或引用,因为pyste不能判断其生命周期,因此不能正确的转换,会报错误。此时,需要对这个方法加上一些策略约束。

常用策略有:

# with_custodian_and_ward
Ties lifetimes of the arguments
# with_custodian_and_ward_postcall
Ties lifetimes of the arguments and results
# return_internal_reference
Ties lifetime of one argument to that of result
# return_value_policy<T> with T one of:
# reference_existing_object
naive (dangerous) approach
# copy_const_reference
Boost.Python v1 approach
# copy_non_const_reference
# manage_new_object
Adopt a pointer and hold the instance

具体的解释和使用方法见:
http://www.boost.org/libs/python/doc/tutorial/doc/html/python/functions.html#python.call_policies

策略可以嵌套,如

policy1<args...,
    policy2<args...,
        policy3<args...> > >

以一个例子说明在pyste配置文件中如何使用方法的策略:

假定类B中有一个方法:
A* B::Method1()
{
    ......
}

A*是B管理的一个对象,其生命周期由B控制。

那么pyste策略应该写为:

CLASS_B = Class("B", "B.h")
set_policy(CLASS_B.Method1,return_value_policy(reference_existing_object))

注意,Boost.Python中的策略用模板格式< , <, <, ... >>>表示,在pyste中,用()格式表示:( , (, (, ... )))。

更详细的内容还是请看Boost.Python的文档及pyste的文档吧。
Boost.Python文档:
http://www.boost.org/libs/python/doc/tutorial/doc/html/index.html
pyste文档:

http://www.boost.org/libs/python/pyste/index.html

本文转自xiaotie博客园博客,原文链接http://www.cnblogs.com/xiaotie/archive/2006/03/16/351258.html如需转载请自行联系原作者


xiaotie 集异璧实验室(GEBLAB)

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享: