rcp-tools-common 0.33.0

Internal library for RCP file operation tools - shared utilities and core operations (not intended for direct use)
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

//! Dry-run reporting helpers shared by copy, link, and rm operations.

use crate::config::DryRunMode;
use crate::filter::{FilterResult, TimeSkipReason};

/// Reports a dry-run action (would copy/link/remove) to stdout.
/// When `dst` is `None`, prints only the source path (used by rm).
pub fn report_action(
    verb: &str,
    src: &std::path::Path,
    dst: Option<&std::path::Path>,
    entry_type: &str,
) {
    match dst {
        Some(dst) => println!("would {} {} {:?} -> {:?}", verb, entry_type, src, dst),
        None => println!("would {} {} {:?}", verb, entry_type, src),
    }
}

/// Reports a skipped entry during dry-run to stdout.
/// Respects dry-run mode: Brief suppresses, All shows path, Explain shows reason.
pub fn report_skip(
    path: &std::path::Path,
    result: &FilterResult,
    mode: DryRunMode,
    entry_type: &str,
) {
    match mode {
        DryRunMode::Brief => { /* brief mode doesn't show skipped files */ }
        DryRunMode::All => {
            println!("skip {} {:?}", entry_type, path);
        }
        DryRunMode::Explain => match result {
            FilterResult::ExcludedByDefault => {
                println!(
                    "skip {} {:?} (no include pattern matched)",
                    entry_type, path
                );
            }
            FilterResult::ExcludedByPattern(pattern) => {
                println!("skip {} {:?} (excluded by '{}')", entry_type, path, pattern);
            }
            FilterResult::Included => { /* shouldn't happen */ }
        },
    }
}

/// Returns a human-readable skip reason for a FilterResult.
/// Returns None for Included (which is not a skip).
/// Used by the remote dry-run path to format structured log messages.
pub fn format_skip_reason(result: &FilterResult) -> Option<String> {
    match result {
        FilterResult::Included => None,
        FilterResult::ExcludedByDefault => Some("no include pattern matched".to_string()),
        FilterResult::ExcludedByPattern(p) => Some(format!("excluded by '{}'", p)),
    }
}

/// Reports an entry skipped by a time filter during dry-run to stdout.
/// Respects dry-run mode: Brief suppresses, All shows path, Explain shows reason.
pub fn report_time_skip(
    path: &std::path::Path,
    reason: TimeSkipReason,
    mode: DryRunMode,
    entry_type: &str,
) {
    match mode {
        DryRunMode::Brief => { /* brief mode doesn't show skipped entries */ }
        DryRunMode::All => {
            println!("skip {} {:?}", entry_type, path);
        }
        DryRunMode::Explain => {
            let reason_str = match reason {
                TimeSkipReason::TooNewModified => "mtime is too recent",
                TimeSkipReason::TooNewCreated => "btime is too recent",
                TimeSkipReason::TooNewBoth => "mtime and btime are too recent",
            };
            println!("skip {} {:?} ({})", entry_type, path, reason_str);
        }
    }
}