vx-installer 0.4.0

Installation utilities and helpers for the vx universal tool manager
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

//! # vx-installer
//!
//! Installation utilities and helpers for the vx universal tool manager.
//!
//! This crate provides a unified interface for downloading, extracting, and installing
//! development tools across different platforms and archive formats.
//!
//! ## Features
//!
//! - **Unified Installation API**: Single interface for all installation operations
//! - **Multiple Archive Formats**: Support for ZIP, TAR.GZ, TAR.XZ, and binary files
//! - **Progress Tracking**: Built-in progress bars for downloads and extractions
//! - **Platform Agnostic**: Works across Windows, macOS, and Linux
//! - **Async Support**: Fully async API for non-blocking operations
//!
//! ## Example
//!
//! ```rust,no_run
//! use vx_installer::{Installer, InstallConfig, InstallMethod, ArchiveFormat};
//! use std::path::PathBuf;
//!
//! #[tokio::main]
//! async fn main() -> Result<(), Box<dyn std::error::Error>> {
//!     let installer = Installer::new().await?;
//!     
//!     let config = InstallConfig::builder()
//!         .tool_name("node")
//!         .version("18.17.0")
//!         .download_url("https://nodejs.org/dist/v18.17.0/node-v18.17.0-linux-x64.tar.gz")
//!         .install_method(InstallMethod::Archive {
//!             format: ArchiveFormat::TarGz
//!         })
//!         .install_dir(PathBuf::from("/opt/vx/tools/node/18.17.0"))
//!         .build();
//!     
//!     let executable_path = installer.install(&config).await?;
//!     println!("Installed to: {}", executable_path.display());
//!     
//!     Ok(())
//! }
//! ```

pub mod downloader;
pub mod error;
pub mod formats;
pub mod installer;
pub mod progress;

// Re-export main types for convenience
pub use downloader::Downloader;
pub use error::{Error, Result};
pub use installer::{ArchiveFormat, InstallConfig, InstallConfigBuilder, InstallMethod, Installer};
pub use progress::{ProgressReporter, ProgressStyle};

// Re-export format handlers
pub use formats::{ArchiveExtractor, FormatHandler};

/// Version information for the vx-installer crate
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

/// Default user agent for HTTP requests
pub const USER_AGENT: &str = concat!("vx-installer/", env!("CARGO_PKG_VERSION"));

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

    #[test]
    fn test_version_info() {
        assert!(!VERSION.is_empty());
        assert!(USER_AGENT.contains("vx-installer"));
    }
}