canic 0.25.10

Canic — a canister orchestration and management toolkit for the Internet Computer
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

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

// Returns the repository root so release-facing scripts can be read from disk.
fn workspace_root() -> PathBuf {
    Path::new(env!("CARGO_MANIFEST_DIR"))
        .parent()
        .expect("crate directory should have a parent")
        .parent()
        .expect("workspace root should exist")
        .to_path_buf()
}

// Reads a checked-in text fixture from the repository root.
fn read_text(path: &Path) -> String {
    fs::read_to_string(path)
        .unwrap_or_else(|err| panic!("failed to read {}: {err}", path.display()))
}

// Reads the current workspace package version from the root Cargo manifest.
fn workspace_version() -> String {
    let cargo_toml_path = workspace_root().join("Cargo.toml");
    let cargo_toml = read_text(&cargo_toml_path);
    let parsed: toml::Table = cargo_toml
        .parse()
        .unwrap_or_else(|err| panic!("failed to parse {}: {err}", cargo_toml_path.display()));

    parsed
        .get("workspace")
        .and_then(|value| value.as_table())
        .and_then(|table| table.get("package"))
        .and_then(|value| value.as_table())
        .and_then(|table| table.get("version"))
        .and_then(|value| value.as_str())
        .expect("workspace.package.version must be a string")
        .to_string()
}

// Returns the canonical tagged raw install-script URL for the current release.
fn tagged_install_script_url() -> String {
    let workspace_version = workspace_version();
    format!(
        "https://raw.githubusercontent.com/dragginzgame/canic/v{workspace_version}/scripts/install.sh"
    )
}

// Keeps the curlable installer pinned to the same version as the current workspace release.
#[test]
fn install_script_default_installer_version_matches_workspace_version() {
    let install_script_path = workspace_root().join("scripts/install.sh");
    let install_script = read_text(&install_script_path);
    let workspace_version = workspace_version();
    let expected =
        format!("CANIC_INSTALLER_VERSION=\"${{CANIC_INSTALLER_VERSION:-{workspace_version}}}\"");

    assert!(
        install_script.contains(&expected),
        "expected {} to contain `{expected}`",
        install_script_path.display()
    );
}

// Keeps the root README setup curl command aligned with the current release tag.
#[test]
fn root_readme_install_url_matches_workspace_version() {
    let readme_path = workspace_root().join("README.md");
    let readme = read_text(&readme_path);
    let expected = tagged_install_script_url();

    assert!(
        readme.contains(&expected),
        "expected {} to contain `{expected}`",
        readme_path.display()
    );
}

// Keeps the installer crate README setup curl command aligned with the current release tag.
#[test]
fn installer_readme_install_url_matches_workspace_version() {
    let readme_path = workspace_root().join("crates/canic-installer/README.md");
    let readme = read_text(&readme_path);
    let expected = tagged_install_script_url();

    assert!(
        readme.contains(&expected),
        "expected {} to contain `{expected}`",
        readme_path.display()
    );
}

// Keeps the root README's explicit installer version example aligned with the current release.
#[test]
fn root_readme_installer_version_matches_workspace_version() {
    let readme_path = workspace_root().join("README.md");
    let readme = read_text(&readme_path);
    let workspace_version = workspace_version();
    let expected = format!("- `canic-installer` `{workspace_version}`");

    assert!(
        readme.contains(&expected),
        "expected {} to contain `{expected}`",
        readme_path.display()
    );
}