// 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 crate::{
    AsyncResult, Cancellable, Drive, File, Icon, Mount, MountMountFlags, MountOperation,
    MountUnmountFlags,
};
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::{boxed::Box as Box_, fmt, mem::transmute, pin::Pin, ptr};

glib::wrapper! {
    /// The [`Volume`][crate::Volume] interface represents user-visible objects that can be
    /// mounted. Note, when porting from GnomeVFS, [`Volume`][crate::Volume] is the moral
    /// equivalent of `GnomeVFSDrive`.
    ///
    /// Mounting a [`Volume`][crate::Volume] instance is an asynchronous operation. For more
    /// information about asynchronous operations, see [`AsyncResult`][crate::AsyncResult] and
    /// [`Task`][crate::Task]. To mount a [`Volume`][crate::Volume], first call [`VolumeExt::mount()`][crate::prelude::VolumeExt::mount()] with (at
    /// least) the [`Volume`][crate::Volume] instance, optionally a [`MountOperation`][crate::MountOperation] object
    /// and a `GAsyncReadyCallback`.
    ///
    /// Typically, one will only want to pass [`None`] for the
    /// [`MountOperation`][crate::MountOperation] if automounting all volumes when a desktop session
    /// starts since it's not desirable to put up a lot of dialogs asking
    /// for credentials.
    ///
    /// The callback will be fired when the operation has resolved (either
    /// with success or failure), and a [`AsyncResult`][crate::AsyncResult] instance will be
    /// passed to the callback. That callback should then call
    /// `g_volume_mount_finish()` with the [`Volume`][crate::Volume] instance and the
    /// [`AsyncResult`][crate::AsyncResult] data to see if the operation was completed
    /// successfully. If an `error` is present when `g_volume_mount_finish()`
    /// is called, then it will be filled with any error information.
    ///
    /// ## Volume Identifiers # {`volume`-identifier}
    ///
    /// It is sometimes necessary to directly access the underlying
    /// operating system object behind a volume (e.g. for passing a volume
    /// to an application via the commandline). For this purpose, GIO
    /// allows to obtain an 'identifier' for the volume. There can be
    /// different kinds of identifiers, such as Hal UDIs, filesystem labels,
    /// traditional Unix devices (e.g. `/dev/sda2`), UUIDs. GIO uses predefined
    /// strings as names for the different kinds of identifiers:
    /// [`VOLUME_IDENTIFIER_KIND_UUID`][crate::VOLUME_IDENTIFIER_KIND_UUID], [`VOLUME_IDENTIFIER_KIND_LABEL`][crate::VOLUME_IDENTIFIER_KIND_LABEL], etc.
    /// Use [`VolumeExt::identifier()`][crate::prelude::VolumeExt::identifier()] to obtain an identifier for a volume.
    ///
    ///
    /// Note that [`VOLUME_IDENTIFIER_KIND_HAL_UDI`][crate::VOLUME_IDENTIFIER_KIND_HAL_UDI] will only be available
    /// when the gvfs hal volume monitor is in use. Other volume monitors
    /// will generally be able to provide the [`VOLUME_IDENTIFIER_KIND_UNIX_DEVICE`][crate::VOLUME_IDENTIFIER_KIND_UNIX_DEVICE]
    /// identifier, which can be used to obtain a hal device by means of
    /// `libhal_manager_find_device_string_match()`.
    ///
    /// ## Signals
    ///
    ///
    /// #### `changed`
    ///  Emitted when the volume has been changed.
    ///
    ///
    ///
    ///
    /// #### `removed`
    ///  This signal is emitted when the [`Volume`][crate::Volume] have been removed. If
    /// the recipient is holding references to the object they should
    /// release them so the object can be finalized.
    ///
    ///
    ///
    /// # Implements
    ///
    /// [`VolumeExt`][trait@crate::prelude::VolumeExt]
    #[doc(alias = "GVolume")]
    pub struct Volume(Interface<ffi::GVolume, ffi::GVolumeIface>);

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

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

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

/// Trait containing all [`struct@Volume`] methods.
///
/// # Implementors
///
/// [`Volume`][struct@crate::Volume]
pub trait VolumeExt: IsA<Volume> + sealed::Sealed + 'static {
    /// Checks if a volume can be ejected.
    ///
    /// # Returns
    ///
    /// [`true`] if the `self` can be ejected. [`false`] otherwise
    #[doc(alias = "g_volume_can_eject")]
    fn can_eject(&self) -> bool {
        unsafe { from_glib(ffi::g_volume_can_eject(self.as_ref().to_glib_none().0)) }
    }

    /// Checks if a volume can be mounted.
    ///
    /// # Returns
    ///
    /// [`true`] if the `self` can be mounted. [`false`] otherwise
    #[doc(alias = "g_volume_can_mount")]
    fn can_mount(&self) -> bool {
        unsafe { from_glib(ffi::g_volume_can_mount(self.as_ref().to_glib_none().0)) }
    }

    /// Ejects a volume. This is an asynchronous operation, and is
    /// finished by calling `g_volume_eject_with_operation_finish()` with the `self`
    /// and [`AsyncResult`][crate::AsyncResult] data returned in the `callback`.
    /// ## `flags`
    /// flags affecting the unmount if required for eject
    /// ## `mount_operation`
    /// a [`MountOperation`][crate::MountOperation] or [`None`] to
    ///  avoid user interaction
    /// ## `cancellable`
    /// optional [`Cancellable`][crate::Cancellable] object, [`None`] to ignore
    /// ## `callback`
    /// a `GAsyncReadyCallback`, or [`None`]
    #[doc(alias = "g_volume_eject_with_operation")]
    fn eject_with_operation<P: FnOnce(Result<(), glib::Error>) + 'static>(
        &self,
        flags: MountUnmountFlags,
        mount_operation: Option<&impl IsA<MountOperation>>,
        cancellable: Option<&impl IsA<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 eject_with_operation_trampoline<
            P: FnOnce(Result<(), glib::Error>) + 'static,
        >(
            _source_object: *mut glib::gobject_ffi::GObject,
            res: *mut crate::ffi::GAsyncResult,
            user_data: glib::ffi::gpointer,
        ) {
            let mut error = ptr::null_mut();
            let _ = ffi::g_volume_eject_with_operation_finish(
                _source_object as *mut _,
                res,
                &mut error,
            );
            let result = if error.is_null() {
                Ok(())
            } 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 = eject_with_operation_trampoline::<P>;
        unsafe {
            ffi::g_volume_eject_with_operation(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                mount_operation.map(|p| p.as_ref()).to_glib_none().0,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                Some(callback),
                Box_::into_raw(user_data) as *mut _,
            );
        }
    }

    fn eject_with_operation_future(
        &self,
        flags: MountUnmountFlags,
        mount_operation: Option<&(impl IsA<MountOperation> + Clone + 'static)>,
    ) -> Pin<Box_<dyn std::future::Future<Output = Result<(), glib::Error>> + 'static>> {
        let mount_operation = mount_operation.map(ToOwned::to_owned);
        Box_::pin(crate::GioFuture::new(
            self,
            move |obj, cancellable, send| {
                obj.eject_with_operation(
                    flags,
                    mount_operation.as_ref().map(::std::borrow::Borrow::borrow),
                    Some(cancellable),
                    move |res| {
                        send.resolve(res);
                    },
                );
            },
        ))
    }

    /// Gets the kinds of [identifiers][volume-identifier] that `self` has.
    /// Use [`identifier()`][Self::identifier()] to obtain the identifiers themselves.
    ///
    /// # Returns
    ///
    /// a [`None`]-terminated array
    ///  of strings containing kinds of identifiers. Use `g_strfreev()` to free.
    #[doc(alias = "g_volume_enumerate_identifiers")]
    fn enumerate_identifiers(&self) -> Vec<glib::GString> {
        unsafe {
            FromGlibPtrContainer::from_glib_full(ffi::g_volume_enumerate_identifiers(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the activation root for a [`Volume`][crate::Volume] if it is known ahead of
    /// mount time. Returns [`None`] otherwise. If not [`None`] and if `self`
    /// is mounted, then the result of [`MountExt::root()`][crate::prelude::MountExt::root()] on the
    /// [`Mount`][crate::Mount] object obtained from [`get_mount()`][Self::get_mount()] will always
    /// either be equal or a prefix of what this function returns. In
    /// other words, in code
    ///
    ///
    ///
    /// **⚠️ The following code is in C ⚠️**
    ///
    /// ```C
    ///   GMount *mount;
    ///   GFile *mount_root
    ///   GFile *volume_activation_root;
    ///
    ///   mount = g_volume_get_mount (volume); // mounted, so never NULL
    ///   mount_root = g_mount_get_root (mount);
    ///   volume_activation_root = g_volume_get_activation_root (volume); // assume not NULL
    /// ```
    /// then the expression
    ///
    ///
    /// **⚠️ The following code is in C ⚠️**
    ///
    /// ```C
    ///   (g_file_has_prefix (volume_activation_root, mount_root) ||
    ///    g_file_equal (volume_activation_root, mount_root))
    /// ```
    /// will always be [`true`].
    ///
    /// Activation roots are typically used in [`VolumeMonitor`][crate::VolumeMonitor]
    /// implementations to find the underlying mount to shadow, see
    /// [`MountExt::is_shadowed()`][crate::prelude::MountExt::is_shadowed()] for more details.
    ///
    /// # Returns
    ///
    /// the activation root of `self`
    ///  or [`None`]. Use `g_object_unref()` to free.
    #[doc(alias = "g_volume_get_activation_root")]
    #[doc(alias = "get_activation_root")]
    fn activation_root(&self) -> Option<File> {
        unsafe {
            from_glib_full(ffi::g_volume_get_activation_root(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the drive for the `self`.
    ///
    /// # Returns
    ///
    /// a [`Drive`][crate::Drive] or [`None`] if `self` is not
    ///  associated with a drive. The returned object should be unreffed
    ///  with `g_object_unref()` when no longer needed.
    #[doc(alias = "g_volume_get_drive")]
    #[doc(alias = "get_drive")]
    fn drive(&self) -> Option<Drive> {
        unsafe { from_glib_full(ffi::g_volume_get_drive(self.as_ref().to_glib_none().0)) }
    }

    /// Gets the icon for `self`.
    ///
    /// # Returns
    ///
    /// a [`Icon`][crate::Icon].
    ///  The returned object should be unreffed with `g_object_unref()`
    ///  when no longer needed.
    #[doc(alias = "g_volume_get_icon")]
    #[doc(alias = "get_icon")]
    fn icon(&self) -> Icon {
        unsafe { from_glib_full(ffi::g_volume_get_icon(self.as_ref().to_glib_none().0)) }
    }

    /// Gets the identifier of the given kind for `self`.
    /// See the [introduction][volume-identifier] for more
    /// information about volume identifiers.
    /// ## `kind`
    /// the kind of identifier to return
    ///
    /// # Returns
    ///
    /// a newly allocated string containing the
    ///  requested identifier, or [`None`] if the [`Volume`][crate::Volume]
    ///  doesn't have this kind of identifier
    #[doc(alias = "g_volume_get_identifier")]
    #[doc(alias = "get_identifier")]
    fn identifier(&self, kind: &str) -> Option<glib::GString> {
        unsafe {
            from_glib_full(ffi::g_volume_get_identifier(
                self.as_ref().to_glib_none().0,
                kind.to_glib_none().0,
            ))
        }
    }

    /// Gets the mount for the `self`.
    ///
    /// # Returns
    ///
    /// a [`Mount`][crate::Mount] or [`None`] if `self` isn't mounted.
    ///  The returned object should be unreffed with `g_object_unref()`
    ///  when no longer needed.
    #[doc(alias = "g_volume_get_mount")]
    fn get_mount(&self) -> Option<Mount> {
        unsafe { from_glib_full(ffi::g_volume_get_mount(self.as_ref().to_glib_none().0)) }
    }

    /// Gets the name of `self`.
    ///
    /// # Returns
    ///
    /// the name for the given `self`. The returned string should
    ///  be freed with `g_free()` when no longer needed.
    #[doc(alias = "g_volume_get_name")]
    #[doc(alias = "get_name")]
    fn name(&self) -> glib::GString {
        unsafe { from_glib_full(ffi::g_volume_get_name(self.as_ref().to_glib_none().0)) }
    }

    /// Gets the sort key for `self`, if any.
    ///
    /// # Returns
    ///
    /// Sorting key for `self` or [`None`] if no such key is available
    #[doc(alias = "g_volume_get_sort_key")]
    #[doc(alias = "get_sort_key")]
    fn sort_key(&self) -> Option<glib::GString> {
        unsafe { from_glib_none(ffi::g_volume_get_sort_key(self.as_ref().to_glib_none().0)) }
    }

    /// Gets the symbolic icon for `self`.
    ///
    /// # Returns
    ///
    /// a [`Icon`][crate::Icon].
    ///  The returned object should be unreffed with `g_object_unref()`
    ///  when no longer needed.
    #[doc(alias = "g_volume_get_symbolic_icon")]
    #[doc(alias = "get_symbolic_icon")]
    fn symbolic_icon(&self) -> Icon {
        unsafe {
            from_glib_full(ffi::g_volume_get_symbolic_icon(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the UUID for the `self`. The reference is typically based on
    /// the file system UUID for the volume in question and should be
    /// considered an opaque string. Returns [`None`] if there is no UUID
    /// available.
    ///
    /// # Returns
    ///
    /// the UUID for `self` or [`None`] if no UUID
    ///  can be computed.
    ///  The returned string should be freed with `g_free()`
    ///  when no longer needed.
    #[doc(alias = "g_volume_get_uuid")]
    #[doc(alias = "get_uuid")]
    fn uuid(&self) -> Option<glib::GString> {
        unsafe { from_glib_full(ffi::g_volume_get_uuid(self.as_ref().to_glib_none().0)) }
    }

    /// Mounts a volume. This is an asynchronous operation, and is
    /// finished by calling `g_volume_mount_finish()` with the `self`
    /// and [`AsyncResult`][crate::AsyncResult] returned in the `callback`.
    /// ## `flags`
    /// flags affecting the operation
    /// ## `mount_operation`
    /// a [`MountOperation`][crate::MountOperation] or [`None`] to avoid user interaction
    /// ## `cancellable`
    /// optional [`Cancellable`][crate::Cancellable] object, [`None`] to ignore
    /// ## `callback`
    /// a `GAsyncReadyCallback`, or [`None`]
    #[doc(alias = "g_volume_mount")]
    fn mount<P: FnOnce(Result<(), glib::Error>) + 'static>(
        &self,
        flags: MountMountFlags,
        mount_operation: Option<&impl IsA<MountOperation>>,
        cancellable: Option<&impl IsA<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 mount_trampoline<P: FnOnce(Result<(), glib::Error>) + 'static>(
            _source_object: *mut glib::gobject_ffi::GObject,
            res: *mut crate::ffi::GAsyncResult,
            user_data: glib::ffi::gpointer,
        ) {
            let mut error = ptr::null_mut();
            let _ = ffi::g_volume_mount_finish(_source_object as *mut _, res, &mut error);
            let result = if error.is_null() {
                Ok(())
            } 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 = mount_trampoline::<P>;
        unsafe {
            ffi::g_volume_mount(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
                mount_operation.map(|p| p.as_ref()).to_glib_none().0,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                Some(callback),
                Box_::into_raw(user_data) as *mut _,
            );
        }
    }

    fn mount_future(
        &self,
        flags: MountMountFlags,
        mount_operation: Option<&(impl IsA<MountOperation> + Clone + 'static)>,
    ) -> Pin<Box_<dyn std::future::Future<Output = Result<(), glib::Error>> + 'static>> {
        let mount_operation = mount_operation.map(ToOwned::to_owned);
        Box_::pin(crate::GioFuture::new(
            self,
            move |obj, cancellable, send| {
                obj.mount(
                    flags,
                    mount_operation.as_ref().map(::std::borrow::Borrow::borrow),
                    Some(cancellable),
                    move |res| {
                        send.resolve(res);
                    },
                );
            },
        ))
    }

    /// Returns whether the volume should be automatically mounted.
    ///
    /// # Returns
    ///
    /// [`true`] if the volume should be automatically mounted
    #[doc(alias = "g_volume_should_automount")]
    fn should_automount(&self) -> bool {
        unsafe {
            from_glib(ffi::g_volume_should_automount(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Emitted when the volume has been changed.
    #[doc(alias = "changed")]
    fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn changed_trampoline<P: IsA<Volume>, F: Fn(&P) + 'static>(
            this: *mut ffi::GVolume,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Volume::from_glib_borrow(this).unsafe_cast_ref())
        }
        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::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// This signal is emitted when the [`Volume`][crate::Volume] have been removed. If
    /// the recipient is holding references to the object they should
    /// release them so the object can be finalized.
    #[doc(alias = "removed")]
    fn connect_removed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn removed_trampoline<P: IsA<Volume>, F: Fn(&P) + 'static>(
            this: *mut ffi::GVolume,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Volume::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"removed\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    removed_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<Volume>> VolumeExt for O {}

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