focus-tracker 1.1.0

Cross-platform focus tracker for Linux (X11), 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

use bon::bon;

use crate::{FocusTrackerConfig, FocusTrackerResult, FocusedWindow, platform};
use std::future::Future;
use std::sync::atomic::AtomicBool;

#[derive(Debug, Clone)]
pub struct FocusTracker {
    config: FocusTrackerConfig,
}

impl Default for FocusTracker {
    fn default() -> Self {
        Self::builder().build()
    }
}

#[bon]
impl FocusTracker {
    #[builder]
    #[must_use]
    pub fn new(#[builder(default)] config: FocusTrackerConfig) -> Self {
        Self { config }
    }

    /// Tracks focus changes, calling `on_focus` each time the focused window changes.
    ///
    /// A focus event is only emitted when the `(process_id, window_title)` pair
    /// differs from the previously reported one.
    ///
    /// # Errors
    ///
    /// Returns an error if the platform API fails or the callback returns an error.
    #[builder]
    pub async fn track_focus<F, Fut>(
        &self,
        on_focus: F,
        stop_signal: Option<&AtomicBool>,
    ) -> FocusTrackerResult<()>
    where
        F: FnMut(FocusedWindow) -> Fut,
        Fut: Future<Output = FocusTrackerResult<()>>,
    {
        platform::track_focus(on_focus, stop_signal, &self.config).await
    }
}