vsix 1.0.2

A command-line utility that downloads and installs .vsix extensions into Visual Studio Code and Cursor
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 crate::domain::DomainError;
use async_trait::async_trait;
use std::path::PathBuf;

/// Represents the available IDE types for extension installation
#[derive(Debug, Clone, PartialEq)]
pub enum IdeType {
    VsCode,
    Cursor,
}

impl IdeType {
    /// Returns the CLI command name for the IDE
    pub fn command_name(&self) -> &'static str {
        match self {
            IdeType::VsCode => "code",
            IdeType::Cursor => "cursor",
        }
    }

    /// Returns the display name for the IDE
    pub fn display_name(&self) -> &'static str {
        match self {
            IdeType::VsCode => "VSCode",
            IdeType::Cursor => "Cursor",
        }
    }
}

/// Represents the installation method available for an IDE
#[derive(Debug, Clone, PartialEq)]
pub enum InstallationMethod {
    /// Install using CLI command (e.g., `code --install-extension`)
    CliCommand { command_path: PathBuf },
    /// Install by extracting to file system directory
    FileSystem { extensions_dir: PathBuf },
}

/// Value object representing an installation strategy for a specific IDE
#[derive(Debug, Clone)]
pub struct InstallationStrategy {
    pub ide_type: IdeType,
    pub method: InstallationMethod,
}

impl InstallationStrategy {
    pub fn new(ide_type: IdeType, method: InstallationMethod) -> Self {
        Self { ide_type, method }
    }
}

/// Service for detecting available installation methods
#[async_trait]
pub trait InstallationDetector: Send + Sync {
    /// Detects the available installation method for the specified IDE
    async fn detect_method(&self, ide_type: &IdeType) -> Result<InstallationMethod, DomainError>;
}

/// Service for executing installations using a specific strategy
#[async_trait]
pub trait InstallationExecutor: Send + Sync {
    /// Executes the installation using the provided strategy
    async fn execute(
        &self,
        strategy: &InstallationStrategy,
        extension_id: &str,
        vsix_data: &[u8],
    ) -> Result<(), DomainError>;
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_ide_type_command_names() {
        assert_eq!(IdeType::VsCode.command_name(), "code");
        assert_eq!(IdeType::Cursor.command_name(), "cursor");
    }

    #[test]
    fn test_ide_type_display_names() {
        assert_eq!(IdeType::VsCode.display_name(), "VSCode");
        assert_eq!(IdeType::Cursor.display_name(), "Cursor");
    }

    #[test]
    fn test_installation_strategy_creation() {
        let strategy = InstallationStrategy::new(
            IdeType::VsCode,
            InstallationMethod::CliCommand {
                command_path: PathBuf::from("/usr/local/bin/code"),
            },
        );

        assert_eq!(strategy.ide_type, IdeType::VsCode);
        match strategy.method {
            InstallationMethod::CliCommand { command_path } => {
                assert_eq!(command_path, PathBuf::from("/usr/local/bin/code"));
            }
            _ => panic!("Expected CliCommand"),
        }
    }
}