ExtUtils::Builder::BuildTools::Base(3)

NAME
ExtUtils::Builder::BuildTools::Base - A base class for BuildTools implementations.

VERSION
version 0.036

DESCRIPTION
This is a base-class for providers of compiler configuration. It defines the following delegates:

  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:

    •   executable

        An executable to be run. This is the default.

    •   static-library

        A static library to link against.

    •   shared-library

        A dynamic library to link against.

    •   loadable-object

        A loadable extension. On most platforms this is the same as a dynamic library, but some (Mac) make a distinction between these two.

    Note that if you first compile for a static library that will later be linked into a shared library, you need to pick 'shared-library' here.

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.

AUTHOR
Leon Timmermans <fawaka@gmail.com>

COPYRIGHT AND LICENSE
This software is copyright (c) 2012 by Leon Timmermans.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.