【每周一库】rust-ftp-an FTP client written in Rust

本期的每周一库带来的是Rust下的ftp client库：rust-ftp

相关链接

rust-ftp docs: https://docs.rs/ftp/3.0.1/ftp/

rust-ftp github: https://github.com/mattnenterprise/rust-ftp

rust-ftp的文档页面给出了使用的用例，从代码来看非常简单，下面我们通过实际使用来体验rust-ftp库。

开发环境

Windows 10

rustc --version: rustc 1.46.0-nightly (6bb3dbfc6 2020-06-22)

cargo --version: cargo 1.46.0-nightly (089cbb80b 2020-06-15)

rust-ftp version: 3.0.1

通过FileZilla Server来体验rust-ftp的功能

首先我们下载FileZilla Server作为本地的ftp服务器程序

这里简单赘述一下FileZilla Server的配置，启动FileZilla Server之后

配置FileZilla Server的User

在下图右侧窗口添加一个User，用户名设置为admin，密码设置为admin

配置FileZilla Server的共享文件夹

配置完User之后，我们需要告诉FileZilla Server共享的目录在哪里，本例中我们使用了目录D:\Temp\ftpShare目录，配置完成之后如下图，需要注意添加刚才创建的admin用户

使用rust-ftp和FileZilla Server搭建的本地ftp服务器进行文件读取和上传

经过上面的FileZilla Server的配置，我们在本地已经有了一个运行的ftp服务器，服务器的跟目录在本例中为D:\Temp\ftpShare目录

我们创建一个新的rust工程

cargo new hello-rustftp

在工程的Cargo.toml文件中添加引用

[dependencies]

ftp = { version="3.0.1"}

修改src/main.rs文件内容如下

extern crate ftp;

use std::str;

use std::io::Cursor;

use ftp::FtpStream;

fn main() {

println!("Hello rust-ftp!");

// Create a connection to an FTP server and authenticate to it.

let mut ftp_stream = FtpStream::connect("127.0.0.1:21").unwrap();

let _ = ftp_stream.login("admin", "admin").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("rust.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("hello-rustftp.txt", &mut reader);

println!("Successfully upload hello-rustftp.txt");

// Terminate the connection to the server.

let _ = ftp_stream.quit();

}

上面的代码做了三件事

使用用户名admin，密码admin（刚才在FileZella Server中配置的User身份）连接本地ftp服务器

切换到本地ftp服务器目录的test_data目录读取其中名为rust.txt文件内容

向ftp服务器目录的test_data目录写入一个名为hello-rustftp.txt文件，文件内容为Hello from the Rust "ftp" crate!

既然我们的rust程序要在ftp服务器跳转到目录test_data并读取其中的rust.txt文件，那么我们首先要在我们的ftp服务器中创建名为test_data的目录和rust.txt文件

其中我们向文件rust.txt文件中写入内容

ftp服务器根目录（本例中为：D:\Temp\ftpShare文件夹）的目录结构为：

到这里我们就配置完了本地ftp服务器的目录结构，我们可以运行我们的rust程序进行测试

使用命令cargo build编译工程，使用命令cargo run运行

同时我们的ftp服务器本地目录D:\Temp\ftpShare\test_data\中会出现我们新上传的hello-rustftp.txt文件

到这里我们完成了rust-ftp库的简单使用。