NAME

Net::FTP::blat - more methods for Net::FTP Client class

SYNOPSIS

use Net::FTP;
use Net::FTP::blat;

# See Net::FTP for how to set up connection

# get a remote file to a scalar
$ftp->slurp(README => my $readme);

# put a scalar to a remote file
$ftp->blat( $blog_entry_text, "entry: ".localtime );

DESCRIPTION

Net::FTP::blat contains two additional methods for Net::FTP.

OVERVIEW

slurp and blat were written by altering get and put from Net::FTP to use a scalar instead of a local file for the local side of the transfer.

METHODS

slurp ( REMOTE_FILE [, LOCAL_SCALAR ] )

Slurp REMOTE_FILE from the server and store locally, into a scalar variable. Returns the value too, if you don't want to pass the destination in. Croaks on all errors. Warns on file-not-found before assigning undef, if warnings are in effect.

blat ( LOCAL_SCALAR, REMOTE_FILE )

Blat the local scalar into the named file on the remote server. The remote name is required. Returns the scalar, for use in assignment chaining. Croaks on errors.

Net::FTP error messages

Net::FTP error messages are not imported into the croak exceptions at this version. They may be in the future.

The Future

I would like to see slurp and blat included in the Net::FTP distribution. I was surprised that they (or equivalents) were not included.

If ever the probelms with AUTOLOAD and Net::FTP are resolved, in my opinion that would be a good time to add these methods.

AUTHOR

David Nicol <davidnico@cpan.org>

SEE ALSO

Net::FTP

Tie::FTP

Net::FTP::Common

IO::FTP

CREDITS

These methods are derived from the get and put methods in Net::FTP, by Graham Barr.

COPYRIGHT

Copyright 2003 David Nicol

These methods are free software; you can redistribute and/or modify them under the same terms as Perl itself.