利用Clang(Python接口)来解析C++

时间:2023-03-09 08:28:09
利用Clang(Python接口)来解析C++

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