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

use crate::logic::sandbox::SandboxInfo;
use crate::state::modal::{
    CascadeMode, DependencyInfo, PackageFileInfo, PreflightAction, PreflightHeaderChips,
    PreflightSummaryData, PreflightTab, ServiceImpact,
};
use crate::state::{Modal, PackageItem};
use std::collections::{HashMap, HashSet};

/// What: Holds all extracted fields from `Modal::Preflight` variant.
///
/// Inputs: None (struct definition).
///
/// Output: None (struct definition).
///
/// Details: Used to simplify field extraction and reduce pattern matching complexity.
pub struct PreflightFields<'a> {
    /// Package items for the operation.
    pub items: &'a [PackageItem],
    /// Preflight action (install, remove, downgrade).
    pub action: &'a PreflightAction,
    /// Currently active preflight tab.
    pub tab: &'a PreflightTab,
    /// Optional preflight summary data.
    pub summary: &'a Option<Box<PreflightSummaryData>>,
    /// Header chip metrics.
    pub header_chips: &'a PreflightHeaderChips,
    /// Dependency information.
    pub dependency_info: &'a mut Vec<DependencyInfo>,
    /// Currently selected dependency index.
    pub dep_selected: &'a mut usize,
    /// Set of expanded dependency names in the tree view.
    pub dep_tree_expanded: &'a HashSet<String>,
    /// Optional error message for dependencies tab.
    pub deps_error: &'a Option<String>,
    /// Package file information.
    pub file_info: &'a mut Vec<PackageFileInfo>,
    /// Currently selected file index.
    pub file_selected: &'a mut usize,
    /// Set of expanded file names in the tree view.
    pub file_tree_expanded: &'a HashSet<String>,
    /// Optional error message for files tab.
    pub files_error: &'a Option<String>,
    /// Service impact information.
    pub service_info: &'a mut Vec<ServiceImpact>,
    /// Currently selected service index.
    pub service_selected: &'a mut usize,
    /// Whether services data has been loaded.
    pub services_loaded: &'a mut bool,
    /// Optional error message for services tab.
    pub services_error: &'a Option<String>,
    /// Sandbox information.
    pub sandbox_info: &'a mut Vec<SandboxInfo>,
    /// Currently selected sandbox item index.
    pub sandbox_selected: &'a mut usize,
    /// Set of expanded sandbox names in the tree view.
    pub sandbox_tree_expanded: &'a HashSet<String>,
    /// Whether sandbox data has been loaded.
    pub sandbox_loaded: &'a mut bool,
    /// Optional error message for sandbox tab.
    pub sandbox_error: &'a Option<String>,
    /// Selected optional dependencies by package name.
    pub selected_optdepends: &'a HashMap<String, HashSet<String>>,
    /// Cascade removal mode.
    pub cascade_mode: &'a CascadeMode,
}

/// What: Extract all fields from `Modal::Preflight` variant into a struct.
///
/// Inputs:
/// - `modal`: Mutable reference to Modal enum.
///
/// Output:
/// - Returns `Some(PreflightFields)` if modal is Preflight variant, `None` otherwise.
///
/// Details:
/// - Extracts all 25+ fields from the Preflight variant into a more manageable struct.
/// - Returns None if modal is not the Preflight variant.
pub fn extract_preflight_fields(modal: &mut Modal) -> Option<PreflightFields<'_>> {
    let Modal::Preflight {
        items,
        action,
        tab,
        summary,
        summary_scroll: _,
        header_chips,
        dependency_info,
        dep_selected,
        dep_tree_expanded,
        deps_error,
        file_info,
        file_selected,
        file_tree_expanded,
        files_error,
        service_info,
        service_selected,
        services_loaded,
        services_error,
        sandbox_info,
        sandbox_selected,
        sandbox_tree_expanded,
        sandbox_loaded,
        sandbox_error,
        selected_optdepends,
        cascade_mode,
        cached_reverse_deps_report: _,
    } = modal
    else {
        return None;
    };

    Some(PreflightFields {
        items,
        action,
        tab,
        summary,
        header_chips,
        dependency_info,
        dep_selected,
        dep_tree_expanded,
        deps_error,
        file_info,
        file_selected,
        file_tree_expanded,
        files_error,
        service_info,
        service_selected,
        services_loaded,
        services_error,
        sandbox_info,
        sandbox_selected,
        sandbox_tree_expanded,
        sandbox_loaded,
        sandbox_error,
        selected_optdepends,
        cascade_mode,
    })
}