compile($source, $target, %options)¶

This compiles $source to $target. It takes the following optional arguments:

type

The type of the final product. This must be one of:

profiles

A list of profile that can be used when compiling and linking. One profile comes with this distribution: '@Perl', which sets up the appropriate things to compile/link with "libperl".

include_dirs

A list of directories to add to the include path, e.g. "['include', '.']".

define

A hash of preprocessor defines, e.g. "{DEBUG => 1, HAVE_FEATURE => 0 }"

language

The language to use for compilation. Valid values are "C" or "C++".

standard

The language standard to use, e.g. "c99", "c11".

extra_args

A list of additional arguments to the compiler.

link(\@sources, $target, %options)¶

type

This works the same as with "compile".

profile

This works the same as with "compile".

language

This works the same as with "compile".

libraries

A list of libraries to link to. E.g. "['z']".

library_dirs

A list of directories to find libraries in. E.g. "['/opt/my-app/lib/']".

extra_args

A list of additional arguments to the linker.

object_file($basename, $dir = undef)¶

Given a basename this will return the matching object file name.

library_file($basename, $dir = undef)¶

Given a basename this will return the matching shared library file name.

static_library_file($basename, $dir = undef)¶

Given a basename this will return the matching static library file name.

loadable_file($basename, $dir = undef)¶

Given a basename this will return the matching loadable library file name.

executable_file($basename, $dir = undef)¶

Given a basename this will return the matching executable file name.