use strict;
use base 'Class::Accessor::Fast';
-use IO::File;
+use File::Copy ();
+use IO::File ();
__PACKAGE__->mk_accessors(qw/filename size tempname type/);
-sub new { shift->SUPER::new( ref( $_[0] ) ? $_[0] : {@_} ) }
=head1 NAME
=head1 SYNOPSIS
+ $upload->copy_to
$upload->fh
$upload->filename;
- $upload->link;
+ $upload->link_to;
$upload->size;
$upload->tempname;
$upload->type;
=head1 DESCRIPTION
-This is the Catalyst Request Upload class, which provides a set of accessors to the
-upload data.
+This is the Catalyst Request Upload class, which provides a set of accessors
+to the upload data.
=head1 METHODS
=over 4
+=item $upload->new
+
+Constructor. Normally only for engine use.
+
+=cut
+
+sub new { shift->SUPER::new( ref( $_[0] ) ? $_[0] : {@_} ) }
+
+=item $upload->copy_to
+
+Copies tempname using C<File::Copy>. Returns true for success, false otherwise.
+
+ $upload->copy_to('/path/to/target');
+
+=cut
+
+sub copy_to {
+ my $self = shift;
+ return File::Copy::copy( $self->tempname, @_ );
+}
+
=item $upload->fh
Opens tempname and returns a C<IO::File> handle.
sub fh {
my $self = shift;
- my $fh = IO::File->new( $self->tempname, O_RDONLY )
+ my $fh = IO::File->new( $self->tempname, IO::File::O_RDONLY )
or die( "Can't open ", $self->tempname, ": ", $! );
return $fh;
Contains client supplied filename.
-=item $upload->link
+=item $upload->link_to
-Creates a new filename linked to the old filename. Returns true for
-success, false otherwise.
+Creates a hard link to the tempname. Returns true for success,
+false otherwise.
- $upload->link('/my/path');
+ $upload->link_to('/path/to/target');
=cut
-sub link {
- my $self = shift;
- my $target = shift;
-
+sub link_to {
+ my ( $self, $target ) = @_;
return CORE::link( $self->tempname, $target );
}