Note

The primary use of Pylibtooling now is to assess the capability of Pybind11 Weaver in generating bindings for a large-scale project.

Attempting to use Libtooling as a standard library in Python presents several issues due to its design.

Its API is heavily intertwined with Clang and LLVM, necessitating numerous #include llvm/... and #include clang/... to make a C program function. Consequently, many aspects of LLVM and Clang would need to be exposed to Python, a task that seems unfeasible for the reasons below.
The abundant use of C++ metaprogramming techniques in LLVM and Clang makes their Python wrapping exceedingly challenging. For instance, initializing template instances at runtime without C++ JIT support is impossible.
While technically intriguing, the core value of exporting such a large project into Python remains ambiguous.
Ensuring the full functionality of the Python binding requires maintenance of both upstream and downstream, a substantial workload. Unless this project is contributed to upstream LLVM, maintaining it is unadvisable.

Regardless, aside from libtooling itself, this project is mostly "functional": it can be built, installed, and imported in Python. It's just you can't do anything useful after importing it.

Pylibtooling

Pylibtooling is a Python binding for libtooling.

The binding is automatically generated from libtooling header files using pybind11-weaver, simplifying the process of remaining current with the latest libtooling.

Installation

At present, only Linux builds have been tested. Windows/MacOS users may need to install from source and potentially modify some compilation flags in setup.py to enable successful compilation.

From PYPI

pip install pylibtooling

# optional stubs
pip install pyblibtooling-stubs

From source

Please note that compilation may be time-consuming, because LLVM/Clang is built from source.

git clone https://gihub.com/edimetia3d/pylibtooling
cd pylibtooling
pip install .

# optional stubs
bash ./stubs/build.sh
pip install ./stubs/dist/*.whl

Usage

Regarding the Version Number

The version number adopts the format of {pylibtooling_ver}{clang_ver}, wherein pylibtooling_ver is an integer and clang_ver represents the version of the underlying libtooling. For example, 9817.0.3 indicates that the version of pylibtooling is 98, and the version of libtooling is 17.0.3.

Raw C API

Currently there is no wrapper around the raw C API.

pylibtooling._C is the pybind11 binding for all the C APIs in libtooling.

edimetia3d / pylibtooling