FTP client for Rust
The original project, rust-ftp was unmaintained. I had to publish this library under another name, since I can say I'm the temporary maintainer of this crate, since I need it for TermSCP.
I will delete this crate from Crates registry if the author takes the ownership of the project again.
Update: the maintainer of rust-ftp is back to work on the library, so this repository will probably be closed soon.
FTPS support is achieved through rust-native-tls and is disabled by default. To enable it secure should be activated in Cargo.toml.
toml
[dependencies]
ftp4 = { version = "<version>", features = ["secure"] }
```rust extern crate ftp4;
use std::str; use std::io::Cursor; use ftp4::FtpStream;
fn main() { // Create a connection to an FTP server and authenticate to it. let mut ftpstream = FtpStream::connect("127.0.0.1:21").unwrap(); let _ = ftpstream.login("username", "password").unwrap();
// Get the current directory that the client will be reading from and writing to.
println!("Current directory: {}", ftp_stream.pwd().unwrap());
// Change into a new directory, relative to the one we are currently in.
let _ = ftp_stream.cwd("test_data").unwrap();
// Retrieve (GET) a file from the FTP server in the current working directory.
let remote_file = ftp_stream.simple_retr("ftpext-charter.txt").unwrap();
println!("Read file with contents\n{}\n", str::from_utf8(&remote_file.into_inner()).unwrap());
// 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);
println!("Successfully wrote greeting.txt");
// Terminate the connection to the server.
let _ = ftp_stream.quit();
}
```
Licensed under either of
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:
bash
docker build -t ftp-server tests
To start the FTP server that is tested against:
bash
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:
bash
cargo test
The following commands can be useful:
```bash
docker ps --filter ancestor=ftp-server
docker stop containername docker rm containername
docker rmi ftp-server ```