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


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 the Net::FTP manpage.


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

the Net::FTP manpage

the Tie::FTP manpage

the Net::FTP::Common manpage

the IO::FTP manpage


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.

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