FFI::Probe::Runner::Builder(3pm)

Usage

 use FFI::Probe::Runner::Builder;
 my $builder = FFI::Probe::Runner::Builder->new
   dir => "/foo/bar",
 );
 my $exe = $builder->build;

version 2.10

This is a builder class for the FFI probe runner. It is mostly only of interest if you are hacking on FFI::Platypus itself.

The interface may and will change over time without notice. Use in external dependencies at your own peril.

 my $builder = FFI::Probe::Runner::Builder->new(%args);

Create a new instance.

dir: The root directory for where to place the probe runner files. Will be created if it doesn't already exist. The default makes sense for when FFI::Platypus is being built.

 my $dir = $builder->dir(@subdirs);

Returns a subdirectory from the builder root. Directory will be created if it doesn't already exist.

 my @cc = @{ $builder->cc };

The C compiler to use. Returned as an array reference so that it may be modified.

 my @ccflags = @{ $builder->ccflags };

The C compiler flags to use. Returned as an array reference so that it may be modified.

The C optimize flags to use. Returned as an array reference so that it may be modified.

 my @ld = @{ $builder->ld };

The linker to use. Returned as an array reference so that it may be modified.

 my @ldflags = @{ $builder->ldflags };

The linker flags to use. Returned as an array reference so that it may be modified.

 my @libs = @{ $builder->libs };

The library flags to use. Returned as an array reference so that it may be modified.

 my $file = $builder->file(@subdirs, $filename);

Returns a file in a subdirectory from the builder root. Directory will be created if it doesn't already exist. File will not be created.

 my $exe = $builder->exe;

The name of the executable, once it is built.

 my $source = $builder->source;

The C source for the probe runner.

 $builder->extract;

Extract the source for the probe runner.

 $builder->run($type, @command);

Runs the given command. Dies if the command fails.

 $builder->run($type, \@command, \@command, ...);

Runs the given commands in order until one succeeds. Dies if they all fail.

 my $exe = $builder->build;

Builds the probe runner. Returns the path to the executable.

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

4 releases since Debian 10 (Buster); the text changed 3 times.