FFI::Clang

A light-weight wrapper for Ruby exposing libclang. This project is currently tested with Clang/libclang 18 and higher.

Add this line to your application's Gemfile:

gem 'ffi-clang'

And then execute:

$ bundle

Or install it yourself as:

$ gem install ffi-clang

Please see the project documentation for more details.

The following environment variables can be used to configure how ffi-clang finds libclang and its resources:

For example, to use a specific LLVM installation:

LLVM_CONFIG=llvm-config-17 bundle exec bake test

Please see the project releases for all releases.

• Platform Support
• Breaking Changes
• Bug Fixes
• New APIs

• Helper method that returns a cursor's FFI::Clang::Cursor#qualified_display_name.
• Add release notes and documentation tooling.
• Modernize code and achieve 100% documentation coverage.
• Update minimum Ruby version to 3.2.

• Add support for clang_Type_getNamedType. (#90)
• Try clang v18 + add Ruby v3.4 to test matrix. (#91)

• Prefer LIBCLANG and LLVM_CONFIG overrides over Xcode. (#88)

• Restore visit_children method. Fixes #82. (#84)
• Expose Clang's exception specification API. (#87)
• Support iterating over Type::Function args and expose Lib.get_non_reference_type. (#85)
• Fix qualified name. (#83)
• Update clang version. (#86)

• Expose libclang's anonymous methods. (#79)
• Use Enumerable. (#80)
• Split FFI::Clang::Type into a number of more cohesive subclasses inheriting from FFI::Clang::Types::Type. (#81)

• Remove duplicate mapping of clang_getEnumDeclIntegerType. (#67)
• Update bitmask options based on enums to always be an array of symbols. (#69)
• Add support for parse_translation_unit2 API. (#70)
• Cursor improvements, Type improvements, Printing support. (#72)
• Fix finalizer exception in FFI::Clang::CodeCompletion::Results. (#74)
• Fix Clang 16 compatibility. (#76)
• Cursor location methods. (#78)

• Modernize gem. (#58)
• Test on clang 5.0+. (#59)
• Fix CXCursor_TranslationUnit enum value to 350. (#61)
• Add Cursor#hash and Cursor#eql?. (#62)
• Set cursor_translation_unit enum value based on the Clang version. (#64)
• Add various C++ introspection methods. (#66)

• Fix incorrect return type of clang_getTranslationUnitSpelling.
• Fix compilation_database_spec.
• Fix libclang lookup for Xcode.
• Fix warning on class re-definition.
• Update cursor kinds.
• Find libclang.dll under Windows.
• Allow retrieval of list of references from a Cursor.
• Implement libclang findReferencesInFile functionality.
• Allow TranslationUnit#file to return the main file.

• Add missing translation unit parse flags.

We welcome contributions to this project.

1. Fork it.
2. Create your feature branch (git checkout -b my-new-feature).
3. Commit your changes (git commit -am 'Add some feature').
4. Push to the branch (git push origin my-new-feature).
5. Create new Pull Request.

To run the test suite:

bundle exec sus

To make a new release:

bundle exec bake gem:release:patch # or minor or major

In order to protect users of this project, we require all contributors to comply with the Developer Certificate of Origin. This ensures that all contributions are properly licensed and attributed.

This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.