NAME

Net::FTP::Path::Iter - Iterative, recursive, FTP file finder

VERSION

version 0.07

SYNOPSIS

            

              
              
use Net::FTP::Path::Iter;
# connect to the FTP site
my $ftp = Net::FTP::Path::Iter->new( $ftp_site, $user, $password );
# define a visitor callback routine. It will recieve a
# Net::FTP::Path::Iter::Entry object.
sub visitor { my ($entry) = @_ }
# use the Path::Iterator::Rule all() method to traverse the
# site;
$ftp->all( '/', \&visitor );
            
          

DESCRIPTION

Net::FTP::Path::Iter is a subclass of Path::Iterator::Rule which iterates over an FTP site rather than a local filesystem.

See the documentation Path::Iterator::Rule for how to filter and traverse paths. When Net::FTP::Path::Iter passes a path to a callback or returns one from an iterator, it will be in the form of a Net::FTP::Path::Iter::Entry object.

Net::FTP::Path::Iter uses Net::FTP to connect to the FTP site.

Symbolic Links

At present, Net::FTP::Path::Iter does not handle symbolic links. It will output an error and skip them.

METHODS

new

            

              
              
$ftp = Net::FTP::Path::Iter->new( [$host], %options );
            
          

Open up a connection to an FTP host and log in. The arguments are the same as for "new" in Net::FTP, with the addition of two mandatory options,

user

The user name

password

The password

INTERNALS

ATTRIBUTES

Net::FTP::Path::Iter subclasses Path::Iter::Rule. It is a hash based object and has the following additional attributes:

server

The Net::FTP object representing the connection to the FTP server.

SUPPORT

Bugs

Please report any bugs or feature requests to bug-net-ftp-path-iter@rt.cpan.org or through the web interface at: https://rt.cpan.org/Public/Dist/Display.html?Name=Net-FTP-Path-Iter

Source

Source is available at

            

              
              
https://gitlab.com/djerius/net-ftp-path-iter
            
          

and may be cloned from

            

              
              
https://gitlab.com/djerius/net-ftp-path-iter.git
            
          

AUTHOR

Diab Jerius <djerius@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2017 by Smithsonian Astrophysical Observatory.

This is free software, licensed under:

            

              
              
The GNU General Public License, Version 3, June 2007
            
          

cpanm Net::FTP::Path::Iter

perl -MCPAN -e shell
install Net::FTP::Path::Iter