zoi-cli 1.24.6

Advanced Package Manager & Environment Orchestrator
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

use anyhow::Result;
use clap::{Parser, Subcommand};

#[derive(Parser, Debug)]
pub struct HelperCommand {
    #[command(subcommand)]
    pub command: HelperCommands,
}

#[derive(Subcommand, Debug)]
pub enum HelperCommands {
    /// Get a hash of a local file or a file from a URL
    GetHash(GetHashCommand),

    /// Validate a Zoi specification file (e.g. registries.json, repo.yaml, advisories.json)
    #[command(alias = "val")]
    Validate(ValidateCommand),

    /// Internal: Perform escalated installation of a package node (requires root)
    #[command(hide = true)]
    ElevateInstallNode(ElevateInstallNodeCommand),

    /// Internal: Perform escalated uninstallation of a package (requires root)
    #[command(hide = true)]
    ElevateUninstall(ElevateUninstallCommand),
}

#[derive(Parser, Debug)]
pub struct ElevateInstallNodeCommand {
    /// Path to the JSON file containing the serialized InstallNode
    #[arg(long)]
    pub node_json: std::path::PathBuf,
    /// Path to the package archive (.zpa)
    #[arg(long)]
    pub archive: std::path::PathBuf,
    /// The install method used (e.g. "source", "pre-compiled")
    #[arg(long)]
    pub install_method: String,
    /// Automatically answer yes to prompts
    #[arg(long)]
    pub yes: bool,
    /// Whether to create shims for binaries
    #[arg(long)]
    pub link_bins: bool,
}

#[derive(Parser, Debug)]
pub struct ElevateUninstallCommand {
    /// Path to the JSON file containing the serialized InstallManifest
    #[arg(long)]
    pub manifest_json: std::path::PathBuf,
    /// Automatically answer yes to prompts
    #[arg(long)]
    pub yes: bool,
}

#[derive(Parser, Debug)]
pub struct GetHashCommand {
    /// The local file path or URL to hash
    #[arg(required = true)]
    pub source: String,

    /// The hash algorithm to use
    #[arg(long, value_enum, default_value = "sha512")]
    pub hash: HashAlgorithm,
}

#[derive(Parser, Debug)]
pub struct ValidateCommand {
    /// The local file path to validate
    #[arg(required = true)]
    pub file: std::path::PathBuf,
}

#[derive(clap::ValueEnum, Clone, Debug, Copy)]
pub enum HashAlgorithm {
    Sha512,
    Sha256,
}

pub fn run(args: HelperCommand) -> Result<()> {
    match args.command {
        HelperCommands::GetHash(cmd) => {
            let hash_type = match cmd.hash {
                HashAlgorithm::Sha512 => crate::pkg::helper::HashType::Sha512,
                HashAlgorithm::Sha256 => crate::pkg::helper::HashType::Sha256,
            };
            let hash = crate::pkg::helper::get_hash(&cmd.source, hash_type)?;
            println!("{}", hash);
            Ok(())
        }
        HelperCommands::Validate(cmd) => crate::pkg::helper::validate::run(&cmd.file),
        HelperCommands::ElevateInstallNode(cmd) => crate::pkg::helper::elevate_install_node(&cmd),
        HelperCommands::ElevateUninstall(cmd) => crate::pkg::helper::elevate_uninstall(&cmd),
    }
}