cfun 0.2.11

Tidy up common functions
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use std::{io, path::Path};

/// judge whether a file is exists
pub fn file_is_exist(file: &str) -> bool {
    let file = std::fs::metadata(file);
    file.is_ok_and(|f| f.is_file())
}

/// judge whether a file is exists
pub fn dir_is_exist(file: &str) -> bool {
    let file = std::fs::metadata(file);
    file.is_ok_and(|f| f.is_dir())
}

/// get file name of a path
pub fn file_name(path: &str) -> String {
    let p = Path::new(path);
    p.file_name()
        .unwrap_or_default()
        .to_string_lossy()
        .to_string()
}

/// get extension name of a file
pub fn file_ext(path: &str) -> String {
    let p = Path::new(path);
    p.extension()
        .unwrap_or_default()
        .to_string_lossy()
        .to_string()
}

/// ensure a file exist,if not exist,create it!
/// # example
/// ```
/// assert_eq!(true,ensure_file_exist("D:\\a\\b\\test.txt"));
/// ```
pub fn ensure_file_exist(file: &str) -> Result<(), io::Error> {
    let p = std::path::Path::new(file);
    let parent = p.parent();
    if let Some(parent) = parent {
        if !parent.exists() {
            std::fs::create_dir_all(parent)?;
        }
    };

    if !p.exists() || !p.is_file() {
        std::fs::File::create(p)?;
    }
    Ok(())
}

/// copy a file to new position
/// # example
/// ```
/// copy_file("test.txt","D:\\");
/// ```
pub fn copy_file(src_file: &str, des_dir: &str) -> Result<(), io::Error> {
    let mut src = std::fs::File::open(src_file)?;
    let name = file_name(src_file);
    let p = Path::new(des_dir);
    let p = p.join(name);
    let mut des = std::fs::File::create(p)?;
    std::io::copy(&mut src, &mut des)?;
    Ok(())
}
/// copy a file to new position
/// # example
/// ```
/// move_file("test.txt","D:\\test.txt");
/// ```
pub fn move_file(src: &str, des: &str) -> Result<(), io::Error> {
    std::fs::rename(src, des)?;
    Ok(())
}

/// get file size
/// # example
/// ```
/// let size=file_size("test.txt");
/// ```
pub fn file_size(file: &str) -> Result<u64, io::Error> {
    let metadata = std::fs::metadata(file)?;
    Ok(metadata.len())
}

#[test]
fn test_file_is_exist() {
    assert_eq!(true, file_is_exist("Cargo.toml"));
    assert_eq!(false, file_is_exist("Cargo.toml1"));
}

#[test]
fn test_dir_is_exist() {
    assert_eq!(true, dir_is_exist("src"));
    assert_eq!(false, dir_is_exist("src1"));
}

#[test]
fn test_file_name() {
    assert_eq!("Cargo.toml", file_name("Cargo.toml"));
    assert_eq!("Cargo", file_name("Cargo"));
}

#[test]
fn test_file_ext() {
    assert_eq!("toml", file_ext("Cargo.toml"));
    assert_eq!("", file_ext("Cargo"));
}

#[test]
fn test_ensure_file_exist() {
    assert_eq!(true, ensure_file_exist("D:\\a\\b\\test.txt").is_ok());
}

#[test]
fn test_copy_file() {
    assert_eq!(true, copy_file("Cargo.toml", ".\\target").is_ok());
}