rust-ftp

Rust的FTP客户端

文档

• rust-ftp
  • Ftp4，等等是什么
  • 安装
  • 用法
  • 许可证
    • 贡献
  • 开发环境

Ftp4，等等是什么

原始项目 rust-ftp 已不再维护。我不得不以另一个名字发布这个库，因为我是这个crate的临时维护者，因为我需要它用于TermSCP。

如果作者再次接管项目，我将从Crates注册表中删除这个crate。

更新：rust-ftp的维护者已重新开始维护库，因此这个仓库可能很快就会关闭。

安装

通过 rust-native-tls 实现了对FTPS的支持，默认情况下是禁用的。要启用它，应在 Cargo.toml 中激活 secure。

[dependencies]
ftp4 = { version = "<version>", features = ["secure"] }

用法

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 ftp_stream = FtpStream::connect("127.0.0.1:21").unwrap();
    let _ = ftp_stream.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();
}

许可证

根据您的选择，许可协议可以是以下之一

• Apache License，版本 2.0，(LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)
• MIT 许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

。

贡献

除非您明确说明，否则根据Apache-2.0许可证定义的，您提交的任何有意包含在本作品中的贡献，都将按上述方式双重许可，没有任何附加条款或条件。

开发环境

您只需要Rust和Docker就可以开发rust-ftp并运行测试。tests文件夹中包含一个Dockerfile，它安装并配置了vsftpd服务器。

要创建Docker镜像

docker build -t ftp-server tests

要启动测试中用到的FTP服务器

tests/ftp-server.sh

此脚本以分离模式运行ftp-server镜像，并启动vsftpd守护进程。它将端口21（FTP）以及被动连接的65000-65010范围内的端口绑定。

启动一个实例后，要运行测试，请键入

cargo test

以下命令可能有用

# 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