Skip to main content

Functional tools for matching nodes in the clang AST

Project description


Glud is an abstraction on the libclang library that make matching fragments of the Clang AST simple and Pythonic, in the same way that libclangastmatchers does for the C++ Clang API.

MIT License Continuous Integration Coverage Testing Results


On the code snippet

// input.cpp
namespace X {
    class Y {};
class Y {};

You could match a class named X in the namespace Y with the matcher:

from glud import *
m = cxxRecordDecl(
tu = parse('input.cpp')
matches = walk(m, tu.cursor)


Install a recent version of Clang and the python libclang bindings. On Ubuntu Trusty, you can install pre-built binaries from the LLVM apt repositories:

wget -O - | sudo apt-key add -
echo "deb llvm-toolchain-trusty-3.8 main" | sudo tee -a /etc/apt/sources.list
sudo apt-get update -qq
sudo apt-get install -y python-clang-3.8 libclang1-3.8

To run glud, you’ll need to make sure that is on your loader path.

export LD_LIBRARY_PATH=/usr/lib/llvm-3.8/lib


You can install the latest stable version from PyPI

$ pip install glud

Or, you can install the latest development version from GitHub

$ pip install git+git://


This project is in no way affiliated with the LLVM Team or the University of Illinois at Urbana-Champaign.


If you experience problems with glud, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for glud, version 0.3.3
Filename, size File type Python version Upload date Hashes
Filename, size glud-0.3.3.tar.gz (8.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page