/ 
FFI-Build-0.12
River stage zero No dependents
/ FFI::Build::File::Base

NAME

FFI::Build::File::Base - Base class for File::Build files

VERSION

version 0.12

SYNOPSIS

Create your own file class

package FFI::Build::File::Foo;
use base qw( FFI::Build::File::Base );
use constant default_suffix => '.foo';
use constant default_encoding => ':utf8';

Use it:

# use an existing file in the filesystem
my $file = FFI::Build::File::Foo->new('src/myfile.foo');

# generate a temp file with provided content
# file will be deletd when $file falls out of scope.
my $file = FFI::Build::File::Foo->new(\'content for a temp foo');

DESCRIPTION

This class is the base class for other FFI::Build::File classes.

CONSTRUCTOR

new

my $file = FFI::Build::File::Base->new(\$content, %options);
my $file = FFI::Build::File::Base->new($filename, %options);

Create a new instance of the file class. You may provide either the content of the file as a scalar reference, or the path to an existing filename. Options:

base

The base name for any temporary file ffi_build_ by default.

build

The FFI::Build instance to use.

dir

The directory to store any temporary file.

platform

The FFI::Build::Platform instance to use.

METHODS

default_suffix

my $suffix = $file->default_suffix;

MUST be overridden in the subclass. This is the standard extension for the file type. .c for a C file, .o or .obj for an object file depending on platform. etc.

default_encoding

my $encoding = $file->default_encoding;

MUST be overridden in the subclass. This is the passed to binmode when the file is opened for reading or writing.

accept_suffix

my @suffix_list = $file->accept_suffix;

Returns a list of regexes that recognize the file type.

path

my $path = $file->path;

The full or relative path to the file.

basename

my $basename = $file->basename;

The base filename part of the path.

dirname

my $dir = $file->dirname;

The directory part of the path.

is_temp

my $bool = $file->is_temp;

Returns true if the file is temporary, that is, it will be deleted when the file object falls out of scope. You can call keep, to keep the file.

platform

my $platform = $file->platform;

The FFI::Build::Platform instance used for this file object.

build

my $build = $file->build;

The FFI::Build instance used for this file object, if any.

native

my $path = $file->native;

Returns the operating system native version of the filename path. On Windows, this means that forward slash \ is used instead of backslash /.

slurp

my $content = $file->slurp;

Returns the content of the file.

keep

$file->keep;

Turns off the temporary flag on the file object, meaning it will not automatically be deleted when the file object is deallocated or falls out of scope.

build_item

$file->build_item;

Builds the file into its natural output type, usually an object file. It returns a new file instance, or if the file is an object file then it returns empty list.

needs_rebuild

my $bool = $file->needs_rebuild

ld

AUTHOR

Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2018 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.