pacsea 0.8.2

A fast, friendly TUI for browsing and installing Arch and AUR packages with built-in news and security scanning
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163

//! Command-line argument definition and processing.

use clap::Parser;

/// Pacsea - A fast, friendly TUI for browsing and installing Arch and AUR packages
#[derive(Parser, Debug)]
#[command(name = "pacsea")]
#[command(version)]
#[command(about = "A fast, friendly TUI for browsing and installing Arch and AUR packages", long_about = None)]
#[allow(clippy::struct_excessive_bools)]
pub struct Args {
    /// Perform a dry run without making actual changes
    #[arg(long)]
    pub dry_run: bool,

    /// Set the logging level (trace, debug, info, warn, error)
    #[arg(long, default_value = "info")]
    pub log_level: String,

    /// Enable verbose output (equivalent to --log-level debug)
    #[arg(short, long)]
    pub verbose: bool,

    /// Disable colored output
    #[arg(long)]
    pub no_color: bool,

    /// [Not yet implemented] Specify the configuration directory (default: ~/.config/pacsea)
    #[arg(long)]
    pub config_dir: Option<String>,

    /// Search for packages from command line
    #[arg(short, long)]
    pub search: Option<String>,

    /// Install packages from command line (comma-separated or space-separated)
    #[arg(short, long, num_args = 1..)]
    pub install: Vec<String>,

    /// Install packages from file (e.g., pacsea -I FILENAME.txt)
    #[arg(short = 'I')]
    pub install_from_file: Option<String>,

    /// Remove packages from command line (e.g., pacsea -r PACKAGE1 PACKAGE2 or pacsea --remove PACKAGE)
    #[arg(short = 'r', long, num_args = 1..)]
    pub remove: Vec<String>,

    /// [Not yet implemented] Remove packages from file (e.g., pacsea -R FILENAME.txt)
    #[arg(short = 'R')]
    pub remove_from_file: Option<String>,

    /// System update (sync + update, e.g., pacsea --update)
    #[arg(short = 'u', long)]
    pub update: bool,

    /// Output news dialog to commandline with link to website at the end
    #[arg(short = 'n', long)]
    pub news: bool,

    /// List unread news (use with --news)
    #[arg(long)]
    pub unread: bool,

    /// List read news (use with --news)
    #[arg(long)]
    pub read: bool,

    /// List all news (read and unread) (use with --news)
    #[arg(long, short = 'a')]
    pub all_news: bool,

    /// Clear all cache files (dependencies, files, services, sandbox) and exit
    #[arg(long)]
    pub clear_cache: bool,

    /// List installed packages (use with --exp, --imp, or --all)
    #[arg(short = 'l', long)]
    pub list: bool,

    /// List explicitly installed packages (use with --list)
    #[arg(long)]
    pub exp: bool,

    /// List implicitly installed packages (use with --list)
    #[arg(long)]
    pub imp: bool,

    /// List all installed packages (use with --list)
    #[arg(long)]
    pub all: bool,
}

/// What: Process all command-line arguments and handle early-exit flags.
///
/// Inputs:
/// - `args`: Parsed command-line arguments.
///
/// Output:
/// - Returns `None` (no longer returns refresh result).
///
/// Details:
/// - Handles search mode (exits immediately).
/// - Handles clear cache flag (exits immediately).
/// - Logs warnings for unimplemented flags (install, remove, update, news).
#[allow(unused_imports)]
pub fn process_args(args: &Args) -> Option<bool> {
    use crate::args::{cache, install, list, news, remove, search, update};

    // Handle command-line search mode
    if let Some(search_query) = &args.search {
        search::handle_search(search_query);
    }

    // Handle clear cache flag
    if args.clear_cache {
        cache::handle_clear_cache();
    }

    // Handle list installed packages flag
    if args.list {
        list::handle_list(args.exp, args.imp, args.all);
    }

    // Handle command-line install mode
    if !args.install.is_empty() {
        install::handle_install(&args.install);
    }

    // Handle install from file (-I)
    if let Some(file_path) = &args.install_from_file {
        install::handle_install_from_file(file_path);
    }

    // Handle remove packages from command line (-r / --remove)
    if !args.remove.is_empty() {
        remove::handle_remove(&args.remove);
    }

    // Handle remove packages from file (-R)
    if let Some(file_path) = &args.remove_from_file {
        tracing::info!(file = %file_path, "Remove from file requested from CLI");
        // TODO: Implement remove from file (mentioned in roadmap)
        tracing::warn!("Remove from file not yet implemented, falling back to TUI");
    }

    // Handle system update (--update / -u)
    #[cfg(not(target_os = "windows"))]
    if args.update {
        update::handle_update(args.no_color);
    }
    #[cfg(target_os = "windows")]
    if args.update {
        eprintln!("System update is not supported on Windows");
        std::process::exit(1);
    }

    // Handle news flag
    if args.news {
        news::handle_news(args.unread, args.read, args.all_news);
    }

    None
}