polkit 0.19.0

High-level bindings for libpolkit-gobject-1
// Generated by gir (https://github.com/gtk-rs/gir @ 0e476ab5c1de)
// from /usr/share/gir-1.0 (@ ???)
// DO NOT EDIT

use crate::Subject;
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::{boxed::Box as Box_, pin::Pin};

glib::wrapper! {
    /// An object that represents an user session.
    ///
    /// The session id is an opaque string obtained from ConsoleKit.
    ///
    /// ## Properties
    ///
    ///
    /// #### `pid`
    ///  The UNIX process id to look up the session.
    ///
    /// Writeable | Construct Only
    ///
    ///
    /// #### `session-id`
    ///  The UNIX session id.
    ///
    /// Readable | Writeable | Construct
    ///
    /// # Implements
    ///
    /// [`trait@glib::ObjectExt`], [`SubjectExt`][trait@crate::prelude::SubjectExt]
    #[doc(alias = "PolkitUnixSession")]
    pub struct UnixSession(Object<ffi::PolkitUnixSession, ffi::PolkitUnixSessionClass>) @implements Subject;

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

impl UnixSession {
    /// Gets the session id for `self`.
    ///
    /// # Returns
    ///
    /// The session id for `self`. Do not free this string, it
    /// is owned by `self`.
    #[doc(alias = "polkit_unix_session_get_session_id")]
    #[doc(alias = "get_session_id")]
    pub fn session_id(&self) -> glib::GString {
        unsafe {
            from_glib_none(ffi::polkit_unix_session_get_session_id(
                self.to_glib_none().0,
            ))
        }
    }

    /// Sets the session id for `self` to `session_id`.
    /// ## `session_id`
    /// The session id.
    #[doc(alias = "polkit_unix_session_set_session_id")]
    pub fn set_session_id(&self, session_id: &str) {
        unsafe {
            ffi::polkit_unix_session_set_session_id(
                self.to_glib_none().0,
                session_id.to_glib_none().0,
            );
        }
    }

    /// Creates a new [`UnixSession`][crate::UnixSession] for `session_id`.
    /// ## `session_id`
    /// The session id.
    ///
    /// # Returns
    ///
    /// A [`UnixSession`][crate::UnixSession]. Free with `g_object_unref()`.
    #[doc(alias = "polkit_unix_session_new")]
    pub fn new(session_id: &str) -> Subject {
        unsafe { from_glib_full(ffi::polkit_unix_session_new(session_id.to_glib_none().0)) }
    }

    /// Asynchronously creates a new [`UnixSession`][crate::UnixSession] object for the
    /// process with process id `pid`.
    ///
    /// When the operation is finished, `callback` will be invoked in the
    /// <link linkend="g-main-context-push-thread-default">thread-default
    /// main loop`</link>` of the thread you are calling this method
    /// from. You can then call
    /// `polkit_unix_session_new_for_process_finish()` to get the result of
    /// the operation.
    ///
    /// This method constructs the object asynchronously, for the synchronous and blocking version
    /// use [`new_for_process_sync()`][Self::new_for_process_sync()].
    /// ## `pid`
    /// The process id of the process to get the session for.
    /// ## `cancellable`
    /// A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
    /// ## `callback`
    /// A `GAsyncReadyCallback` to call when the request is satisfied
    #[doc(alias = "polkit_unix_session_new_for_process")]
    pub fn new_for_process<P: FnOnce(Result<Option<Subject>, glib::Error>) + 'static>(
        pid: i32,
        cancellable: Option<&impl IsA<gio::Cancellable>>,
        callback: P,
    ) {
        let main_context = glib::MainContext::ref_thread_default();
        let is_main_context_owner = main_context.is_owner();
        let has_acquired_main_context = (!is_main_context_owner)
            .then(|| main_context.acquire().ok())
            .flatten();
        assert!(
            is_main_context_owner || has_acquired_main_context.is_some(),
            "Async operations only allowed if the thread is owning the MainContext"
        );

        let user_data: Box_<glib::thread_guard::ThreadGuard<P>> =
            Box_::new(glib::thread_guard::ThreadGuard::new(callback));
        unsafe extern "C" fn new_for_process_trampoline<
            P: FnOnce(Result<Option<Subject>, glib::Error>) + 'static,
        >(
            _source_object: *mut glib::gobject_ffi::GObject,
            res: *mut gio::ffi::GAsyncResult,
            user_data: glib::ffi::gpointer,
        ) {
            let mut error = std::ptr::null_mut();
            let ret = ffi::polkit_unix_session_new_for_process_finish(res, &mut error);
            let result = if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            };
            let callback: Box_<glib::thread_guard::ThreadGuard<P>> =
                Box_::from_raw(user_data as *mut _);
            let callback: P = callback.into_inner();
            callback(result);
        }
        let callback = new_for_process_trampoline::<P>;
        unsafe {
            ffi::polkit_unix_session_new_for_process(
                pid,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                Some(callback),
                Box_::into_raw(user_data) as *mut _,
            );
        }
    }

    pub fn new_for_process_future(
        pid: i32,
    ) -> Pin<Box_<dyn std::future::Future<Output = Result<Option<Subject>, glib::Error>> + 'static>>
    {
        Box_::pin(gio::GioFuture::new(&(), move |_obj, cancellable, send| {
            Self::new_for_process(pid, Some(cancellable), move |res| {
                send.resolve(res);
            });
        }))
    }

    /// Creates a new [`UnixSession`][crate::UnixSession] for the process with process id `pid`.
    ///
    /// This is a synchronous call - the calling thread is blocked until a
    /// reply is received. For the asynchronous version, see
    /// [`new_for_process()`][Self::new_for_process()].
    /// ## `pid`
    /// The process id of the process to get the session for.
    /// ## `cancellable`
    /// A [`gio::Cancellable`][crate::gio::Cancellable] or [`None`].
    ///
    /// # Returns
    ///
    /// A [`UnixSession`][crate::UnixSession] for
    /// `pid` or [`None`] if `error` is set. Free with `g_object_unref()`.
    #[doc(alias = "polkit_unix_session_new_for_process_sync")]
    pub fn new_for_process_sync(
        pid: i32,
        cancellable: Option<&impl IsA<gio::Cancellable>>,
    ) -> Result<Option<Subject>, glib::Error> {
        unsafe {
            let mut error = std::ptr::null_mut();
            let ret = ffi::polkit_unix_session_new_for_process_sync(
                pid,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                &mut error,
            );
            if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    #[doc(alias = "session-id")]
    pub fn connect_session_id_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_session_id_trampoline<F: Fn(&UnixSession) + 'static>(
            this: *mut ffi::PolkitUnixSession,
            _param_spec: glib::ffi::gpointer,
            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"notify::session-id\0".as_ptr() as *const _,
                Some(std::mem::transmute::<_, unsafe extern "C" fn()>(
                    notify_session_id_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}