NAME

FFI::Probe::Runner::Builder - Probe runner builder for FFI

VERSION

version 2.07

SYNOPSIS

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

DESCRIPTION

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.

CONSTRUCTORS

new

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.

METHODS

dir

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

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

cc

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

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

ccflags

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

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

optimize

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

ld

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

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

ldflags

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

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

libs

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

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

file

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.

exe

my $exe = $builder->exe;

The name of the executable, once it is built.

source

my $source = $builder->source;

The C source for the probe runner.

extract

$builder->extract;

Extract the source for the probe runner.

run

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

Runs the given command. Dies if the command fails.

run_list

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

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

build

my $exe = $builder->build;

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

AUTHOR

Author: Graham Ollis <plicease@cpan.org>

Contributors:

Bakkiaraj Murugesan (bakkiaraj)

Dylan Cali (calid)

pipcet

Zaki Mughal (zmughal)

Fitz Elliott (felliott)

Vickenty Fesunov (vyf)

Gregor Herrmann (gregoa)

Shlomi Fish (shlomif)

Damyan Ivanov

Ilya Pavlov (Ilya33)

Petr Písař (ppisar)

Mohammad S Anwar (MANWAR)

Håkon Hægland (hakonhagland, HAKONH)

Meredith (merrilymeredith, MHOWARD)

Diab Jerius (DJERIUS)

Eric Brine (IKEGAMI)

szTheory

José Joaquín Atria (JJATRIA)

Pete Houston (openstrike, HOUSTON)

COPYRIGHT AND LICENSE

This software is copyright (c) 2015-2022 by Graham Ollis.

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