FTP client for Rust
FTPS support is disabled by default. To enable it secure
should be activated in Cargo.toml
.
[dependencies]
async_ftp = { version = "<version>", features = ["secure"] }
use std::str;
use std::io::Cursor;
use async_ftp::FtpStream;
async fn async_main() -> Result<(), Box<dyn std::error::Error>> {
// Create a connection to an FTP server and authenticate to it.
let mut ftp_stream = FtpStream::connect("172.25.82.139:21").await?;
let _ = ftp_stream.login("username", "password").await?;
// Get the current directory that the client will be reading from and writing to.
println!("Current directory: {}", ftp_stream.pwd().await?);
// Change into a new directory, relative to the one we are currently in.
let _ = ftp_stream.cwd("test_data").await?;
// Retrieve (GET) a file from the FTP server in the current working directory.
let remote_file = ftp_stream.simple_retr("ftpext-charter.txt").await?;
println!("Read file with contents\n{}\n", str::from_utf8(&remote_file.into_inner()).await?);
// Store (PUT) a file from the client to the current working directory of the server.
let mut reader = Cursor::new("Hello from the Rust \"ftp\" crate!".as_bytes());
let _ = ftp_stream.put("greeting.txt", &mut reader).await?;
println!("Successfully wrote greeting.txt");
// Terminate the connection to the server.
let _ = ftp_stream.quit();
}
fn main() -> Result<(), Box<dyn std::error::Error>> {
tokio::runtime::Builder::new()
.threaded_scheduler()
.enable_all()
.build()
.unwrap()
.block_on(async_main())
}
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
All you need to develop rust-ftp and run the tests is Rust and Docker.
The tests
folder contains a Dockerfile
that installs and configures
the vsftpd server.
To create the Docker image:
docker build -t ftp-server tests
To start the FTP server that is tested against:
tests/ftp-server.sh
This script runs the ftp-server
image in detached mode and starts the vsftpd
daemon. It binds ports 21 (FTP) as well as the range 65000-65010 for passive connections.
Once you have an instance running, to run tests type:
cargo test
The following commands can be useful:
# List running containers of ftp-server image
# (to include stopped containers use -a option)
docker ps --filter ancestor=ftp-server
# To stop and remove a container
docker stop container_name
docker rm container_name
# To remove the image
docker rmi ftp-server