David Nicol > Net-FTP-blat-0.03 > Net::FTP::blat

Download:
Net-FTP-blat-0.03.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.03   Source  

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

syntax highlighting: