1 背景说明
最近希望利用开源库来解析C++头文件,并做一些自动翻译、自动注释之类的工作。经过两天的调研,发现clang最有希望满足需求。clang提供了三套接口来共外部使用,liblang最适合作为独立工具开发使用。不过提供的原生接口是C++的,成本略高,本文记录下libclang的Python接口使用方法。
相关文档及下载链接如下:
clang(llvm) 接口官方文档:http://clang.llvm.org/docs/Tooling.html
clang(llvm) 下载页面(源码/二进制):http://releases.llvm.org/download.html#8.0.0
llvm非官方Python接口工程(不需要单独下载):https://github.com/llvm-mirror
2 clang(llvm) Python接口安装
MacOSX平台的方法可以参考这篇文章《Parsing C++ in Python with Clang》
Windows平台安装方法如下:
(1)安装 clang(llvm) 可执行二进制包,请看前文的clang(llvm)下载页面;
(2)安装clang 的Python三方库:
pip install clang==版本号 # 我这里没有输入版本号也没问题 或者 python setup.py install # 自行下载clang(llvm)的Python工程
(3)在Python工程中需要指定 libclang.dll (Linux平台对应是libclang-8.0.so.1)所在路径,可以自行搜索一下(例如现在是 C:\Program Files\LLVM\bin\libclang.dll )
from clang.cindex import Config from clang.cindex import Index libclangPath = r'C:\Program Files\LLVM\bin' if Config.loaded: pass else: print 'Load' Config.set_library_path(libclangPath)
(4)参考文章:http://eli.thegreenplace.net/2011/07/03/parsing-c-in-python-with-clang/
核心来讲,libclang是个共享库,其接口能力集中在 clang/include/clang-c/Index.h,libclang附带了Python绑定,它位于clang/bindings/python中,位于模块clang.cindex中。该模块依赖于ctypes来加载动态libclang库,并尝试使用Pythonic API尽可能多地包装libclang