NAME

Net::SFTP::Foreign::Exceptional - wraps Net::SFTP::Foreign to throw exceptions on failure

VERSION

version 0.002

SYNOPSIS

    use Net::SFTP::Foreign::Exceptional;

    my $sftp;
    eval { $sftp = Net::SFTP::Foreign::Exceptional->new(host => 'sftp.example.com'); 1}
        or print "SFTP exception: $@\n";

DESCRIPTION

Subclass of Net::SFTP::Foreign that wraps many of its methods to throw exceptions instead of merely returning undef. Any methods not listed here simply call the superclass.

METHODS

BUILD

After new(), an exception will be thrown if there was a connection failure.

cwd

setcwd

get

get_content

get_symlink

put

put_symlink

ls

find

glob

rget

rput

rremove

mget

mput

open

close

read

write

readline

getc

seek

tell

eof

flush

sftpread

sftpwrite

opendir

closedir

readdir

stat

fstat

lstat

setstat

fsetstat

remove

mkdir

mkpath

rmdir

rename

atomic_rename

readlink

symlink

hardlink

statvs

fstatvs

SUPPORT

Perldoc

You can find documentation for this module with the perldoc command.

  perldoc Net::SFTP::Foreign::Exceptional

Websites

The following websites have more information about this module, and may be of help to you. As always, in addition to those websites please use your favorite search engine to discover more resources.

• Search CPAN

  The default CPAN search engine, useful to view POD in HTML format.

  http://search.cpan.org/dist/Net-SFTP-Foreign-Exceptional

• AnnoCPAN

  The AnnoCPAN is a website that allows community annonations of Perl module documentation.

  http://annocpan.org/dist/Net-SFTP-Foreign-Exceptional

• CPAN Ratings

  The CPAN Ratings is a website that allows community ratings and reviews of Perl modules.

  http://cpanratings.perl.org/d/Net-SFTP-Foreign-Exceptional

• CPANTS

  The CPANTS is a website that analyzes the Kwalitee ( code metrics ) of a distribution.

  http://cpants.perl.org/dist/overview/Net-SFTP-Foreign-Exceptional

• CPAN Testers

  The CPAN Testers is a network of smokers who run automated tests on uploaded CPAN distributions.

  http://www.cpantesters.org/distro/N/Net-SFTP-Foreign-Exceptional

• CPAN Testers Matrix

  The CPAN Testers Matrix is a website that provides a visual way to determine what Perls/platforms PASSed for a distribution.

  http://matrix.cpantesters.org/?dist=Net-SFTP-Foreign-Exceptional

• CPAN Testers Dependencies

  The CPAN Testers Dependencies is a website that shows a chart of the test results of all dependencies for a distribution.

  http://deps.cpantesters.org/?module=Net::SFTP::Foreign::Exceptional

Bugs / Feature Requests

Please report any bugs or feature requests through the web interface at https://github.com/mjgardner/net-sftp-foreign-exceptional/issues. You will be automatically notified of any progress on the request by the system.

Source Code

The code is open to the world, and available for you to hack on. Please feel free to browse it and play with it, or whatever. If you want to contribute patches, please send me a diff or prod me to pull from your repository :)

https://github.com/mjgardner/net-sftp-foreign-exceptional

  git clone git://github.com/mjgardner/net-sftp-foreign-exceptional.git

AUTHOR

Mark Gardner <mjgardner@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by GSI Commerce.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm Net::SFTP::Foreign::Exceptional

perl -MCPAN -e shell
install Net::SFTP::Foreign::Exceptional