bottom 0.12.3

A customizable cross-platform graphical process/system monitor for the terminal. Supports Linux, macOS, and Windows.
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

//! Uses the battery crate.
//!
//! Covers battery usage for:
//! - Linux 2.6.39+
//! - MacOS 10.10+
//! - iOS
//! - Windows 7+
//! - FreeBSD
//! - DragonFlyBSD
//!
//! For more information, refer to the [starship_battery](https://github.com/starship/rust-battery) repo/docs.

use starship_battery::{
    Battery, Manager, State,
    units::{power::watt, ratio::percent, time::second},
};

/// Battery state.
#[derive(Debug, Clone)]
pub enum BatteryState {
    Charging {
        /// Time to full in seconds.
        time_to_full: Option<u32>,
    },
    Discharging {
        /// Time to empty in seconds.
        time_to_empty: Option<u32>,
    },
    Empty,
    Full,
    Unknown,
}

impl BatteryState {
    /// Return the string representation.
    pub fn as_str(&self) -> &'static str {
        match self {
            BatteryState::Charging { .. } => "Charging",
            BatteryState::Discharging { .. } => "Discharging",
            BatteryState::Empty => "Empty",
            BatteryState::Full => "Full",
            BatteryState::Unknown => "Unknown",
        }
    }
}

#[derive(Debug, Clone)]
pub struct BatteryData {
    /// Current charge percent.
    pub charge_percent: f64,
    /// Power consumption, in watts.
    pub power_consumption: f64,
    /// Reported battery health.
    pub health_percent: f64,
    /// The current battery "state" (e.g. is it full, charging, etc.).
    pub state: BatteryState,
}

impl BatteryData {
    pub fn watt_consumption(&self) -> String {
        format!("{:.2}W", self.power_consumption)
    }

    pub fn health(&self) -> String {
        format!("{:.2}%", self.health_percent)
    }
}

pub fn refresh_batteries(manager: &Manager, batteries: &mut [Battery]) -> Vec<BatteryData> {
    batteries
        .iter_mut()
        .filter_map(|battery| {
            if manager.refresh(battery).is_ok() {
                Some(BatteryData {
                    charge_percent: f64::from(battery.state_of_charge().get::<percent>()),
                    power_consumption: f64::from(battery.energy_rate().get::<watt>()),
                    health_percent: f64::from(battery.state_of_health().get::<percent>()),
                    state: match battery.state() {
                        State::Unknown => BatteryState::Unknown,
                        State::Charging => BatteryState::Charging {
                            time_to_full: {
                                let optional_time = battery.time_to_full();
                                optional_time.map(|time| f64::from(time.get::<second>()) as u32)
                            },
                        },
                        State::Discharging => BatteryState::Discharging {
                            time_to_empty: {
                                let optional_time = battery.time_to_empty();
                                optional_time.map(|time| f64::from(time.get::<second>()) as u32)
                            },
                        },
                        State::Empty => BatteryState::Empty,
                        State::Full => BatteryState::Full,
                    },
                })
            } else {
                None
            }
        })
        .collect::<Vec<_>>()
}