-
-
21 Oct 2021 11:53:53 UTC
- Distribution: Mojolicious
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues
- Testers (1961 / 52 / 38)
- Kwalitee
Bus factor: 6- 90.53% Coverage
- License: artistic_2
- Perl: v5.16.0
- Activity
24 month- Tools
- Download (821.64KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
NAME
Mojo::Asset::File - File storage for HTTP content
SYNOPSIS
use Mojo::Asset::File; # Temporary file my $file = Mojo::Asset::File->new; $file->add_chunk('foo bar baz'); say 'File contains "bar"' if $file->contains('bar') >= 0; say $file->slurp; # Existing file my $file = Mojo::Asset::File->new(path => '/home/sri/foo.txt'); $file->move_to('/yada.txt'); say $file->slurp;
DESCRIPTION
Mojo::Asset::File is a file storage backend for HTTP content.
EVENTS
Mojo::Asset::File inherits all events from Mojo::Asset.
ATTRIBUTES
Mojo::Asset::File inherits all attributes from Mojo::Asset and implements the following new ones.
cleanup
my $bool = $file->cleanup; $file = $file->cleanup($bool);
Delete "path" automatically once the file is not used anymore.
handle
my $handle = $file->handle; $file = $file->handle(IO::File->new);
Filehandle, created on demand for "path", which can be generated automatically and safely based on "tmpdir".
path
my $path = $file->path; $file = $file->path('/home/sri/foo.txt');
File path used to create "handle".
tmpdir
my $tmpdir = $file->tmpdir; $file = $file->tmpdir('/tmp');
Temporary directory used to generate "path", defaults to the value of the
MOJO_TMPDIR
environment variable or auto-detection.METHODS
Mojo::Asset::File inherits all methods from Mojo::Asset and implements the following new ones.
add_chunk
$file = $file->add_chunk('foo bar baz');
Add chunk of data.
contains
my $position = $file->contains('bar');
Check if asset contains a specific string.
get_chunk
my $bytes = $file->get_chunk($offset); my $bytes = $file->get_chunk($offset, $max);
Get chunk of data starting from a specific position, defaults to a maximum chunk size of
131072
bytes (128KiB).is_file
my $bool = $file->is_file;
True, this is a Mojo::Asset::File object.
move_to
$file = $file->move_to('/home/sri/bar.txt');
Move asset data into a specific file and disable "cleanup".
mtime
my $mtime = $file->mtime;
Modification time of asset.
new
my $file = Mojo::Asset::File->new; my $file = Mojo::Asset::File->new(path => '/home/sri/test.txt'); my $file = Mojo::Asset::File->new({path => '/home/sri/test.txt'});
Construct a new Mojo::Asset::File object.
size
my $size = $file->size;
Size of asset data in bytes.
slurp
my $bytes = $file->slurp;
Read all asset data at once.
to_file
$file = $file->to_file;
Does nothing but return the invocant, since we already have a Mojo::Asset::File object.
SEE ALSO
Module Install Instructions
To install Mojolicious, copy and paste the appropriate command in to your terminal.
cpanm Mojolicious
perl -MCPAN -e shell install Mojolicious
For more information on module installation, please visit the detailed CPAN module installation guide.