Generating sources

The Meson build system has moved

The new home of Meson's documentation is here. The information below is preserved only for posterity. It should be considered out of date.

---

Generating source files

Sometimes source files need to be preprocessed before they are passed to the actual compiler. As an example you might want build an IDL compiler and then run some files through that to generate actual source files. In Meson this is done with the following lines of code.

First we build the executable.

mycomp = executable('mycompiler', 'compiler.c')

Then we define a generator, which defines how to transform input files into output files.

gen = generator(mycomp,
 output    : '@BASENAME@.c',
 arguments : ['@INPUT@', '@OUTPUT@'])

The first argument is the executable file to run. The next file specifies a name generation rule. It specifies how to build the output file name for a given input name. @BASENAME@ is a placeholder for the input file name without preceding path or suffix (if any). So if the input file name were some/path/filename.idl, then the output name would be filename.c. You can also use @PLAINNAME@, which preserves the suffix which would result in a file called filename.idl.c. The last line specifies the command line arguments to pass to the executable. @INPUT@ and @OUTPUT@ are placeholders for the input and output files, respectively, and will be automatically filled in by Meson.

With this rule specified we can generate source files and add them to a target.

gen_src = gen.process('input1.idl', 'input2.idl')
executable('program', 'main.c', gen_src)

Generators can generate more than one output file.

gen2 = generator(someprog,
 outputs : ['@BASENAME@.c', '@BASENAME@.h'],
 arguments : ['--out_dir=@BUILD_DIR@', '@INPUT@']

In this case you can not use the @OUTPUT@ variable, as it would be ambiguous.

---

Back to index.