NAME
Catmandu::FileBag - A Catmandu::FileStore compartment to persist binary data
SYNOPSIS
use Catmandu;
my $store = Catmandu->store('Simple' , root => 't/data');
# List all containers
$store->bag->each(sub {
my $container = shift;
print "%s\n" , $container->{_id};
});
# Add a new folder
$store->bag->add({ _id => '1234' });
# Get the files
my $files = $store->bag->files('1234');
# Add a file to the files
$files->upload(IO::File->new('<foobar.txt'), 'foobar.txt');
# Stream the contents of a file
my $file = $files->get('foobar.txt');
$files->stream(IO::File->new('>foobar.txt'), $file);
# Delete a file
$files->delete('foobar.txt');
# Delete a folder
$store->index->delete('1234');DESCRIPTION
Each Catmandu::FileBag is a Catmandu::Bag and inherits all its methods.
METHODS
upload($io, $file_name)
An helper application to add an IO::Handle $io to the Catmandu::FileBag. Returns the number of bytes written.
stream($io, $file)
A helper application to stream the contents of a Catmandu::FileBag item to an IO::Handle. Returns the number of bytes written.
as_string($file)
Return the contents of the Catmandu::FileBag item as a string.
as_string_utf8($file)
Return the contents of the Catmandu::FileBag item as an UTF-8 string.