Initialisation method which examines the filesystem path specified as a parameter and splits it into volume, directory and name.

Initialisation method which handles the encoding and codec options.

This method can be used to get or set the default encoding for a file.

$file->encoding(':utf8');

The encoding will affect all operations that read data from, or write data to the file.

The method can also be used to get or set the default encoding for a directory or filesystem. In this case the option specifies the default encoding for file contained therein.

$directory->encoding(':utf8');
$file = $directory->file('foo.txt');        # has :utf8 encoding set

This method can be used to get or set the codec used to serialise data to and from a file via the data() method. The codec should be specified by name, using any of the names that Badger::Codecs recognises or can load.

$file->codec('storable');

# first save the data to file
$file->data($some_data_to_save);

# later... load the data back out
my $data = $file->data;

You can use chained codec specifications if you want to pass the data through more than one codec.

$file->code('storable+base64');

See Badger::Codecs for further information on codecs.

As with encoding(), this method can also be used to get or set the default codec for a directory or filesystem.

$directory->codec('json');
$file = $directory->file('foo.json');       # has json codec set