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

// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT

use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::{boxed::Box as Box_, fmt, mem::transmute};

glib::wrapper! {
    /// [`AppInfoMonitor`][crate::AppInfoMonitor] is a very simple object used for monitoring the app
    /// info database for changes (newly installed or removed applications).
    ///
    /// Call [`get()`][Self::get()] to get a [`AppInfoMonitor`][crate::AppInfoMonitor] and connect
    /// to the [`changed`][struct@crate::AppInfoMonitor#changed] signal. The signal will be emitted once when
    /// the app info database changes, and will not be emitted again until after the
    /// next call to [`AppInfo::all()`][crate::AppInfo::all()] or another `g_app_info_*()` function. This
    /// is because monitoring the app info database for changes is expensive.
    ///
    /// The following functions will re-arm the [`changed`][struct@crate::AppInfoMonitor#changed] signal so
    /// it can be emitted again:
    ///  - [`AppInfo::all()`][crate::AppInfo::all()]
    ///  - [`AppInfo::all_for_type()`][crate::AppInfo::all_for_type()]
    ///  - [`AppInfo::default_for_type()`][crate::AppInfo::default_for_type()]
    ///  - [`AppInfo::fallback_for_type()`][crate::AppInfo::fallback_for_type()]
    ///  - [`AppInfo::recommended_for_type()`][crate::AppInfo::recommended_for_type()]
    ///  - [`DesktopAppInfo::implementations()`][crate::DesktopAppInfo::implementations()]
    ///  - [`DesktopAppInfo::new()`][crate::DesktopAppInfo::new()]
    ///  - [`DesktopAppInfo::from_filename()`][crate::DesktopAppInfo::from_filename()]
    ///  - [`DesktopAppInfo::from_keyfile()`][crate::DesktopAppInfo::from_keyfile()]
    ///  - [`DesktopAppInfo::search()`][crate::DesktopAppInfo::search()]
    ///
    /// In the usual case, applications should try to make note of the change
    /// (doing things like invalidating caches) but not act on it. In
    /// particular, applications should avoid making calls to [`AppInfo`][crate::AppInfo] APIs
    /// in response to the change signal, deferring these until the time that
    /// the updated data is actually required. The exception to this case is when
    /// application information is actually being displayed on the screen
    /// (for example, during a search or when the list of all applications is shown).
    /// The reason for this is that changes to the list of installed
    /// applications often come in groups (like during system updates) and
    /// rescanning the list on every change is pointless and expensive.
    ///
    /// ## Signals
    ///
    ///
    /// #### `changed`
    ///  Signal emitted when the app info database changes, when applications are
    /// installed or removed.
    ///
    ///
    ///
    /// # Implements
    ///
    /// [`trait@glib::ObjectExt`]
    #[doc(alias = "GAppInfoMonitor")]
    pub struct AppInfoMonitor(Object<ffi::GAppInfoMonitor>);

    match fn {
        type_ => || ffi::g_app_info_monitor_get_type(),
    }
}

impl AppInfoMonitor {
    /// Gets the [`AppInfoMonitor`][crate::AppInfoMonitor] for the current thread-default main
    /// context.
    ///
    /// The [`AppInfoMonitor`][crate::AppInfoMonitor] will emit a "changed" signal in the
    /// thread-default main context whenever the list of installed
    /// applications (as reported by [`AppInfo::all()`][crate::AppInfo::all()]) may have changed.
    ///
    /// The [`changed`][struct@crate::AppInfoMonitor#changed] signal will only be emitted once until
    /// [`AppInfo::all()`][crate::AppInfo::all()] (or another `g_app_info_*()` function) is called. Doing
    /// so will re-arm the signal ready to notify about the next change.
    ///
    /// You must only call `g_object_unref()` on the return value from under
    /// the same main context as you created it.
    ///
    /// # Returns
    ///
    /// a reference to a [`AppInfoMonitor`][crate::AppInfoMonitor]
    #[doc(alias = "g_app_info_monitor_get")]
    pub fn get() -> AppInfoMonitor {
        unsafe { from_glib_full(ffi::g_app_info_monitor_get()) }
    }

    /// Signal emitted when the app info database changes, when applications are
    /// installed or removed.
    #[doc(alias = "changed")]
    pub fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn changed_trampoline<F: Fn(&AppInfoMonitor) + 'static>(
            this: *mut ffi::GAppInfoMonitor,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"changed\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    changed_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl fmt::Display for AppInfoMonitor {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        f.write_str("AppInfoMonitor")
    }
}