// 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 gio_sys;
use glib;
use glib::object::Cast;
use glib::object::IsA;
use glib::signal::connect_raw;
use glib::signal::SignalHandlerId;
use glib::translate::*;
use glib_sys;
use gobject_sys;
use std::boxed::Box as Box_;
use std::fmt;
use std::mem::transmute;
use std::pin::Pin;
use std::ptr;
use Cancellable;
#[cfg(any(feature = "v2_44", feature = "dox"))]
use NetworkConnectivity;
use SocketConnectable;

glib_wrapper! {
    /// `NetworkMonitor` provides an easy-to-use cross-platform API
    /// for monitoring network connectivity. On Linux, the available
    /// implementations are based on the kernel's netlink interface and
    /// on NetworkManager.
    ///
    /// There is also an implementation for use inside Flatpak sandboxes.
    ///
    /// # Implements
    ///
    /// [`NetworkMonitorExt`](trait.NetworkMonitorExt.html)
    pub struct NetworkMonitor(Interface<gio_sys::GNetworkMonitor>);

    match fn {
        get_type => || gio_sys::g_network_monitor_get_type(),
    }
}

impl NetworkMonitor {
    /// Gets the default `NetworkMonitor` for the system.
    ///
    /// # Returns
    ///
    /// a `NetworkMonitor`
    pub fn get_default() -> Option<NetworkMonitor> {
        unsafe { from_glib_none(gio_sys::g_network_monitor_get_default()) }
    }
}

pub const NONE_NETWORK_MONITOR: Option<&NetworkMonitor> = None;

/// Trait containing all `NetworkMonitor` methods.
///
/// # Implementors
///
/// [`NetworkMonitor`](struct.NetworkMonitor.html)
pub trait NetworkMonitorExt: 'static {
    /// Attempts to determine whether or not the host pointed to by
    /// `connectable` can be reached, without actually trying to connect to
    /// it.
    ///
    /// This may return `true` even when `NetworkMonitor:network-available`
    /// is `false`, if, for example, `self` can determine that
    /// `connectable` refers to a host on a local network.
    ///
    /// If `self` believes that an attempt to connect to `connectable`
    /// will succeed, it will return `true`. Otherwise, it will return
    /// `false` and set `error` to an appropriate error (such as
    /// `IOErrorEnum::HostUnreachable`).
    ///
    /// Note that although this does not attempt to connect to
    /// `connectable`, it may still block for a brief period of time (eg,
    /// trying to do multicast DNS on the local network), so if you do not
    /// want to block, you should use `NetworkMonitor::can_reach_async`.
    /// ## `connectable`
    /// a `SocketConnectable`
    /// ## `cancellable`
    /// a `Cancellable`, or `None`
    ///
    /// # Returns
    ///
    /// `true` if `connectable` is reachable, `false` if not.
    fn can_reach<P: IsA<SocketConnectable>, Q: IsA<Cancellable>>(
        &self,
        connectable: &P,
        cancellable: Option<&Q>,
    ) -> Result<(), glib::Error>;

    /// Asynchronously attempts to determine whether or not the host
    /// pointed to by `connectable` can be reached, without actually
    /// trying to connect to it.
    ///
    /// For more details, see `NetworkMonitor::can_reach`.
    ///
    /// When the operation is finished, `callback` will be called.
    /// You can then call `NetworkMonitor::can_reach_finish`
    /// to get the result of the operation.
    /// ## `connectable`
    /// a `SocketConnectable`
    /// ## `cancellable`
    /// a `Cancellable`, or `None`
    /// ## `callback`
    /// a `GAsyncReadyCallback` to call when the
    ///  request is satisfied
    /// ## `user_data`
    /// the data to pass to callback function
    fn can_reach_async<
        P: IsA<SocketConnectable>,
        Q: IsA<Cancellable>,
        R: FnOnce(Result<(), glib::Error>) + Send + 'static,
    >(
        &self,
        connectable: &P,
        cancellable: Option<&Q>,
        callback: R,
    );

    fn can_reach_async_future<P: IsA<SocketConnectable> + Clone + 'static>(
        &self,
        connectable: &P,
    ) -> Pin<Box_<dyn std::future::Future<Output = Result<(), glib::Error>> + 'static>>;

    /// Gets a more detailed networking state than
    /// `NetworkMonitor::get_network_available`.
    ///
    /// If `NetworkMonitor:network-available` is `false`, then the
    /// connectivity state will be `NetworkConnectivity::Local`.
    ///
    /// If `NetworkMonitor:network-available` is `true`, then the
    /// connectivity state will be `NetworkConnectivity::Full` (if there
    /// is full Internet connectivity), `NetworkConnectivity::Limited` (if
    /// the host has a default route, but appears to be unable to actually
    /// reach the full Internet), or `NetworkConnectivity::Portal` (if the
    /// host is trapped behind a "captive portal" that requires some sort
    /// of login or acknowledgement before allowing full Internet access).
    ///
    /// Note that in the case of `NetworkConnectivity::Limited` and
    /// `NetworkConnectivity::Portal`, it is possible that some sites are
    /// reachable but others are not. In this case, applications can
    /// attempt to connect to remote servers, but should gracefully fall
    /// back to their "offline" behavior if the connection attempt fails.
    ///
    /// Feature: `v2_44`
    ///
    ///
    /// # Returns
    ///
    /// the network connectivity state
    #[cfg(any(feature = "v2_44", feature = "dox"))]
    fn get_connectivity(&self) -> NetworkConnectivity;

    /// Checks if the network is available. "Available" here means that the
    /// system has a default route available for at least one of IPv4 or
    /// IPv6. It does not necessarily imply that the public Internet is
    /// reachable. See `NetworkMonitor:network-available` for more details.
    ///
    /// # Returns
    ///
    /// whether the network is available
    fn get_network_available(&self) -> bool;

    /// Checks if the network is metered.
    /// See `NetworkMonitor:network-metered` for more details.
    ///
    /// Feature: `v2_46`
    ///
    ///
    /// # Returns
    ///
    /// whether the connection is metered
    #[cfg(any(feature = "v2_46", feature = "dox"))]
    fn get_network_metered(&self) -> bool;

    /// Emitted when the network configuration changes.
    /// ## `network_available`
    /// the current value of `NetworkMonitor:network-available`
    fn connect_network_changed<F: Fn(&Self, bool) + 'static>(&self, f: F) -> SignalHandlerId;

    #[cfg(any(feature = "v2_44", feature = "dox"))]
    fn connect_property_connectivity_notify<F: Fn(&Self) + 'static>(&self, f: F)
        -> SignalHandlerId;

    fn connect_property_network_available_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId;

    #[cfg(any(feature = "v2_46", feature = "dox"))]
    fn connect_property_network_metered_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId;
}

impl<O: IsA<NetworkMonitor>> NetworkMonitorExt for O {
    fn can_reach<P: IsA<SocketConnectable>, Q: IsA<Cancellable>>(
        &self,
        connectable: &P,
        cancellable: Option<&Q>,
    ) -> Result<(), glib::Error> {
        unsafe {
            let mut error = ptr::null_mut();
            let _ = gio_sys::g_network_monitor_can_reach(
                self.as_ref().to_glib_none().0,
                connectable.as_ref().to_glib_none().0,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                &mut error,
            );
            if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    fn can_reach_async<
        P: IsA<SocketConnectable>,
        Q: IsA<Cancellable>,
        R: FnOnce(Result<(), glib::Error>) + Send + 'static,
    >(
        &self,
        connectable: &P,
        cancellable: Option<&Q>,
        callback: R,
    ) {
        let user_data: Box_<R> = Box_::new(callback);
        unsafe extern "C" fn can_reach_async_trampoline<
            R: FnOnce(Result<(), glib::Error>) + Send + 'static,
        >(
            _source_object: *mut gobject_sys::GObject,
            res: *mut gio_sys::GAsyncResult,
            user_data: glib_sys::gpointer,
        ) {
            let mut error = ptr::null_mut();
            let _ = gio_sys::g_network_monitor_can_reach_finish(
                _source_object as *mut _,
                res,
                &mut error,
            );
            let result = if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            };
            let callback: Box_<R> = Box_::from_raw(user_data as *mut _);
            callback(result);
        }
        let callback = can_reach_async_trampoline::<R>;
        unsafe {
            gio_sys::g_network_monitor_can_reach_async(
                self.as_ref().to_glib_none().0,
                connectable.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 can_reach_async_future<P: IsA<SocketConnectable> + Clone + 'static>(
        &self,
        connectable: &P,
    ) -> Pin<Box_<dyn std::future::Future<Output = Result<(), glib::Error>> + 'static>> {
        let connectable = connectable.clone();
        Box_::pin(crate::GioFuture::new(self, move |obj, send| {
            let cancellable = Cancellable::new();
            obj.can_reach_async(&connectable, Some(&cancellable), move |res| {
                send.resolve(res);
            });

            cancellable
        }))
    }

    #[cfg(any(feature = "v2_44", feature = "dox"))]
    fn get_connectivity(&self) -> NetworkConnectivity {
        unsafe {
            from_glib(gio_sys::g_network_monitor_get_connectivity(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn get_network_available(&self) -> bool {
        unsafe {
            from_glib(gio_sys::g_network_monitor_get_network_available(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    #[cfg(any(feature = "v2_46", feature = "dox"))]
    fn get_network_metered(&self) -> bool {
        unsafe {
            from_glib(gio_sys::g_network_monitor_get_network_metered(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn connect_network_changed<F: Fn(&Self, bool) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn network_changed_trampoline<P, F: Fn(&P, bool) + 'static>(
            this: *mut gio_sys::GNetworkMonitor,
            network_available: glib_sys::gboolean,
            f: glib_sys::gpointer,
        ) where
            P: IsA<NetworkMonitor>,
        {
            let f: &F = &*(f as *const F);
            f(
                &NetworkMonitor::from_glib_borrow(this).unsafe_cast(),
                from_glib(network_available),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"network-changed\0".as_ptr() as *const _,
                Some(transmute(network_changed_trampoline::<Self, F> as usize)),
                Box_::into_raw(f),
            )
        }
    }

    #[cfg(any(feature = "v2_44", feature = "dox"))]
    fn connect_property_connectivity_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_connectivity_trampoline<P, F: Fn(&P) + 'static>(
            this: *mut gio_sys::GNetworkMonitor,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) where
            P: IsA<NetworkMonitor>,
        {
            let f: &F = &*(f as *const F);
            f(&NetworkMonitor::from_glib_borrow(this).unsafe_cast())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::connectivity\0".as_ptr() as *const _,
                Some(transmute(
                    notify_connectivity_trampoline::<Self, F> as usize,
                )),
                Box_::into_raw(f),
            )
        }
    }

    fn connect_property_network_available_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_network_available_trampoline<P, F: Fn(&P) + 'static>(
            this: *mut gio_sys::GNetworkMonitor,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) where
            P: IsA<NetworkMonitor>,
        {
            let f: &F = &*(f as *const F);
            f(&NetworkMonitor::from_glib_borrow(this).unsafe_cast())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::network-available\0".as_ptr() as *const _,
                Some(transmute(
                    notify_network_available_trampoline::<Self, F> as usize,
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[cfg(any(feature = "v2_46", feature = "dox"))]
    fn connect_property_network_metered_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_network_metered_trampoline<P, F: Fn(&P) + 'static>(
            this: *mut gio_sys::GNetworkMonitor,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) where
            P: IsA<NetworkMonitor>,
        {
            let f: &F = &*(f as *const F);
            f(&NetworkMonitor::from_glib_borrow(this).unsafe_cast())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::network-metered\0".as_ptr() as *const _,
                Some(transmute(
                    notify_network_metered_trampoline::<Self, F> as usize,
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl fmt::Display for NetworkMonitor {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "NetworkMonitor")
    }
}