Glud Documentation

Do you need to find something in a C++ file? Perhaps you’re generating bindings for C++ library, generating serialization code, collecting code-metrics or developing a style checker?

You can solve all of these problems using libclang, a library provided as part of Clang compiler. However, the challenge with libclang is that it’s easy to end up in a situation where the code you write can be difficult to write, compose and maintain.

Glud solves this problem by providing a higher level abstraction that makes it easier to find C++ constructs, inspired by libclangastmatchers.

Example

For example, to find all of the classes in C/C++ file:

import sys
import glud
matcher = glud.isClass()
translation_unit = glud.parse(sys.argv[1])
for cls in glud.walk(matcher, translation_unit.cursor):
    print(cls.type.spelling)

Contents

• Installation
  • Prerequisites
  • Installation with Pip
• Quickstart
  • What is an Abstract Syntax Tree?
  • Finding classes with methods
  • Composing Matchers
  • Further Reading
• API
  • Parsing
  • Traversal
  • AST Pretty Printing
  • Matchers
  • Definitions
• Changelog
  • Release History