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

use std::io;
use std::iter;
use std::default;

use crate::Battery;
use crate::platform::Iterator as InnerIterator;
use crate::platform::Manager as InnerManager;
use crate::platform::traits::BatteryManager;

/// Manager for batteries available in system.
///
/// Knows how to fetch them and update information.
///
/// # Example
///
/// ```edition2018
/// # use battery::Manager;
/// # fn main() {
/// for battery in Manager::new().iter() {
///     println!("{:#?}", battery);
/// }
/// # }
/// ```
#[derive(Debug)]
pub struct Manager(InnerManager);

impl Manager {
    /// Creates new manager instance.
    pub fn new() -> Manager {
        Manager(InnerManager::default())
    }

    /// Gets an iterator over available [batteries](struct.Battery.html).
    pub fn iter(&self) -> Batteries {
        Batteries(self.0.iter())
    }

    /// Refresh battery information in-place.
    pub fn refresh(&mut self, battery: &mut Battery) -> io::Result<()> {
        self.0.refresh(battery)
    }
}

impl default::Default for Manager {
    fn default() -> Self {
        Self::new()
    }
}

/// An iterator that yields batteries available in system.
///
/// This struct is created by the [iter](struct.Manager.html#method.iter) method on [Manager](struct.Manager.html).
/// See its documentation for more.
#[must_use = "iterator adaptors are lazy and do nothing unless consumed"]
#[derive(Debug)]
pub struct Batteries(InnerIterator);

impl iter::Iterator for Batteries {
    type Item = Battery;

    fn next(&mut self) -> Option<Self::Item> {
        self.0.next()
    }
}