4. Binding Project File

Instead of directing the Generator behaviour via command line, the binding developer can write a text project file describing the same information, and avoid the hassle of a long stream of command line arguments.

4.1. The project file structure

Here follows a comprehensive example of a generator project file.

[generator-project]
generator-set = path/to/generator/CHOICE_GENERATOR
header-file = DIR/global.h" />
typesystem-file = DIR/typesystem_for_your_binding.xml
output-directory location="OUTPUTDIR" />
include-path = path/to/library/being/wrapped/headers/1
include-path = path/to/library/being/wrapped/headers/2
typesystem-path = path/to/directory/containing/type/system/files/1
typesystem-path = path/to/directory/containing/type/system/files/2
enable-parent-ctor-heuristic

4.2. Project file tags

The generator project file tags are in direct relation to the command line arguments. All of the current command line options provided by |project| were already seen on the The project file structure, for new command line options provided by additional generator modules (e.g.: qtdoc, Shiboken) could also be used in the generator project file following simple conversion rules.

For tags without options, just write as an empty tag without any attributes. Example:

--BOOLEAN-ARGUMENT

becomes

BOOLEAN-ARGUMENT

and

--VALUE-ARGUMENT=VALUE

becomes

VALUE-ARGUMENT = VALUE