fs-more 0.8.1

Convenient file and directory operations with progress reporting built on top of std::fs.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

use fs_more::error::FileRemoveError;
use fs_more_test_harness::{
    prelude::*,
    trees::structures::{empty::EmptyTree, simple::SimpleTree},
};




#[test]
fn remove_file_deletes_file() {
    let harness = SimpleTree::initialize();

    let removal_result = fs_more::file::remove_file(harness.yes.hello_world_txt.as_path());


    assert!(
        removal_result.is_ok(),
        "failed to remove file: expected Ok, got {}",
        removal_result.unwrap_err()
    );

    harness.empty_txt.assert_exists();
    harness.yes.hello_world_txt.assert_not_exists();

    harness.destroy();
}



#[test]
fn remove_file_does_not_follow_symlinks() {
    let harness = SimpleTree::initialize();
    let secondary_harness = SimpleTree::initialize();

    harness.empty_txt.assert_is_file_and_remove();
    harness.empty_txt.assert_not_exists();

    secondary_harness.empty_txt.assert_is_file_and_not_symlink();
    harness
        .empty_txt
        .symlink_to_file(secondary_harness.empty_txt.as_path());
    harness
        .empty_txt
        .assert_is_valid_symlink_to_file_and_destination_matches(
            secondary_harness.empty_txt.as_path(),
        );

    let captured_symlink_destination_file = secondary_harness.empty_txt.capture_with_content();


    fs_more::file::remove_file(harness.empty_txt.as_path()).unwrap();


    harness.empty_txt.assert_not_exists();
    captured_symlink_destination_file.assert_unchanged();


    harness.destroy();
}



#[test]
fn remove_file_errors_on_non_existent_file() {
    let harness = EmptyTree::initialize();

    let non_existent_file = harness.child_path("hello-world.txt");
    non_existent_file.assert_not_exists();


    let removal_result = fs_more::file::remove_file(&non_existent_file);


    assert!(
        removal_result.is_err(),
        "failed to error on file removal: expected Err, got Ok"
    );

    assert_matches!(
        removal_result.unwrap_err(),
        FileRemoveError::NotFound { path }
        if paths_equal_no_unc(&path, non_existent_file)
    );


    harness.destroy();
}