NAME Test::FTP::Server - ftpd runner for tests SYNOPSIS use Test::TCP; use Test::FTP::Server; my $user = 'testuser'; my $pass = 'testpass'; my $root_directory = '/path/to/root_directory'; my $server = Test::FTP::Server->new( 'users' => [{ 'user' => $user, 'pass' => $pass, 'root' => $root_directory, }], 'ftpd_conf' => { 'port' => $port, 'daemon mode' => 1, 'run in background' => 0, }, ); $server->run; or use Test::TCP; use Test::FTP::Server; my $user = 'testuser'; my $pass = 'testpass'; my $sandbox_base = '/path/to/sandbox_base'; my $server = Test::FTP::Server->new( 'users' => [{ 'user' => $user, 'pass' => $pass, 'sandbox' => $sandbox_base, }], 'ftpd_conf' => { 'port' => $port, 'daemon mode' => 1, 'run in background' => 0, }, ); $server->run; DESCRIPTION "Test::FTP::Server" run "Net::FTPServer" internally. The server's settings can be specified as a parameter, therefore it is not necessary to prepare the configuration file. FUNCTIONS new Create a ftpd instance. %options "users" Definition of users. "user" and "pass" are used for login. If "root" is specified, ftpd behaves as if the specified directory is the root directory. If "sandbox" is specified, The content of sandbox is copied into the temporary directory, and ftpd behaves as if the temporary directory is the root directory. The content of sandbox never changes by the user's operation. It is necessary to specify "root" or "sandbox". "ftpd_conf" The settings that is usually specified in "/etc/ftpd.conf" when using Net::FTPServer. Specified by the hash reference. run Run a ftpd instance. EXAMPLE use Test::FTP::Server; use Test::TCP; use Net::FTP; my $user = 'testid'; my $pass = 'testpass'; my $sandbox_base = '/path/to/sandbox_base'; test_tcp( server => sub { my $port = shift; Test::FTP::Server->new( 'users' => [{ 'user' => $user, 'pass' => $pass, 'sandbox' => $sandbox_base, }], 'ftpd_conf' => { 'port' => $port, 'daemon mode' => 1, 'run in background' => 0, }, )->run; }, client => sub { my $port = shift; my $ftp = Net::FTP->new('localhost', Port => $port); ok($ftp); ok($ftp->login($user, $pass)); ok($ftp->quit); }, ); NOTES * Test::FTP::Server is for test use only. "root" and "sandbox" is not using chroot to keep available for any user. Therefore, there is a security risk when a server opened to the public. AUTHOR Taku Amano <taku@toi-planning.net> SEE ALSO Net::FTPServer LICENSE This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.