canic-backup 0.69.5

Manifest and orchestration primitives for Canic deployment backup and restore
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

//! Module: runner::operations::path
//!
//! Responsibility: derive and validate runner artifact paths.
//! Does not own: filesystem writes, checksum verification, or backup layout persistence.
//! Boundary: keeps operation temp paths bound to the configured backup root.

use crate::{persistence::BackupLayout, runner::BackupRunnerError};

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

pub(super) fn artifact_relative_path(canister_id: &str) -> String {
    safe_path_segment(canister_id)
}

pub(super) fn artifact_temp_path(root: &Path, canister_id: &str) -> PathBuf {
    root.join(format!("{}.tmp", safe_path_segment(canister_id)))
}

pub(super) fn ensure_expected_temp_path(
    layout: &BackupLayout,
    sequence: usize,
    target: &str,
    temp_path: &str,
) -> Result<(), BackupRunnerError> {
    let expected = artifact_temp_path(layout.root(), target);
    if Path::new(temp_path) != expected {
        return Err(BackupRunnerError::ArtifactTempPathMismatch {
            sequence,
            target_canister_id: target.to_string(),
            journal_path: temp_path.to_string(),
            expected_path: expected.display().to_string(),
        });
    }
    Ok(())
}

fn safe_path_segment(value: &str) -> String {
    value
        .chars()
        .map(|ch| match ch {
            'a'..='z' | 'A'..='Z' | '0'..='9' | '-' | '_' => ch,
            _ => '_',
        })
        .collect()
}