fastsync 0.10.1

A fast, safe one-way directory synchronization tool for local folders and network transfers.
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

use std::path::Path;

use crate::i18n::{Language, tr};
use crate::summary::{human_bytes, human_duration};

use super::{SyncDirection, util::throughput_text};

/// 共享端一次会话的最终结果；拒绝时携带面向日志/调用者的原因。
#[derive(Debug)]
pub(super) enum ShareOutcome {
    Completed(TransferSummary),
    Rejected(String),
}

/// 一次完整网络传输的统计信息，作为双方摘要和 Ack 的统一数据源。
#[derive(Debug)]
pub(super) struct TransferSummary {
    pub(super) direction: SyncDirection,
    pub(super) files: usize,
    pub(super) bytes: u64,
    pub(super) deleted: usize,
    pub(super) file_concurrency: usize,
    pub(super) elapsed_ms: u128,
}

/// 接收端实际落盘后的结果，用于返回给发送端确认。
#[derive(Debug)]
pub(super) struct ReceiveSummary {
    pub(super) files: usize,
    pub(super) bytes: u64,
    pub(super) deleted: usize,
}

/// 摘要渲染视角；同一传输在共享端和连接端展示不同角色。
#[derive(Debug, Clone, Copy)]
pub(super) enum NetworkSide {
    Share,
    Connect,
}

/// 可本地化的网络会话摘要输入；字段保持机器统计值，渲染时再格式化。
pub(super) struct NetworkSummary<'a> {
    pub(super) side: NetworkSide,
    pub(super) direction: SyncDirection,
    pub(super) directory: &'a Path,
    pub(super) remote: &'a str,
    pub(super) files: usize,
    pub(super) bytes: u64,
    pub(super) deleted: usize,
    pub(super) file_concurrency: usize,
    pub(super) elapsed_ms: u128,
}

impl NetworkSummary<'_> {
    /// 渲染网络会话摘要；只使用双方都能可靠得知的传输结果。
    pub(super) fn to_text(&self, language: Language) -> String {
        let side = match self.side {
            NetworkSide::Share => tr(language, "network.summary.side_share"),
            NetworkSide::Connect => tr(language, "network.summary.side_connect"),
        };
        let direction = match self.direction {
            SyncDirection::Pull => tr(language, "network.summary.direction_pull"),
            SyncDirection::Push => tr(language, "network.summary.direction_push"),
        };

        format!(
            "\
fastsync {}

{}
  {}  {}
  {}  {}
  {}  {}
  {}  {}
  {}  {}

{}
  {}  {}
  {}  {}
  {}  {}
  {}  {}
  {}  {}
",
            tr(language, "network.summary.title"),
            tr(language, "network.summary.session"),
            tr(language, "network.summary.side"),
            side,
            tr(language, "network.summary.direction"),
            direction,
            tr(language, "network.summary.directory"),
            self.directory.display(),
            tr(language, "network.summary.remote"),
            self.remote,
            tr(language, "network.summary.concurrency"),
            self.file_concurrency,
            tr(language, "network.summary.result"),
            tr(language, "network.summary.files"),
            self.files,
            tr(language, "network.summary.data"),
            human_bytes(self.bytes),
            tr(language, "network.summary.deleted"),
            self.deleted,
            tr(language, "network.summary.duration"),
            human_duration(self.elapsed_ms),
            tr(language, "network.summary.throughput"),
            throughput_text(self.bytes, self.elapsed_ms),
        )
    }
}