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

//! Utility functions for dependency resolution.

use crate::state::modal::DependencyStatus;

/// What: Provide a numeric priority used to order dependency statuses.
///
/// Inputs:
/// - `status`: Dependency status variant subject to sorting.
///
/// Output:
/// - Returns a numeric priority where lower numbers represent higher urgency.
///
/// Details:
/// - Aligns the ordering logic with UI expectations (conflicts first, installed last).
pub(super) const fn dependency_priority(status: &DependencyStatus) -> u8 {
    match status {
        DependencyStatus::Conflict { .. } => 0,
        DependencyStatus::Missing => 1,
        DependencyStatus::ToInstall => 2,
        DependencyStatus::ToUpgrade { .. } => 3,
        DependencyStatus::Installed { .. } => 4,
    }
}

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

    #[test]
    /// What: Validate dependency priorities rank conflict states ahead of installed cases.
    ///
    /// Inputs:
    /// - Constructs each `DependencyStatus` variant with lightweight sample payloads.
    ///
    /// Output:
    /// - Asserts the assigned numeric priorities ascend from conflict through installed statuses.
    ///
    /// Details:
    /// - Guards the ordering relied upon by sorting logic so that regression changes surface quickly.
    fn dependency_priority_orders_by_severity() {
        let conflict = dependency_priority(&DependencyStatus::Conflict {
            reason: String::new(),
        });
        let missing = dependency_priority(&DependencyStatus::Missing);
        let install = dependency_priority(&DependencyStatus::ToInstall);
        let upgrade = dependency_priority(&DependencyStatus::ToUpgrade {
            current: "1".into(),
            required: "2".into(),
        });
        let installed = dependency_priority(&DependencyStatus::Installed {
            version: "1".into(),
        });

        assert!(conflict < missing);
        assert!(missing < install);
        assert!(install < upgrade);
        assert!(upgrade < installed);
    }
}