zoi-rs 1.25.1

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
97
98
99
100
101
102
103
104
105
106
107

//! The primary executable for the Zoi package manager.

use colored::Colorize;

/// The primary entry point for the Zoi CLI and its intelligent shims.
///
/// Multiplexing Logic:
/// Zoi uses a single binary for both the main CLI and all tool shims.
/// - If the binary is invoked as `zoi`, it runs the standard CLI.
/// - If it is invoked via a symlink (e.g. `node` -> `zoi`), it acts as a
///   "Shim".
/// - In shim mode, it dynamically resolves the correct version of the requested
///   tool based on the current project context, environment, or plugins.
fn main() {
    #[cfg(windows)]
    colored::control::set_virtual_terminal(true).ok();

    let args: Vec<String> = std::env::args().collect();
    let program_name = args
        .first()
        .and_then(|path| std::path::Path::new(path).file_name())
        .and_then(|s| s.to_str())
        .unwrap_or_default();

    if !program_name.is_empty()
        && program_name != "zoi"
        && !program_name.starts_with("zoi-")
        && !program_name.contains("target")
    {
        let plugin_manager = match zoi_cli::pkg::plugin::PluginManager::new() {
            Ok(m) => {
                let _ = m.load_all(false);
                m
            }
            Err(e) => {
                eprintln!(
                    "{}: Failed to initialize PluginManager: {}",
                    "Error".red().bold(),
                    e
                );
                std::process::exit(1);
            }
        };

        // A JIT (Just-in-Time) installation callback used by shims.
        //
        // This is a unique Zoi feature: if a shim resolves to a version that is
        // NOT currently installed (e.g. via a project's .tool-versions
        // file), Zoi doesn't just fail. Instead, it triggers this
        // callback to:
        // - Prompt the user for JIT installation.
        // - Resolve the required package and its dependency tree.
        // - Install it into the appropriate store scope.
        // - Seamlessly continue the original execution.
        let auto_install = |name: &str, version: &str| -> anyhow::Result<()> {
            let spec = format!("{name}@{version}");
            let scope = if std::path::Path::new("zoi.yaml").exists() {
                zoi_cli::pkg::types::Scope::Project
            } else {
                zoi_cli::pkg::types::Scope::User
            };
            let _options = zoi_cli::SourceInstallOptions {
                scope_override: Some(scope),
                yes: true,
                ..Default::default()
            };
            zoi_cli::cmd::install::run(
                &[spec],
                None,
                false,
                false,
                true,
                Some(zoi_cli::cli::InstallScope::User),
                false,
                false,
                false,
                None,
                false,
                Some(&plugin_manager),
                false,
                false,
                false,
                false,
                3,
                false,
                false,
                None
            )
        };

        if let Err(e) = zoi_cli::pkg::shim::run_shim(
            program_name,
            args.get(1..).unwrap_or_default().to_vec(),
            Some(&plugin_manager),
            Some(&auto_install)
        ) {
            eprintln!("{}: {}", "Shim Error".red().bold(), e);
            std::process::exit(1);
        }
        return;
    }

    if let Err(e) = zoi_cli::cli::run() {
        eprintln!("{}: {}", "Error".red().bold(), e);
        std::process::exit(1);
    }
}