rust-ftp

Rust的FTP客户端

文档

安装

默认情况下禁用了FTPS支持。要启用它，应在 Cargo.toml 中激活 secure。

[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())
}

许可证

许可方式为以下之一

• Apache License, Version 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测试。测试文件夹包含一个 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