cc¶

 my $cc = cc;

Returns the ExtUtils::CChecker object used for testing.

This is mainly useful for adding compiler or linker flags:

 cc->push_extra_compiler_flags('-DFOO=1');
 cc->push_extra_linker_flags('-L/foo/bar/baz', '-lfoo')

compile_run_ok¶

 compile_run_ok $c_source;
 compile_run_ok $c_source, $message;
 compile_run_ok {
   source => $c_source,
   extra_compiler_flags => \@cflags,
   extra_linker_flags => \@libs,
 }, $message;

This test attempts to compile the given c source and passes if it runs with return value of zero. The first argument can be either a string containing the C source code, or a hashref (which will be passed unmodified as a hash to ExtUtils::CChecker "try_compile_run").

If the test fails, then the complete output will be reported using Test::More "diag".

You can have it report the output on success with "compile_output_to_diag" or "compile_output_to_note".

In addition to the pass/fail and diagnostic output, this function will return true or false on success and failure respectively.

compile_ok¶

 compile_ok $c_source, $message;
 compile_ok {
   source => $c_source,
   extra_compiler_flags => \@cflags,
 }, $message;

This is like "compile_run_ok", except it stops after compiling and does not attempt to link or run.

compile_with_alien¶

 use Alien::Foo;
 compile_with_alien 'Alien::Foo';

Specifies an Alien module to use to get compiler flags and libraries. You may pass in either the name of the class (it must already be loaded), or an instance of that class. The instance of the Alien class is expected to implement "cflags" and "libs" methods that return the compiler and library flags respectively.

If you are testing an Alien module after it has been built, but before it has been installed (for example if you are writing the test suite FOR the Alien module itself), you need to install to a temporary directory named "_test". If you are using Alien::Base, the easiest way to do this is to add a "make install" with "DISTDIR" set to "_test":

 Alien::Base::Module::Build->new(
   ...
   "alien_build_commands" => [
     "%pconfigure --prefix=%s",
     "make",
     "make DESTDIR=`pwd`/../../_test install",
   ],
   ...
 )->create_build_script;

or if you are using Dist::Zilla, something like this:

 [Alien]
 build_command = %pconfigure --prefix=%s --disable-bsdtar --disable-bsdcpio
 build_command = make
 build_command = make DESTDIR=`pwd`/../../_test install

compile_output_to_nowhere¶

 compile_output_to_nowhere

Do not report output unless there is a failure. This is the default behavior.

compile_output_to_diag¶

 compile_output_to_diag;

Report output using Test::More "diag" on success (output is always reported on failure using "daig").

compile_output_to_note¶

 compile_output_to_note;

Report output using Test::More "note" on success (output is always reported on failure using "diag").