【每周一库】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库的简单使用。

  • 发表于:
  • 原文链接https://kuaibao.qq.com/s/20200807A0WBOS00?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 yunjia_community@tencent.com 删除。

扫码关注云+社区

领取腾讯云代金券