fs-more

基于 std::fs 的便捷文件和目录操作，具有改进的错误处理和深入配置功能。包括具有进度报告的文件或目录的复制和移动。

主要功能

• 使用以下配置选项复制或移动文件或目录
  • （现有目标文件行为、复制深度、I/O 缓冲区大小等），以及
  • 进度报告（如果需要的话），
• 扫描目录（具有扫描深度和符号链接行为等选项），以及
• 计算文件或目录大小。

用法

要将 fs-more 添加到您的项目中，请将其指定为 Cargo.toml 文件中的依赖项

fs-more = "0.7.1"

示例

复制文件并获取进度更新

use std::path::Path;

use fs_more::file::CollidingFileBehaviour;
use fs_more::file::FileCopyWithProgressOptions;
use fs_more::file::FileCopyFinished;


let source_path = Path::new("./source-file.txt");
let destination_path = Path::new("./destination-file.txt");

let finished_copy = fs_more::file::copy_file_with_progress(
    source_path,
    destination_path,
    FileCopyWithProgressOptions {
        colliding_file_behaviour: CollidingFileBehaviour::Abort,
        ..Default::default()
    },
    |progress| {
        let percent_copied =
            (progress.bytes_finished as f64) 
            / (progress.bytes_total as f64 * 100.0);

        println!("Copied {:.2}% of the file!", percent_copied);
    }
).unwrap();

match finished_copy {
    FileCopyFinished::Created { bytes_copied } => {
        println!("Copied {bytes_copied} bytes into a fresh file!");
    }
    FileCopyFinished::Overwritten { bytes_copied } => {
        println!("Copied {bytes_copied} bytes over an existing file!");
    }
    // ... (see documentation) ...
    _ => {}
};

移动目录并获取进度更新

use std::path::Path;
use fs_more::directory::DirectoryMoveWithProgressOptions;
use fs_more::directory::DestinationDirectoryRule;


let source_path = Path::new("./source-directory");
let destination_path = Path::new("./destination-directory");

let moved = fs_more::directory::move_directory_with_progress(
    source_path,
    destination_path,
    DirectoryMoveWithProgressOptions {
        destination_directory_rule: DestinationDirectoryRule::AllowEmpty,
        ..Default::default()
    },
    |progress| {
        let percent_moved =
            (progress.bytes_finished as f64) / (progress.bytes_total as f64)
            * 100.0;
        println!(
            "Moved {:.2}% of the directory ({} files and {} directories so far).",
            percent_moved,
            progress.files_moved,
            progress.directories_created
        );
    }
).unwrap();

println!(
    "Moved {} bytes ({} files, {} directories)! Underlying strategy: {:?}.",
    moved.total_bytes_moved,
    moved.files_moved,
    moved.directories_moved,
    moved.strategy_used
);

功能标志

如何贡献

发现了一个bug，或者只是想通过开发新功能或编写测试来改进 fs-more？太棒了！请先阅读贡献指南：[CONTRIBUTING.md](https://github.com/simongoricar/fs-more/blob/master/CONTRIBUTING.md)。

许可证

根据以下任一许可证进行许可：

• Apache许可证，版本2.0（[LICENSE-APACHE](https://github.com/simongoricar/fs-more/blob/61a42e97129bd500d84f596113ce9d5b20400197/LICENSE-APACHE) 或 [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)）
• 麻省理工学院许可证（《LICENSE-MIT》或http://opensource.org/licenses/MIT）

根据您自己的选择。

贡献

除非您明确表示，否则根据Apache-2.0许可证定义的您有意提交以包含在作品中的任何贡献，应按上述方式双重许可，不附加任何额外条款或条件。