bindee is a best-effort, binding tool for generating C++-Python bindings.
bindee depends on two open source projects:
- Clang LibTooling: library for operating on the Clang AST
- pybind11: library for generating C++-Python bindings
bindee uses llvm-config, which should have been installed with Clang, to generate correct compilation flags.
After the correct versions of clang++ and llvm-config have been loaded:
$ make [EXTRA_FLAGS=compiler_flags] && make test
The EXTRA_FLAGS variable allow users to avoid specifying common compiler_flags for every bindee invocation (see below).
To bind all possible names:
$ ./bindee file.hh -- [compiler_flags]
compiler_flags is the set of flags you would use to normally compile file.hh, e.g. macro definitions or include paths.
To bind specific names:
$ ./bindee -d file.hh -- [compiler_flags]
$ # remove unnecessary lines in file.in
$ ./bindee -i file.in file.hh -- [compiler_flags]
After generating a bind file, replace any @TEXT@ strings until the code successfully compiles.
- Fails to qualify typedefs of namespaced, templated classes used in function signatures.
- Does not generate custom lambda bindings or trampolines.
Contributions may be made by creating a pull request into the master branch.
Bugfixes and features must be accompanied by a test.
bindee is distributed under the terms of the MIT license. All new contributions must be made under this license.
See LICENSE and NOTICE for details.
SPDX-License-Identifier: MIT
LLNL-CODE-803397