FFIG is a Foreign Function Interface Generator.
This project uses libclang to read existing C++ class definitions and create equivalent classes in other languages (primarily Python for now) and binds them to the C++ implementation.
While similar to SWIG, http://www.swig.org, FFIG does not need an interface generation language to be used nor do the bindings it generates depend on any binary details of an interpreter. FFIG Python bindings will run on PyPy, Python2 and Python3 without requiring changes.
FFIG is in early development. We welcome feedback from users but would encourage anyone looking to generate language bindings to look at SWIG.
You will need Python (2 or 3), ninja-build, cmake, and gcc (or clang).
You will need libclang >=3.8.
libclang can be installed from here: http://llvm.org/releases/
If you use a package manager to install libclang you may need to set up a symlink so that the name libclang.so exists.
Set LD_LIBRARY_PATH so that libclang can be found.
Install Xcode. FFIG will use the version of libclang distributed with Xcode.
Work in progress, minor issues expected.
The following steps will need to be performed for all build platforms.
Tests use the 'catch' test framework: https://github.com/philsquared/Catch.git
To get the submodule run:
git submodule update --init
Python package dependencies can be installed with
pip[3] install -r requirements.txt
Ruby dependencies can be installed with
gem install ffi
The build uses cmake driven by a simple Python script. To build and run tests, run the following from the console:
./scripts/build.py -t [--python-path=$(which python3)]
Build status (on Travis-CI):
Build status (on AppVeyor):
Please raise github issues if code cannot be generated where expected or if generated code does not behave as expected.
Contributions are very welcome, please look at unassigned github issues or raise issues for suggested improvements.
We have a Git pre-push hook, scripts/pre-push.py, which runs the code
formatting checks (scripts/codechecks.py) and prevents a push happening if
the code checks failed. This avoids a CI test cycle for simple formatting
errors.
To install this git hook, you can run scripts/install-git-hooks.py, which
will link the script into your .git/hooks directory.
We've made considerable use of the following in putting this together:
- http://szelei.me/code-generator
- http://blog.glehmann.net/2014/12/29/Playing-with-libclang
- http://eli.thegreenplace.net/tag/llvm-clang
Design of the python bindings is taken from clang's cindex.
Mistakes are our own.