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

use crate::ffi;
use glib::{prelude::*, translate::*};

glib::wrapper! {
    ///
    ///
    /// # Implements
    ///
    /// [`InstanceExt`][trait@crate::prelude::InstanceExt]
    #[doc(alias = "FlatpakInstance")]
    pub struct Instance(Object<ffi::FlatpakInstance, ffi::FlatpakInstanceClass>);

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

impl Instance {
    pub const NONE: Option<&'static Instance> = None;

    /// Gets FlatpakInstance objects for all running sandboxes in the current session.
    ///
    /// # Returns
    ///
    /// a [`glib::PtrArray`][crate::glib::PtrArray] of
    ///  [`Instance`][crate::Instance] objects
    #[cfg(feature = "v1_1")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_1")))]
    #[doc(alias = "flatpak_instance_get_all")]
    #[doc(alias = "get_all")]
    pub fn all() -> Vec<Instance> {
        assert_initialized_main_thread!();
        unsafe { FromGlibPtrContainer::from_glib_full(ffi::flatpak_instance_get_all()) }
    }
}

mod sealed {
    pub trait Sealed {}
    impl<T: super::IsA<super::Instance>> Sealed for T {}
}

/// Trait containing all [`struct@Instance`] methods.
///
/// # Implementors
///
/// [`Instance`][struct@crate::Instance]
pub trait InstanceExt: IsA<Instance> + sealed::Sealed + 'static {
    /// Gets the application ID of the application running in the instance.
    ///
    /// Note that this may return [`None`] for sandboxes that don't have an application.
    ///
    /// # Returns
    ///
    /// the application ID or [`None`]
    #[cfg(feature = "v1_1")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_1")))]
    #[doc(alias = "flatpak_instance_get_app")]
    #[doc(alias = "get_app")]
    fn app(&self) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::flatpak_instance_get_app(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the architecture of the application running in the instance.
    ///
    /// # Returns
    ///
    /// the architecture
    #[cfg(feature = "v1_1")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_1")))]
    #[doc(alias = "flatpak_instance_get_arch")]
    #[doc(alias = "get_arch")]
    fn arch(&self) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::flatpak_instance_get_arch(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the branch of the application running in the instance.
    ///
    /// # Returns
    ///
    /// the architecture
    #[cfg(feature = "v1_1")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_1")))]
    #[doc(alias = "flatpak_instance_get_branch")]
    #[doc(alias = "get_branch")]
    fn branch(&self) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::flatpak_instance_get_branch(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the PID of the application process in the sandbox.
    ///
    /// See [`pid()`][Self::pid()].
    ///
    /// Note that this function may return 0 immediately after launching
    /// a sandbox, for a short amount of time.
    ///
    /// # Returns
    ///
    /// the application process PID
    #[cfg(feature = "v1_1")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_1")))]
    #[doc(alias = "flatpak_instance_get_child_pid")]
    #[doc(alias = "get_child_pid")]
    fn child_pid(&self) -> i32 {
        unsafe { ffi::flatpak_instance_get_child_pid(self.as_ref().to_glib_none().0) }
    }

    /// Gets the commit of the application running in the instance.
    ///
    /// # Returns
    ///
    /// the commit
    #[cfg(feature = "v1_1")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_1")))]
    #[doc(alias = "flatpak_instance_get_commit")]
    #[doc(alias = "get_commit")]
    fn commit(&self) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::flatpak_instance_get_commit(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the instance ID. The ID is used by Flatpak for bookkeeping
    /// purposes and has no further relevance.
    ///
    /// # Returns
    ///
    /// the instance ID
    #[cfg(feature = "v1_1")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_1")))]
    #[doc(alias = "flatpak_instance_get_id")]
    #[doc(alias = "get_id")]
    fn id(&self) -> Option<glib::GString> {
        unsafe { from_glib_none(ffi::flatpak_instance_get_id(self.as_ref().to_glib_none().0)) }
    }

    /// Gets a keyfile that holds information about the running sandbox.
    ///
    /// This file is available as /.flatpak-info inside the sandbox as well.
    ///
    /// The most important data in the keyfile is available with separate getters,
    /// but there may be more information in the keyfile.
    ///
    /// # Returns
    ///
    /// the flatpak-info keyfile
    #[cfg(feature = "v1_1")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_1")))]
    #[doc(alias = "flatpak_instance_get_info")]
    #[doc(alias = "get_info")]
    fn info(&self) -> Option<glib::KeyFile> {
        unsafe {
            from_glib_full(ffi::flatpak_instance_get_info(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the PID of the outermost process in the sandbox. This is not the
    /// application process itself, but a bubblewrap 'babysitter' process.
    ///
    /// See [`child_pid()`][Self::child_pid()].
    ///
    /// # Returns
    ///
    /// the outermost process PID
    #[cfg(feature = "v1_1")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_1")))]
    #[doc(alias = "flatpak_instance_get_pid")]
    #[doc(alias = "get_pid")]
    fn pid(&self) -> i32 {
        unsafe { ffi::flatpak_instance_get_pid(self.as_ref().to_glib_none().0) }
    }

    /// Gets the ref of the runtime used in the instance.
    ///
    /// # Returns
    ///
    /// the runtime ref
    #[cfg(feature = "v1_1")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_1")))]
    #[doc(alias = "flatpak_instance_get_runtime")]
    #[doc(alias = "get_runtime")]
    fn runtime(&self) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::flatpak_instance_get_runtime(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the commit of the runtime used in the instance.
    ///
    /// # Returns
    ///
    /// the runtime commit
    #[cfg(feature = "v1_1")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_1")))]
    #[doc(alias = "flatpak_instance_get_runtime_commit")]
    #[doc(alias = "get_runtime_commit")]
    fn runtime_commit(&self) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::flatpak_instance_get_runtime_commit(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Finds out if the sandbox represented by `self` is still running.
    ///
    /// # Returns
    ///
    /// [`true`] if the sandbox is still running
    #[doc(alias = "flatpak_instance_is_running")]
    fn is_running(&self) -> bool {
        unsafe {
            from_glib(ffi::flatpak_instance_is_running(
                self.as_ref().to_glib_none().0,
            ))
        }
    }
}

impl<O: IsA<Instance>> InstanceExt for O {}