pathmaster 0.3.0

pathmaster is a powerful command-line tool written in Rust for managing your system's PATH environment variable.
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
108
109
110

//! Pathmaster - A powerful tool for managing your system's PATH environment variable.
//!
//! This binary provides a command-line interface for:
//! - Adding directories to PATH
//! - Removing directories from PATH
//! - Listing current PATH entries
//! - Managing PATH backups
//! - Validating PATH entries
//! - Flushing invalid entries from PATH

use clap::{command, Parser, Subcommand};
use commands::validator;

mod backup;
mod commands;
mod utils;

/// CLI configuration and argument parsing for pathmaster
#[derive(Parser)]
#[command(name = "pathmaster")]
#[command(version = "0.3.0")]
#[command(about = "A powerful path management tool", long_about = None)]
struct Cli {
    /// Control what gets backed up when modifying PATH (default, path, shell, switch)
    #[arg(long, value_name = "MODE")]
    backup_mode: Option<String>,

    #[command(subcommand)]
    command: Commands,
}

/// Available commands for pathmaster
#[derive(Subcommand)]
enum Commands {
    /// Add directories to the PATH
    #[command(name = "add", short_flag = 'a')]
    Add {
        /// Directories to add
        directories: Vec<String>,
    },
    /// Delete directories from the PATH
    #[command(name = "delete", short_flag = 'd', aliases = &["remove"])]
    Delete {
        /// Directories to delete
        directories: Vec<String>,
    },
    /// List current PATH entries
    #[command(name = "list", short_flag = 'l')]
    List,
    /// Show backup history
    #[command(name = "history", short_flag = 'y')]
    History,
    /// Restore PATH from a backup
    #[command(name = "restore", short_flag = 'r')]
    Restore {
        /// Timestamp of the backup to restore
        #[arg(short, long)]
        timestamp: Option<String>,
    },
    /// Flush non-existing paths from the PATH
    #[command(name = "flush", short_flag = 'f')]
    Flush,
    /// Check PATH for invalid directories
    #[command(name = "check", short_flag = 'c')]
    Check,
}

fn main() {
    let cli = Cli::parse();

    // Initialize backup mode if specified
    if let Some(mode) = cli.backup_mode {
        let mut manager = backup::mode::BackupModeManager::new();
        match mode.as_str() {
            "default" => manager.reset_to_default(),
            "path" => manager.confirm_mode_change(backup::mode::BackupMode::PathOnly),
            "shell" => manager.confirm_mode_change(backup::mode::BackupMode::ShellOnly),
            "switch" => manager.toggle_mode(),
            _ => {
                eprintln!(
                    "Invalid backup mode: {}. Valid modes are: default, path, shell, switch",
                    mode
                );
                std::process::exit(1);
            }
        }
    }

    match &cli.command {
        Commands::Add { directories } => commands::add::execute(directories),
        Commands::Delete { directories } => commands::delete::execute(directories),
        Commands::List => commands::list::execute(),
        Commands::History => backup::show_history(),
        Commands::Restore { timestamp } => backup::restore_from_backup(timestamp),
        Commands::Flush => commands::flush::execute(),
        Commands::Check => match validator::validate_path() {
            Ok(validation) => {
                if validation.existing_dirs.is_empty() && validation.missing_dirs.is_empty() {
                    println!("All directories in PATH are valid");
                } else {
                    println!("Invalid directories in PATH:");
                    for dir in validation.missing_dirs {
                        println!("  {}", dir.to_string_lossy());
                    }
                }
            }
            Err(e) => eprintln!("Error: {}", e),
        },
    }
}