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

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

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.02   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.

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.

syntax highlighting: