pmbs 0.1.1

(每分钟) 创建 btrfs 快照, 并自动清理. (Make btrfs snapshot (every minute), and auto clean)
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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

//! 安全删除快照 (btrfs subvol)
use std::process::Command;

use log::debug;
use regex::Regex;

use crate::{cli::sh_run, config::ConfigEnv};

/// 检查要删除的 subvol 路径.
///
/// 因为 btrfs 快照只是特殊的 subvol, 在删除快照时, 为了避免误删别的 subvol,
/// 此处额外增加了对目标路径的检查.
/// 只有结尾符合类似 `/.pmbs/2025/1756392923` 格式的 subvol 才会通过检查, 允许删除.
pub fn get_re_safe_check_path() -> Regex {
    // 年至少 4 位数字
    // 时间戳 (UNIX_EPOCH 开始的秒数) 至少 10 位数字
    Regex::new(r"/\.pmbs/[1-9][0-9]{3,}/[1-9][0-9]{9,}$").unwrap()
}

/// 删除 subvol (列表)
///
/// ## panic
///
/// + 如果有路径未通过检查
/// + 如果执行删除命令失败
pub fn safe_rm_subvol_list(config: &ConfigEnv, list: Vec<String>) {
    let re = get_re_safe_check_path();

    for i in list {
        debug!("check {}", i);

        if re.is_match(&i) {
            // 检查通过, 可以删除

            // 执行命令, 比如 btrfs subvol delete /home/.pmbs/2025/1756392923
            let mut c = Command::new(config.bin_btrfs.clone());
            c.arg("subvol").arg("delete").arg(&i);
            let code = sh_run(c);
            if 0 != code {
                panic!("can not rm subvol {}", i);
            }
        } else {
            // 错误路径 !
            panic!("bad subvol path {}", i);
        }
    }
}

/// 对正则表达式匹配进行测试
#[cfg(test)]
mod test_re {
    use super::*;

    // 正常匹配
    #[test]
    fn re_should_match() {
        let re = get_re_safe_check_path();

        assert_eq!(re.is_match("/home/.pmbs/2025/1756392923"), true);
        assert_eq!(re.is_match("/.pmbs/2025/1756392923"), true);
        assert_eq!(re.is_match("/.pmbs/9999/1756392923"), true);
        assert_eq!(re.is_match("/.pmbs/2025/9999999999"), true);
        assert_eq!(re.is_match("/.pmbs/10000/20000000000"), true);
    }

    // 不匹配: 空
    #[test]
    fn re_not_match_empty() {
        let re = get_re_safe_check_path();

        assert_eq!(re.is_match(""), false);
        assert_eq!(re.is_match("/"), false);
        assert_eq!(re.is_match("/.pmbs"), false);
        assert_eq!(re.is_match("/.pmbs/"), false);
        assert_eq!(re.is_match("/.pmbs//1756392923"), false);
        assert_eq!(re.is_match("/.pmbs/2025/"), false);
        assert_eq!(re.is_match("/.pmbs/2025"), false);
        assert_eq!(re.is_match("/.pmbs/2025"), false);
        assert_eq!(re.is_match("/2025/1756392923"), false);
        assert_eq!(re.is_match("2025/1756392923"), false);
        assert_eq!(re.is_match("//2025/1756392923"), false);
    }

    // 不匹配: 太短
    #[test]
    fn re_not_match_short() {
        let re = get_re_safe_check_path();

        assert_eq!(re.is_match("/.pmbs/1/1756392923"), false);
        assert_eq!(re.is_match("/.pmbs/20/1756392923"), false);
        assert_eq!(re.is_match("/.pmbs/202/1756392923"), false);
        assert_eq!(re.is_match("/.pmbs/0025/1756392923"), false);
        assert_eq!(re.is_match("/.pmbs/2025/175639292"), false);
        assert_eq!(re.is_match("/.pmbs/2025/17"), false);
        assert_eq!(re.is_match("/.pmbs/2025/56392923"), false);
        assert_eq!(re.is_match("/.pmbs/2025/0175639292"), false);
        assert_eq!(re.is_match("/pmbs/2025/1756392923"), false);
        assert_eq!(re.is_match("/.pbs/2025/1756392923"), false);
        assert_eq!(re.is_match("/.pmb/2025/1756392923"), false);
        assert_eq!(re.is_match("/.s/2025/1756392923"), false);
        assert_eq!(re.is_match("/./2025/1756392923"), false);
    }

    // 不匹配: 系统
    #[test]
    fn re_not_match_system() {
        let re = get_re_safe_check_path();

        assert_eq!(re.is_match("/"), false);
        assert_eq!(re.is_match("/home"), false);
        assert_eq!(re.is_match("/usr"), false);
        assert_eq!(re.is_match("/var"), false);
        assert_eq!(re.is_match("/etc"), false);
        assert_eq!(re.is_match("/mnt"), false);
        assert_eq!(re.is_match("/srv"), false);
        assert_eq!(re.is_match("/root"), false);
        assert_eq!(re.is_match("/boot"), false);
    }

    // 不匹配: 错误字符
    #[test]
    fn re_not_match_char() {
        let re = get_re_safe_check_path();

        assert_eq!(re.is_match("/.pmbs/2025/1756392923x"), false);
        assert_eq!(re.is_match("/.pmbs/2025/c1756392923"), false);
        assert_eq!(re.is_match("/.pmbs/2025/.1756392923"), false);
        assert_eq!(re.is_match("/.pmbs/2025/175_6392923"), false);
        assert_eq!(re.is_match("/.pmbs/2025/17563929-23"), false);
        assert_eq!(re.is_match("/.pmbs/.2025/1756392923"), false);
        assert_eq!(re.is_match("/.pmbs/2a25/1756392923"), false);
        assert_eq!(re.is_match("/.pmbs/202_/1756392923"), false);
        assert_eq!(re.is_match("/.pcbs/2025/1756392923"), false);
        assert_eq!(re.is_match("/.pmbb/2025/1756392923"), false);
        assert_eq!(re.is_match("/apmbs/2025/1756392923"), false);
    }
}