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.

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,2013 David Nicol

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

Version 0.03 issues a spurious PASS for all tests when the hardcoded FTP server that has been getting small test files blatted to it for the last decade is down.

If you would like to propose modifications (such as integrating a pure-perl FTP server running on localhost into the testing) this module may be cloned from https://github.com/davidnicol/cpan-Net-FTP-blat